ภาพรวม

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

ตั้งค่าการตรวจสอบสิทธิ์

Google APIs ใช้โปรโตคอล OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ ต่อไปนี้เป็นวิธีตั้งค่าบัญชี บริการเพื่อ เข้าถึง Curation Partners API

  1. หากยังไม่ได้ดำเนินการ ให้สร้าง โปรเจ็กต์ Google Cloud ที่โฮสต์ข้อมูลเข้าสู่ระบบที่ใช้ในการเข้าถึง API

  2. ไปที่หน้า คอนโซล Google Cloud - APIs ที่เปิดใช้ เลือกโปรเจ็กต์ที่สร้างไว้ก่อนหน้านี้

  3. ตรวจสอบรายการ API และบริการที่เปิดใช้ คุณต้องเปิดใช้ Curation Partners API จึงจะเข้าถึงได้ หากไม่ได้เปิดใช้ Curation Partners API ให้คลิก +เปิดใช้ API และบริการ แล้วทำตามวิธีการต่อไปนี้

    1. ค้นหา Curation Partners API โดยใช้ช่องค้นหา
    2. เลือก Curation Partners API ในหน้าผลการค้นหา
    3. คลิกเปิดใช้

    ปัญหาที่ทราบคือคุณอาจไม่พบ Curation Partners API ในช่องค้นหาของคอนโซล Google Cloud คุณสามารถใช้ Google Cloud CLI เพื่อเปิดใช้ API แทนได้ หลังจากติดตั้ง gcloud CLI แล้ว คุณจะเปิดใช้ Curation Partners API ได้ด้วยคำสั่งต่อไปนี้

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. เลือกข้อมูลเข้าสู่ระบบ ในเมนูการนำทาง

  5. คลิก +สร้างข้อมูลเข้าสู่ระบบ แล้วเลือก บัญชีบริการ ในเมนูแบบเลื่อนลงที่ปรากฏขึ้น

  6. ป้อนชื่อ สำหรับบัญชีบริการ ระบบจะสร้างรหัสบัญชีบริการ โดยอัตโนมัติเมื่อสร้างบัญชี ให้จดค่านี้ไว้เนื่องจากคุณจะต้องใช้ในขั้นตอนที่ 14 ป้อนคำอธิบายหรือไม่ก็ได้ คลิกสร้างและดำเนินการต่อ

  7. กำหนดค่าสิทธิ์สำหรับบัญชีบริการหรือไม่ก็ได้ แล้วคลิกดำเนินการต่อ

  8. กำหนดค่าผู้ใช้หรือกลุ่มที่สามารถดำเนินการในฐานะบัญชีบริการหรือไม่ก็ได้ แล้วคลิกเสร็จสิ้น

  9. บัญชีบริการใหม่จะแสดงอยู่ในส่วนบัญชีบริการ ค้นหาและคลิกรหัสบัญชีบริการที่เพิ่งสร้าง

  10. คลิกแท็บคีย์

  11. เลือกสร้างคีย์ใหม่ ในเมนูแบบเลื่อนลงเพิ่มคีย์

  12. เลือก JSON เป็น ประเภทคีย์ แล้วคลิก สร้าง

  13. ดาวน์โหลดคีย์ลงในไดเรกทอรีงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดเก็บคีย์อย่างปลอดภัยได้ที่ การจัดการคีย์ของบัญชีบริการ แอปพลิเคชันของคุณจะใช้คีย์นี้เพื่อเรียก API

  14. แชร์รหัสบัญชีบริการกับผู้จัดการฝ่ายดูแลลูกค้าด้านเทคนิคเพื่อลิงก์บัญชีบริการกับบัญชีของคุณ

ขอบเขต API

เมื่อทำตามขั้นตอน OAuth 2.0 เพื่อรับโทเค็นเพื่อการเข้าถึงที่ใช้ในการเรียก API คุณต้องระบุ API ที่เข้าถึงได้โดยใช้โทเค็นนั้น สำหรับ Curation Partners API ขอบเขตคือ https://www.googleapis.com/auth/curation-partners

วิธีระบุกลุ่มเป้าหมายตามข้อมูลใน API เทียบกับการดูแลจัดการแบบเรียลไทม์

ใน Curation Partners API ระบบจะระบุกลุ่มเป้าหมายตามข้อมูลด้วย ชื่อทรัพยากร ที่เฉพาะเจาะจงกับ API เช่น

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

เมื่อ ระบุกลุ่มเป้าหมายตามข้อมูลที่เกี่ยวข้องกับโอกาสในการแสดงโฆษณาใน การดูแลจัดการแบบเรียลไทม์ ให้ระบุค่าสำหรับรหัสทรัพยากร DATA_SEGMENT_ID แทน ชื่อทรัพยากรแบบเต็มที่ API ให้ไว้ในช่อง name

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