エラーと上限

​

エラーレスポンス

​

検証エラー

{
  "message": [
    "property _id should not exist",
    "name must be 2-36 characters of Korean, English letters, digits, spaces or ~%&+- (no leading or trailing spaces)"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "Invalid ULID",
  "error": "Bad Request",
  "statusCode": 400
}

​

ビジネスエラー

{
  "statusCode": 409,
  "errorCode": "TARGETING_NAME_DUPLICATE",
  "detail": {
    "existingId": "01JAB3XK5Q8V7M2N4P6R9T0W1Y"
  }
}

​

認証エラーと権限エラー

{
  "message": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Forbidden",
  "statusCode": 403
}

​

リクエストボディのサイズ超過

{
  "statusCode": 413,
  "message": "request entity too large"
}

​

サーバーエラー

{
  "message": "Upstream service error",
  "error": "Bad Gateway",
  "statusCode": 502
}

​

エラーコード

​

ステータス別のエラー

​

エラーコード別のエラー

• オプショングループに、下位オプションも自身のコンテキストIDもない場合
• type: "atomic"と一緒にchildrenを送信した場合、または通常のオプションにexposeChildrenを送信した場合
• オプションの追加で、parentをtype: "collection"、children、exposeChildrenのいずれかと一緒に送信した場合
• parentが、最上位のオプショングループではないオプションを指している場合
• 更新でオプショングループにparentを送信した場合。オプショングループは移動できません。
• 移動、切り離し、削除によって、自身のコンテキストIDを持たないオプショングループから最後の下位オプションがなくなる場合
• 更新によって、下位オプションを持たないオプショングループのコンテキストIDがすべてなくなる場合
• オプション一覧の取得のparentクエリパラメータが、通常のオプションを指している場合
• オプションが、APIで変更できない形式で保存されている場合（別のオプショングループの中にあるオプショングループなど）

​

detailフィールド

​

一括操作のレスポンス

​

レスポンスのフィールド

​

レスポンスのステータス

• 400の検証エラー。たとえば、項目が多すぎる場合、コンテキストIDが合計10,000個を超える場合、オプションの一括更新に同じ_idが2回含まれる場合です。
• オプションの一括削除での400 TARGETING_CATEGORY_TREE_ITEMS_LIMIT_EXCEEDED
• 401、403、413
• 404 PROJECT_NOT_FOUND
• 409 CONTEXT_TARGETING_WRITE_IN_PROGRESS

​

項目の反映方法

• オプションの一括更新は項目を並行して反映しますが、resultsはリクエストの順序どおりに並びます。1つのオプションへの変更は、すべて1つの項目にまとめてください。同じ_idが2回含まれると、リクエスト全体が拒否されます。
• 名前変更または更新のリクエストでは、前の項目が名前を変更して空けた名前を、後の項目で使えます。前の項目が失敗した場合、後の項目は名前重複エラーで失敗します。

​

例

curl -X POST https://lake.adrop.io/context-targeting/category/bulk/update \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "_id": "01JAB3XK5RA1B2C3D4E5F6G7H8", "contexts": { "add": ["basketball"] } },
      { "_id": "01JAB3XK5RA1B2C3D4E5F6G7H9", "name": "Sports" }
    ]
  }'

{
  "results": [
    {
      "index": 0,
      "success": true,
      "data": {
        "_id": "01JAB3XK5RA1B2C3D4E5F6G7H8",
        "name": "Sports",
        "type": "atomic",
        "contextCount": 4,
        "createdAt": "2026-10-13T01:23:45.000Z",
        "updatedAt": "2026-10-13T02:10:00.000Z"
      }
    },
    {
      "index": 1,
      "success": false,
      "error": {
        "statusCode": 409,
        "errorCode": "TARGETING_CATEGORY_NAME_DUPLICATE",
        "detail": {
          "existingIds": ["01JAB3XK5RA1B2C3D4E5F6G7H8"]
        }
      }
    }
  ],
  "succeeded": 1,
  "failed": 1
}

​

同時書き込み

{
  "statusCode": 409,
  "errorCode": "CONTEXT_TARGETING_WRITE_IN_PROGRESS",
  "timestamp": "2026-10-13T10:23:45+09:00",
  "detail": {
    "retryAfterMs": 2000
  }
}

1. detail.retryAfterMsミリ秒待ちます。値は0〜2,000です。
2. 同じリクエストを再送します。再び409が返された場合は、これを繰り返します。

​

再試行と重複リクエスト

​

作成リクエストの再送

• ターゲティング：409 TARGETING_NAME_DUPLICATEが返されます。detail.existingIdがそのターゲティングのIDです。オプションのIDを取得するには、ターゲティングの取得を参照してください。
• オプション：409 TARGETING_CATEGORY_NAME_DUPLICATEが返されます。detail.existingIdsに、その名前を持つオプションのIDが入ります。
• 一括作成では、元のリクエストで作成された項目だけがこのように失敗します。ほかの項目は通常どおり処理されます。

​

500または502が返された場合

• 作成または削除の一括リクエストのresultsに500 UNCATCHEDがある場合：リクエストの内容は何も反映されていません。同じリクエストを再送してください。
• 更新の一括リクエストのresultsに500 UNCATCHEDがある場合：その項目は失敗しています。その項目を再送してください。
• 500または502のレスポンスが返された場合：リクエストが反映されている場合と、反映されていない場合があります。同じリクエストを再送し、その結果を上の表に従って扱ってください。

​

上限

• 保存データの上限（オプションあたり、プロジェクトあたり、ターゲティングあたり、広告商品あたり）は、変更によって量が増える場合にのみ確認されます。コンテキストIDの削除など量を減らす変更は、データがすでに上限を超えていてもブロックされません。
• 1回のリクエストに収まらない量をアップロードするには、これらの上限内のリクエストに分割し、1件ずつ順番に送信してください。たとえば、数万個のオプションは、1回あたり最大5,000項目のオプション一括追加リクエストに分けて追加します。
• コンテキストIDが10,000個を超えるオプションのコンテキストIDを置き換える方法は、コンテキストIDの更新方法を参照してください。
• リクエストボディを小さく保つため、韓国語の名前やコンテキストIDなどの非ASCII文字は、UTF-8のまま送信してください。

​

名前のルール

• 日本語や中国語の文字、_、.、括弧など、それ以外の文字は使用できません。
• 1つのリクエストの中で繰り返される名前も、重複として扱われます。detailフィールドのduplicateOfIndexを参照してください。
• 現在の名前への変更は、エラーになりません。
• 異なるターゲティングのオプションには、同じ名前を付けられます。

​

コンソールと併用する場合

• 同じデータ：コンソールとAPIは、同じコンテキストターゲティングを管理します。APIで作成したターゲティングとオプションはコンソールに表示され、コンソールで作成したものもAPIで取得できます。
• コンテキストターゲティングのみ：オーディエンスターゲティングへのリクエストは404 TARGETING_NOT_FOUNDで、そのオプションへのリクエストは404 TARGETING_CATEGORY_NOT_FOUNDで失敗します。ただし、オーディエンスターゲティングの名前も名前の一意性の判定に含まれるため、同じ名前のコンテキストターゲティングを作成すると、detail.existingIdのない409 TARGETING_NAME_DUPLICATEで失敗します。
• コンソールでの編集は順番待ちの対象外：1件ずつの処理が適用されるのは、API書き込みだけです。コンソールでの編集はAPI書き込みを待たず、409 CONTEXT_TARGETING_WRITE_IN_PROGRESSの原因にもならず、API書き込みもコンソールでの編集を待ちません。
• 同時の変更による競合：コンソールとAPIが同じターゲティングを同時に変更すると、後から保存された変更が先の変更を上書きしたり、2つのターゲティングまたはオプションが同じ名前になったりすることがあります。自社のシステムがAPIでターゲティングに書き込んでいる間は、コンソールでそのターゲティングを編集しないでください。コンソールで変更された可能性がある場合は、書き込む前にターゲティングを取得し直してください。
• 名前の重複：2つのターゲティングまたはオプションが同じ名前になった場合は、どちらかの名前を変更するか、どちらかを削除してください。オプションを削除する前に、広告商品とキャンペーンへの影響を確認してください。
• 広告商品の設定：広告商品で 必須含む または 必須除外 に設定するオプションを変更するには、コンソールを使用してください。ターゲティングの販売を参照してください。