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

새 데이터 세그먼트 만들기

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

거래 또는 패키지 타겟팅을 위해 미디어 계획 담당자에게 데이터 세그먼트를 표시하려면 선별 UI의 데이터 세그먼트 설정 탭에서 세그먼트 공개 상태를 사용 설정해야 합니다.

요점: 데이터 세그먼트를 만들 때 요청 본문에는 고유한 curatorDataSegmentId 문자열 값이 포함된 리소스 경로가 포함된 name 필드가 포함되어야 합니다. curatorDataSegmentId은 할인 또는 패키지 타겟팅에 사용되는 값입니다.

다음 예시에서는 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"
}
    

다음 단계

• Marketplace API를 사용하여 데이터 세그먼트를 활성화 및 비활성화하는 방법을 알아보세요.
• Marketplace API로 데이터 세그먼트를 확인하는 방법을 알아보세요.
• 실시간 선별 사양에 대해 알아보세요.
• 실시간 맞춤설정에서 수신되는 세그먼트 요청을 파싱하는 방법을 알아봅니다.