创建和修改数据细分受众群

创建新的数据细分

您可以使用 curators.dataSegments.create 方法创建新的数据段。创建后，您的细分数据将处于 ACTIVE 状态，从而使在实时出价中投放的交易或套餐能够定位到该细分数据。

如需让媒体策划人员能够看到数据细分，以便针对交易或套餐进行定位，您必须在甄选界面的数据细分设置标签页中启用细分可见性。

要点：创建数据细分时，请求正文必须包含一个 name 字段，其中包含具有唯一 curatorDataSegmentId 字符串值的资源路径。 curatorDataSegmentId 是用于交易或套餐定位的值。

以下示例发出 HTTP POST 请求，其 JSON 正文包含 DataSegment 对象。请求会发送到用于创建具有指定配置的数据段的 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 字段。

以下示例发出 HTTP PATCH 请求，其 JSON 正文包含 DataSegment 对象。该请求会发送到用于修改指定数据段的 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"
}
    

后续步骤

• 了解如何使用 Marketplace API 启用和停用数据细分。
• 了解如何使用 Marketplace API 查看数据细分受众群。
• 了解实时内容精选规范。
• 了解如何在实时内容精选中解析传入的细分请求。