名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
個人 (またはグループ) が 課題 のために提出するリソースと、 その提出に関連する成果 (成績やフィードバックなど) を表します。
提出物は 課題によって所有されます。 課題が発行されると、提出物は自動的に作成されます。 提出は、リソースの 2 つのリストを所有します。 リソースはユーザー/グループの作業領域を表し、送信されたリソースは学生によって積極的に提出されたリソースを表します。
status プロパティは読み取り専用で、オブジェクトは actions を介してワークフロー内で移動されます。
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 | リソースを submitted から作業状態に移動したユーザー。 |
| unsubmittedDateTime | DateTimeOffset | 送信が送信済みから作業状態に移行された瞬間。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| webUrl | String | 特定の送信のディープ リンク URL。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| outcomes | 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"
}