名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
個々の (またはグループ) が 課題 に対して有効にするリソースと、 提出に関連付けられている結果 (成績やフィードバックなど) を表します。
申請は 割り当てによって所有されます。 課題が発行されると、申請が自動的に作成されます。 申請は、リソースの 2 つのリストを所有します。 リソースはユーザー/グループの作業領域を表し、提出されたリソースは学生によってアクティブに有効になっているリソースを表します。
status プロパティは読み取り専用であり、オブジェクトはアクションを介してワークフロー内で移動されます。
educationSubmission リソースで setUpResourcesFolder が呼び出されていない場合、resourcesFolderUrl プロパティはnull。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 申請を取得する | educationSubmission | educationSubmission オブジェクトのプロパティとリレーションシップを読み取ります。 |
| 申請リソースを一覧表示する | educationSubmissionResource コレクション | educationSubmissionResource オブジェクト コレクションを取得します。 |
| 申請したリソースを一覧表示する | educationSubmissionResource コレクション | educationSubmissionResource オブジェクト コレクションを取得します。 |
| 結果を一覧表示する | educationOutcome コレクション | educationOutcome オブジェクト コレクションを取得します。 |
| 言い訳の提出 | educationSubmission | 提出に学生に対するそれ以上のアクションがなく、平均成績の計算には含まれていないことを示します。 |
| 申請を戻す | educationSubmission | 教師は return を使用して、成績やフィードバックを学生に表示できることを示します。 |
| 申請を再割り当てする | educationSubmission | レビューのためのフィードバックを持つ学生に提出を再割り当てします。 |
| 申請リソース フォルダーを設定する | educationSubmission | ファイルを送信リソースとしてアップロードする SharePoint フォルダー (定義済みの場所の下) を作成します。 |
| 申請を提出する | educationSubmission | 学生が送信を使用して 課題を有効にします。 この操作は、リソースを submittedResources フォルダーにコピーして採点し、状態を更新します。 |
| 申請の提出を取り消す | educationSubmission | 学生が未提出を使用して、提出の状態を送信済みから作業状態に戻します。 この操作は、リソースを workingResources フォルダーにコピーして採点し、状態を更新します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| assignmentId | 文字列 | この申請が関連付けられている割り当ての一意識別子。 申請は常に 1 つの割り当てにのみ関連付けられます。 |
| excusedBy | identitySet | 申請を言い訳としてマークしたユーザー。 |
| excusedDateTime | DateTimeOffset | 申請が言い訳された状態に移動された瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| id | 文字列 | 申請の一意識別子。 |
| lastModifiedBy | identitySet | 申請を変更したユーザーの ID。 |
| lastModifiedDateTime | DateTimeOffset | 申請が変更された日時。 |
| reassignedBy | identitySet | この申請の状態を再割り当て済みに移動したユーザー。 |
| reassignedDateTime | DateTimeOffset | 申請が再割り当てされた瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| 受信者 | educationSubmissionRecipient | この申請が割り当てられているユーザー。 |
| resourcesFolderUrl | 文字列 | この申請のすべてのファイル リソースを格納する必要があるフォルダー。 |
| returnedBy | identitySet | この申請の状態を戻された状態に移動したユーザー。 |
| returnedDateTime | DateTimeOffset | 申請が返された瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| status | educationSubmissionStatus | 読み取り専用です。 使用可能な値: working、submitted、returned、unknownFutureValue、reassigned、excused。
Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得します:reassignedとexcused。 |
| submittedBy | identitySet | リソースを送信済み状態に移動したユーザー。 |
| submittedDateTime | DateTimeOffset | 送信が送信された状態に移動した瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| unsubmittedBy | identitySet | リソースを送信から稼働状態に移動したユーザー。 |
| unsubmittedDateTime | DateTimeOffset | 送信が送信から作業状態に移動された瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| webUrl | String | 指定された申請のディープ リンク URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| 結果 | educationOutcome コレクション。 教師がこの提出物に割り当てる成績、フィードバック、ルーブリック情報を保持します | 読み取り/書き込み。 Null 許容型。 |
| リソース | educationSubmissionResource コレクション | Null 許容型。 |
| submittedResources | educationSubmissionResource コレクション | 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"assignmentId": "String",
"excusedBy": {"@odata.type":"microsoft.graph.identitySet"},
"excusedDateTime": "String (timestamp)",
"id": "String (identifier)",
"reassignedBy": {"@odata.type":"microsoft.graph.identitySet"},
"reassignedDateTime": "String (timestamp)",
"recipient": {"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
"resourcesFolderUrl": "String",
"returnedBy": {"@odata.type":"microsoft.graph.identitySet"},
"returnedDateTime": "String (timestamp)",
"status": "String",
"submittedBy": {"@odata.type":"microsoft.graph.identitySet"},
"submittedDateTime": "String (timestamp)",
"unsubmittedBy": {"@odata.type":"microsoft.graph.identitySet"},
"unsubmittedDateTime": "String (timestamp)",
"webUrl": "String"
}