upsert places API を使用すると、1 つの非同期操作で複数の場所を効率的に作成および更新できます。
サポートされるシナリオ
upsert places API を使用する場合は、次のシナリオがサポートされます。
- 複数の独立した場所を作成します。
- 既存の場所の下に新しい子の場所を含む、階層を持つ場所を作成します。
- 複数の独立した場所を更新します。
- 新しい場所の下に既存の場所を移動するなど、場所の階層を更新します。
要求ペイロードについて
場所に対して一括作成または更新操作を実行する場合は、次の考慮事項が適用されます。
- 作成と更新: id プロパティを持たないPlacesが作成され、id プロパティを持つ場所が ID によって更新されます。
- 場所階層: children@delta プロパティを使用して、親の場所内の子の場所を作成または更新します。 parentId プロパティは、子の場所に対して自動的に設定されます。
- 割り当てモードは、 アップサートの場所 ではまだサポートされていません。
- children@delta プロパティを使用して、既存の親の場所の下にある既存の子場所 を 更新することはサポートされていません。 これらは個別に更新する必要があります。
ジョブ レベルのコンカレンシー
ジョブ レベルのコンカレンシーでは、テナント内で同時に実行できるアップサート操作の数が制限されます。
- テナント レベルでは、3 つの同時アップサート操作のみが許可されます。
- 3 つの操作が既に作成されているか進行中の場合、
429 Too Many Requests応答コードを使用して別のPATCHAPI 呼び出しが拒否されます。