데이터 세그먼트 만들기 및 수정

새 데이터 세그먼트 만들기

curators.dataSegments.create 메서드를 사용하여 새 데이터 세그먼트를 만들 수 있습니다. 생성 후 내 데이터 세그먼트는 ACTIVE 상태가 되므로 실시간 입찰에서 게재되는 거래 또는 패키지가 데이터 세그먼트를 타겟팅할 수 있습니다.

거래 또는 패키지 타겟팅을 위해 미디어 기획자에게 데이터 세그먼트를 표시하려면 세그먼트 공개 상태를 데이터 세그먼트 설정 탭의 Curation 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 요청을 합니다. 요청은 지정된 데이터 세그먼트를 수정하고 updateMask에 지정된 DataSegment.cpmFee.nanos 필드만 수정하는 API 엔드포인트로 전송됩니다.

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"
}

다음 단계