ตั้งค่าการเข้าถึง API

วิธีตั้งค่าสิทธิ์เข้าถึง Data Manager API ด้วย SDK หรือ REST มีดังนี้

เลือกประเภทกระบวนการตั้งค่าที่คุณต้องการทำตาม

ผู้ลงโฆษณา พาร์ทเนอร์ด้านข้อมูล

ข้อกำหนดเบื้องต้น

ก่อนที่จะใช้ Data API ได้ โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

1. โปรเจ็กต์ Google Cloud
2. บัญชี Google ที่มีสิทธิ์ serviceusage.services.enable ในโปรเจ็กต์ Google Cloud หรือมีบทบาทที่มีสิทธิ์ดังกล่าว ตัวอย่างเช่น roles/owner และ roles/serviceusage.serviceUsageAdmin มีสิทธิ์ serviceusage.services.enable ทั้งคู่ หากต้องการตรวจสอบสิทธิ์ ให้ดูดูสิทธิ์เข้าถึงปัจจุบัน
3. ติดตั้งอินเทอร์เฟซบรรทัดคำสั่งของ Google Cloud

เปิดใช้ API

หากยังไม่ได้ดำเนินการ ให้เปิดใช้ Data Manager API โดยคลิกเปิดใช้ Data Manager API หรือทำตามวิธีการเพื่อดำเนินการ ขั้นตอนนี้ด้วยตนเอง

เปิดใช้ Data Manager API

หากไม่พบ Data Manager API หรือเปิดใช้ Data Manager API ไม่สำเร็จ ให้ตรวจสอบว่าบัญชี Google เป็นไปตามข้อกำหนดเบื้องต้น

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

คุณสามารถใช้วิธีการตรวจสอบสิทธิ์ที่ Google นอกเหนือจากคีย์ API ได้ เราขอแนะนำให้คุณดูวิธีเลือกวิธีการตรวจสอบสิทธิ์ที่เหมาะสมสำหรับกรณีการใช้งานของคุณ เพื่อพิจารณาว่าแนวทางใดที่เหมาะกับกรณีการใช้งานของคุณ

วิธีการตรวจสอบสิทธิ์ที่ใช้กันโดยทั่วไป 2 วิธีคือบัญชีผู้ใช้และบัญชีบริการ

• บัญชีผู้ใช้: แสดงถึงผู้ที่โต้ตอบกับ Google API และ บริการโดยตรง
• บัญชีบริการ: แสดงแอป ไม่ใช่ผู้ใช้ ซึ่งช่วยให้แอปของคุณจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ เช่น หากแอป ต้องเข้าถึงทรัพยากร Google Cloud

การผสานรวมสามารถใช้ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชัน (ADC) เพื่อ ค้นหาข้อมูลเข้าสู่ระบบจากสภาพแวดล้อมโดยอัตโนมัติ คุณจึงไม่ต้องเปลี่ยน โค้ดไคลเอ็นต์เพื่อตรวจสอบสิทธิ์

เลือกบัญชีผู้ใช้หรือการแอบอ้างเป็นบัญชีบริการเพื่อตั้งค่า ADC

บัญชีผู้ใช้ การแอบอ้างเป็นบัญชีบริการ

ขั้นตอนในการตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของบัญชีผู้ใช้มีดังนี้

1. กำหนดค่าการตั้งค่า Google Auth Platform สำหรับโปรเจ็กต์

   สำคัญ: แอป Google Cloud ที่ใช้เพื่อรับข้อมูลเข้าสู่ระบบของผู้ใช้สำหรับขอบเขต Data Manager API ต้องผ่านการยืนยัน OAuth ของ Google เพื่อหลีกเลี่ยงหน้าจอ UI ที่ไม่ได้รับการยืนยันสำหรับผู้ใช้ ไม่จำเป็นต้องมีการยืนยัน OAuth ของ Google สำหรับบัญชีบริการ

   1. เปิดหน้าการสร้างแบรนด์ ใน Google Cloud Console

   2. เลือกโปรเจ็กต์

   3. กรอกแบบฟอร์ม แล้วคลิกสร้าง

2. เนื่องจากขอบเขต Data Manager API เป็นขอบเขตที่มีความละเอียดอ่อน คุณจึงต้องทำตามขั้นตอนต่อไปนี้

   1. ไปที่การตั้งค่าการเข้าถึงข้อมูลสำหรับโปรเจ็กต์

   2. คลิกเพิ่มหรือนำขอบเขตออก

   3. เลือกช่องข้าง Data Manager API ในรายการขอบเขต แล้วคลิกอัปเดต

   4. คลิกบันทึก

   5. ไปที่กลุ่มเป้าหมายใน Google Cloud Console แล้วอัปเดตสถานะการเผยแพร่และประเภทผู้ใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าเหล่านี้ได้ในจัดการกลุ่มเป้าหมายแอป

3. คลิกสร้างไคลเอ็นต์ OAuth2 เพื่อสร้างไคลเอ็นต์ OAuth2 ในโปรเจ็กต์ หรือทำตามวิธีการ เพื่อสร้างไคลเอ็นต์ OAuth2 สำหรับเดสก์ท็อป คุณข้ามขั้นตอนนี้ได้หากมีไคลเอ็นต์ OAuth2 เดสก์ท็อป ที่ต้องการใช้กับ Data Manager API อยู่แล้ว

   หากคลิกสร้างไคลเอ็นต์ OAuth2 ให้เลือกแอปบนเดสก์ท็อปเมื่อระบบแจ้งให้กำหนดค่าไคลเอ็นต์ OAuth เพื่อให้คุณใช้ไคลเอ็นต์ในขั้นตอนที่เหลือได้

   สร้างไคลเอ็นต์ OAuth2

   ในขั้นตอนสุดท้าย ให้คลิกดาวน์โหลดการกำหนดค่าไคลเอ็นต์และจดบันทึก ตำแหน่งดาวน์โหลดที่คุณเลือก

4. สร้างไฟล์ ADC ในเครื่องโดยการเรียกใช้คำสั่งต่อไปนี้ คำสั่งนี้จะเปิดโฟลว์เว็บซึ่งระบบจะ แจ้งให้คุณเข้าสู่ระบบบัญชี Google ที่คุณใช้กับ API

   แทนที่ PATH_TO_CLIENT_JSON ด้วยชื่อไฟล์ JSON ที่คุณดาวน์โหลด

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสําหรับ Data Manager API และ Google Ads API ให้รวมขอบเขต Google Ads API ไว้ใน--scopes รายการ

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   หากต้องการใช้ข้อมูลเข้าสู่ระบบเดียวกันสำหรับ Data Manager API และ Display & Video 360 API ให้รวมขอบเขต Display & Video 360 API ไว้ใน--scopes รายการ

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

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

   gcloud auth application-default print-access-token
   

หมายเหตุ: ต้องมีขอบเขต https://www.googleapis.com/auth/datamanager สำหรับบริการทั้งหมดใน Data Manager API

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และข้อมูลเข้าสู่ระบบสำหรับแอปได้ที่วิธีการตรวจสอบสิทธิ์ที่ Google และวิธีการทำงานของข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชัน

ตั้งค่าสิทธิ์เข้าถึงบัญชี

ให้สิทธิ์เข้าถึง Destination แก่อีเมลที่เชื่อมโยงกับบัญชีผู้ใช้ของคุณ

• หากใช้บัญชี Google Ads ให้ทําตามวิธีการเพื่อเพิ่มอีเมลของผู้ใช้ลงในบัญชี Google Ads หรือบัญชีดูแลจัดการ Google Ads หลัก
• หากใช้บัญชี Display & Video 360 ให้ทำตามวิธีการเพื่อ เพิ่มอีเมลของผู้ใช้ลงในบัญชี
• หากใช้พร็อพเพอร์ตี้ Google Analytics ให้ทําตามวิธีการเพื่อ เพิ่มอีเมลของผู้ใช้ลงในบัญชี

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

ติดตั้งไลบรารีของไคลเอ็นต์และเรียกใช้ ตัวอย่างโค้ดเพื่อลองใช้คำขอ Data Manager API แรก