個々のデータ セグメントを表示する
データ セグメントのいずれかを表示するには、curators.dataSegments.get メソッドを使用します。
次の例では、指定されたデータ セグメントを返す API エンドポイントに HTTP GET リクエストを送信します。
curl API 呼び出しの例
プロモーション URL の
curl \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
レスポンス
{
"name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
"createTime": "2025-08-13T12:14:03.421Z",
"updateTime": "2025-08-14T19:47:40.253938Z",
"cpmFee": {
"currencyCode": "USD",
"units": "1000000"
},
"state": "INACTIVE"
}
すべてのデータ セグメントのリストを表示する
すべてのデータ セグメントを表示するには、curators.dataSegments.list メソッドを使用します。
次の例では、指定されたキュレーター アカウントのすべてのデータ セグメントを返す API エンドポイントに HTTP GET リクエストを送信します。
curl API 呼び出しの例
プロモーション URL の
curl \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
レスポンス
{
"dataSegments": [
{
"name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
"createTime": "2025-08-13T12:14:03.421Z",
"updateTime": "2025-08-14T20:05:51.439110Z",
"cpmFee": {
"currencyCode": "USD",
"units": "1"
},
"state": "INACTIVE"
},
{
"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"
}
]
}
次のステップ
- Marketplace API を使用してデータセグメントを有効化、無効化する方法について説明します。
- リアルタイム キュレーションの仕様について学習する。
- リアルタイム キュレーションで受信したセグメント リクエストを解析する方法について説明します。