Curation

  • Use the curators.dataSegments.activate method to activate a data segment.

  • Use the curators.dataSegments.deactivate method to deactivate a data segment.

  • Buyers can target activated data segments in deals or packages.

Activate a data segment

To activate one of your data segments, use the curators.dataSegments.activate method. Buyers can target data segments in deals or packages.

The following example makes an HTTP POST request to an API endpoint that activates a specified data segment.

Example curl API call

Request

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1:activate?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed

Response

{
  "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": "ACTIVE"
}

Deactivate a data segment

To deactivate one of your data segments, use the curators.dataSegments.deactivate method.

The following example makes an HTTP POST request to an API endpoint that deactivates a specified data segment.

Example curl API call

Request

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1:deactivate?key=[YOUR_API_KEY]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed

Response

{
  "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": "1000000"
  },
  "state": "INACTIVE"
}

Next steps