Learn365 API 「Quizzes」セクションでは、テナント上のクイズに関するデータを取得し、ダウンロードすることができます。

取得されたデータは.JSONフォーマットで記載されており、それについては、 API documentation ページ「Quiz Questions」セクションとこちらで説明しています。

ここでは、Learn365 API Quizzes セクションでGETリクエストが実行された際、レスポンスに表示される「Questions 」文字列の読み方を説明します。

「Questions」文字列の説明

Response body の「Questions」文字列にはクイズの問題に関する基本的な情報と固有の情報の両方が含まれます。

基本的な情報

• question type：問題のタイプは数値で識別します。この数値の定義は API documentation ページの Quiz Questions > QuestionType セクションに記載されています。

• ID：各問題のIDを表示します。このプロパティは通常、次の下図に示すように、QuestionType または RandomizeAnswers プロパティの後に続きます。

• Title：問題のタイトルを表示します。このプロパティはIDの後に続きます。

• Description：問題の問題文を表示します。

• RandomizeAnswers ：TrueまたはFalseを表示します。このプロパティは問題の答えの選択肢のランダマイズ オプションの設定に関連しており、それぞれ On または Off に設定することができます。

• Points：この問題に正解した場合に受講者が受け取るポイント数（=問題の「獲得ポイント」フィールドに入力されている値）が表示されます。ポイント数が指定されていない場合は、0 と表示されます。

• PointsPercentage：「ShortAnswer（記述問題）」の答えに設定した、正解率が表示されます。

• PositiveFeedback・NegativeFeedback・SemiPositiveFeedback： 正解、不正解、および一部正解に対するフィードバックのテキストが表示されます。フィードバックテキストが入力されていない場合は、":null" が表示されます。

• Tags：問題に設定されているタグを表示します。

答えとそのID

問題のタイプに応じて、答えと正解 IDとともに表示されます。

• 自由記述：このタイプには答えがありません。
  
  
• 正誤：「RightAnswer」プロパティにTrueまたはFalseとして表示されます。正解 IDは含まれません。

• 単一選択：「Answers」プロパティに各答えの選択肢のIDとテキストが表示されます。「RightAnswerId」にはこの問題の正解 ID が表示されます。

• 複数選択：「Answers」プロパティに各答えの選択肢のIDとテキストが表示されます。「RightAnswerIds」には正解 ID が表示されます。

• 並び替え問題：「Answers」プロパティに答えの選択肢のIDとテキストが正しい順序で表示されます。

• 領域選択：「ImageUrl」プロパティに、画像のURLと、正解の箇所を示す画像上の位置（XとY）が表示されます。

• 記述問題：「Answers」プロパティに各答えの選択肢のIDとテキストが表示されます。それに続いて使用可能なすべての答えの「IsRegExp」プロパティを表示します。

• 穴埋め問題：「Text」プロパティに答えのテキストが表示されます。穴埋めの箇所は[_gap番号]で示されます。それに続いて「Gaps」プロパティには各穴埋めの選択肢が表示されます。

続いて、「CorrectResponse」プロパティに各穴埋めの正解が表示されます。

• 組み合わせ問題：「Answers」プロパティに答えの選択肢のIDとテキストが正しい組み合わせで表示されます。各組み合わせのペアは角括弧で括られ、カンマで区切られています。