สร้างและแก้ไขกลุ่มข้อมูล

สร้างกลุ่มเป้าหมายตามข้อมูลใหม่

คุณสามารถสร้างกลุ่มเป้าหมายตามข้อมูลใหม่ได้โดยใช้เมธอด curators.dataSegments.create หลังจากสร้างแล้ว กลุ่มเป้าหมายตามข้อมูลของคุณจะอยู่ในสถานะ ACTIVE ซึ่งช่วยให้ดีลหรือแพ็กเกจที่แสดงในการเสนอราคาแบบเรียลไทม์กำหนดเป้าหมายไปยังกลุ่มเป้าหมายตามข้อมูลได้

หากต้องการให้กลุ่มข้อมูลปรากฏแก่เจ้าหน้าที่วางแผนโฆษณาสำหรับการกำหนดเป้าหมายดีลหรือแพ็กเกจ คุณต้องเปิดใช้ การมองเห็นกลุ่มข้อมูล ในแท็บการตั้งค่ากลุ่มข้อมูล ของ UI การดูแลจัดการ

ตัวอย่างต่อไปนี้จะส่งคำขอ HTTP POST พร้อมเนื้อหา JSON ที่มีออบเจ็กต์ DataSegment คำขอจะถูกส่งไปยังอุปกรณ์ปลายทาง API ที่สร้างกลุ่มข้อมูลด้วยการกำหนดค่าที่ระบุ

ตัวอย่างการเรียก API ด้วย curl

ส่งคำขอ 

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 ที่แก้ไขกลุ่มข้อมูลที่ระบุ และจะแก้ไขเฉพาะช่อง DataSegment.cpmFee.nanos ที่ระบุใน updateMask

ตัวอย่างการเรียก API ด้วย curl

ส่งคำขอ 

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

ขั้นตอนถัดไป