コンテキストと同意
このページは英語から翻訳されています。内容に相違がある場合は、英語のページが正しい内容です。 英語のページを読む
アプリが学習者について知ることができるのは、コンテキストスライスを通じてだけです。各スライスは、固定のフィールドを持つ小さなレコードです。マニフェストには求めるスライスを列挙し、学習者はアプリのインストール時にそれぞれに同意します。Lingara がスライスを送るのは、その両方が引き続き成り立っている間だけです。
スライス
| スライス | フィールド | 内容 |
|---|---|---|
languages | source_lang | 学習者が学習の起点にしている言語。en のような言語タグで表します。 |
target_lang | 学習者が学んでいる言語。 | |
level | その言語でのレベル。1 から 9 まで。学習者が設定している場合のみ。 | |
plan_summary | plan_id | 学習者の最新のレッスンプランの ID。プランどうしを見分けるためのものです。アプリはこれを使ってプランを取得することはできません。アプリのトークンが読み取るのはあなた自身のアカウントで、学習者のアカウントではないからです。 |
title | 生成されたプランのタイトル。最大 120 文字。タイトルがある場合のみ。 | |
target_lang | プランが教える言語。 | |
set_count | プランに含まれるセットの数。最大 200。 | |
sets_completed | そのうち学習者が完了したセットの数。 | |
review_due | due | 現在復習待ちのフラッシュカードの枚数。最大 100000。 |
learned | 学習者が覚えた単語の数。最大 100000。 | |
tutor_topic | topic | 学習者の最新のチューターチャットのトピック。1 から 120 文字。プランのタイトルや学習者がいる画面から取られ、学習者自身の言葉から取られることはありません。 |
どのスライスにも含まれないもの
どのスライスにも、メールアドレス、名前、ユーザー ID、学習者が入力したものは含まれません。アプリは、リクエストの subject から学習者が誰かを知ります。これは安定した値で、アプリごとに異なります。アプリのトークンが読み取るのはあなた自身のアカウントで、学習者のアカウントを読み取ることはありません。そのため、アプリが学習者について知っていることはスライスがすべてです。
同意
- 学習者は、アプリのインストール時に各スライスに同意します。同意した内容を変更するには、アプリをアンインストールしてから再度インストールします。
- マニフェストを編集して求めるスライスを減らすと、外したスライスはただちに送られなくなります。
- マニフェストを編集して求めるスライスを増やしても、新しいスライスは、学習者が再インストールするまでどの学習者にも届きません。
- Lingara はリクエストのたびに同意を改めて確認し、学習者が同意していないスライスや、マニフェストがもう求めていないスライスを破棄します。レコードに合わないスライスも破棄されますが、リクエスト全体が破棄されることはありません。
下のサンプルは、渡されたスライスから表示する 1 行を組み立て、API は一切呼び出しません。