コースごとに内部データベース ID があります。バッチ機能を使用してコースを作成する場合、返された情報ではこの ID を取得する方法が得られないため、データベースを更新してコースが作成されたことを知らせることができません。
同じ理由で削除応答を更新することも便利です。
削除のバッチに対する応答は次のようになります。
--batch_123456
{}
--batch_123456
--batch_123456
{}
--batch_123456
--batch_123456
{}
--batch_123456
それらがすべて成功した場合、それは実際には問題ではありませんが、何か問題が発生した場合、API によると、どれが削除され、どれが削除されていないかを判断することは不可能です。
「サーバーは任意の順序で呼び出しを実行できます。指定した順序で実行されるとは考えないでください。」
「コース #123 は削除されました」という簡単なメッセージは非常に役に立ちます。そうすれば、コールバック コードをプログラムして、ID を使用してデータベースを更新できます。
コース作成の場合、応答は次のようになります。
--batch_123456
{
"id": "208571459",
"name": "***",
"section": "***",
"ownerId": "123456",
"creationTime": "2015-09-14T13:13:59.622Z",
"updateTime": "2015-09-14T13:14:02.820Z",
"enrollmentCode": "***",
"courseState": "PROVISIONED",
"alternateLink": "***"
}
--batch_123456
スペースを節約するために、1 つの応答のみを入力しました。ID はコースの新しい GoogleID です。DB のレコードに対応する実際に送信される ID は返されません。そのため、他のデータ (所有者 ID + 名前) の組み合わせを使用してレコードを取得して更新する必要がありますが、これは理想的ではなく、すべての人にとってうまくいくとは限りません。get が送信したすべての情報を応答に追加すると、コールバックを適切に使用できるようになるため、非常に役立ちます。
また、より有用な特定の情報もすべてのエラー メッセージに追加する必要があります。実際、すべてのバッチ応答には何らかの ID が必要です。そうすれば、コールバック関数がより便利になります。