データ セグメントを作成、変更する

新しいデータ セグメントを作成する

curators.dataSegments.create メソッドを使用して、新しいデータ セグメントを作成できます。作成後、データ セグメントは ACTIVE 状態になり、リアルタイム ビッディングで配信される取引やパッケージでデータ セグメントをターゲットに設定できるようになります。

データ セグメントをメディア プランナーが取引やパッケージのターゲティングに使用できるようにするには、キュレーション UI の [データ セグメントの設定] タブで [セグメントの公開設定] を有効にする必要があります。

次の例では、DataSegment オブジェクトを含む JSON 本文を使用して HTTP POST リクエストを行います。リクエストは、指定された構成でデータセグメントを作成する API エンドポイントに送信されます。

curl API 呼び出しの例

リクエスト

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"cpmFee":{"nanos":100,"units":0,"currencyCode":"USD"},"name":"curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2"}' \
--compressed

レスポンス

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744379Z",
  "updateTime": "2025-08-14T17:45:08.744379Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 100
  },
  "state": "ACTIVE"
}

既存のデータ セグメントを変更する

既存のデータ セグメントを変更するには、curators.dataSegments.patch メソッドを使用します。たとえば、このメソッドを使用して、データ セグメントの cpmFee フィールドを調整します。

次の例では、DataSegment オブジェクトを含む JSON 本文を使用して HTTP PATCH リクエストを行います。リクエストは、指定されたデータセグメントを変更する API エンドポイントに送信され、updateMask で指定された DataSegment.cpmFee.nanos フィールドのみが変更されます。

curl API 呼び出しの例

リクエスト

curl --request PATCH \
  'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2?updateMask=cpmFee.nanos&key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"cpmFee":{"nanos":50}}' \
  --compressed

レスポンス

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744Z",
  "updateTime": "2025-08-14T17:56:02.200619Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 50
  },
  "state": "ACTIVE"
}

次のステップ