การเริ่มต้นใช้งาน Display &Video 360 Seller API
การเริ่มต้นใช้งาน Display &Video 360 Seller API มีขั้นตอนสำคัญ 2-3 ขั้นตอน DV360 Seller API เป็น Google Cloud API ที่อิงตามรายการที่อนุญาต และใช้ OAuth 2.0 ในการตรวจสอบสิทธิ์และการให้สิทธิ์
ทีม Display &Video 360 Seller API จะเป็นผู้จัดการกระบวนการเพิ่มลงในรายการที่อนุญาต
ขั้นตอนการเริ่มต้นใช้งาน
- ลงชื่อสมัครใช้บัญชี Google โดยไปที่ https://console.cloud.google.com/
- บัญชีนี้จะใช้เพื่อจัดการโทเค็นเพื่อการเข้าถึงสำหรับไคลเอ็นต์ที่ใช้งานจริง อย่าใช้บัญชี Gmail ส่วนตัว
- บัญชีดังกล่าวต้องไม่ใช่ Google Group
- หากคุณใช้โปรเจ็กต์ Google Cloud ที่มีอยู่ บัญชีดังกล่าวต้องเป็นผู้ดูแลระบบของโปรเจ็กต์
- ติดต่อทีม Google DV360 พร้อมรายละเอียดบัญชีเพื่อเพิ่มบัญชีลงในรายการที่อนุญาต
- รอการยืนยันว่าบัญชีของคุณเปิดใช้แล้ว
- ไม่บังคับและไม่บล็อก: ส่งคำขอตรวจสอบสิทธิ์ OAuthสำหรับแอปพลิเคชันเพื่อเข้าถึงขอบเขต
https://www.googleapis.com/auth/doubleclickbidmanager - ใน คอนโซล Google Cloud ให้ไปที่ API และบริการ > ไลบรารี > ส่วนตัว คุณควรเห็น DV360 Seller API พร้อมใช้งานสำหรับโปรเจ็กต์
- เปิดใช้ DV360 Seller API
- ไปที่ API และบริการ > ข้อมูลเข้าสู่ระบบ > สร้างข้อมูลเข้าสู่ระบบ > คีย์บัญชีบริการ ทำตามวิธีการตั้งค่าในเอกสารประกอบเกี่ยวกับบัญชีบริการ OAuth 2.0
ตั้งค่าบัญชีบริการโดยทำดังนี้
หมายเหตุ: โปรดแจ้งให้เราทราบหากคุณต้องการใช้บัญชีบริการที่มีอยู่ซ้ำ เช่น บัญชีที่ใช้สำหรับ DV360 Reporting APIโดยปกติแล้ว การตรวจสอบสิทธิ์และการให้สิทธิ์ (มักเรียกรวมกันว่า "การตรวจสอบสิทธิ์") ของ Google Cloud API จะดำเนินการโดยใช้บัญชีบริการ บัญชีบริการช่วยให้โค้ดส่งข้อมูลเข้าสู่ระบบของแอปพลิเคชันไปยัง Cloud API ได้โดยตรง บัญชีบริการจะแสดงด้วยอีเมลเช่นเดียวกับบัญชีผู้ใช้ อย่างไรก็ตาม บัญชีบริการเป็นของแอปพลิเคชันเท่านั้น และใช้ได้เฉพาะเพื่อเข้าถึง API ที่สร้างขึ้นเท่านั้น ตัวอย่างเช่น เราจะแสดงวิธีสร้างข้อมูลเข้าสู่ระบบบัญชีบริการโดยใช้คอนโซล Google Cloud Platform
การใช้คอนโซล Google Cloud
จากหน้า API Manager→ข้อมูลเข้าสู่ระบบ ของ คอนโซล Google Cloud ให้เลือก "สร้างข้อมูลเข้าสู่ระบบ→คีย์บัญชีบริการ"
จากนั้นเลือก "บัญชีบริการใหม่" จากเมนูแบบเลื่อนลง "บัญชีบริการ"
พิมพ์ "ชื่อ" สำหรับบัญชีบริการนี้ ระบบจะใช้ชื่อนี้เป็นชื่อเริ่มต้นสำหรับ "รหัสบัญชีบริการ" (ทางด้านซ้ายของ "@" ในอีเมลรหัสบัญชีบริการที่สร้างขึ้น) แต่คุณสามารถเปลี่ยนชื่อรหัสบัญชีบริการนี้ได้หากต้องการ ชื่อเหล่านี้สามารถเป็นชื่อใดก็ได้ สิ่งสำคัญคือคุณต้องจำชื่อได้ ในส่วน "ประเภทคีย์" เราขอแนะนำให้คุณคงค่านี้ไว้ที่ "JSON" คลิก "สร้าง" แล้วคอนโซล GCP จะสร้างคีย์ JSON (เป็นไฟล์ข้อความ
.json) แจ้งให้คุณดาวน์โหลดไฟล์ลงในคอมพิวเตอร์ และแสดงกล่องโต้ตอบสร้างบัญชีบริการแล้ว
คีย์ JSON ที่สร้างขึ้นจะมีลักษณะคล้ายกับคีย์ JSON ตัวอย่างต่อไปนี้
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }
จัดเก็บไฟล์ JSON นี้อย่างปลอดภัย เนื่องจากมีคีย์ส่วนตัว (และไฟล์นี้เป็นสำเนาเดียวของคีย์ดังกล่าว) คุณจะต้องอ้างอิงไฟล์คีย์บัญชีบริการนี้ภายในโค้ดเมื่อต้องการส่งข้อมูลเข้าสู่ระบบไปยัง Google Cloud Platform API
- ติดต่อทีม DV360 พร้อมข้อมูลบัญชีบริการ ที่คุณสร้างขึ้น (โดยเฉพาะอีเมลของบัญชีบริการ) นี่เป็นขั้นตอนที่ 2 ในการเพิ่มลงในรายการที่อนุญาตสำหรับการให้สิทธิ์
- เมื่อบัญชีบริการได้รับอนุญาตให้เรียกใช้ API แล้ว คุณสามารถดูเอกสารประกอบ DV360 Seller API ได้ หากต้องการรับโทเค็นการตรวจสอบสิทธิ์ด้วยตนเอง โปรดดูวิธีการในที่เก็บเครื่องมือ oauth2l (โดยใช้คีย์บัญชีบริการ JSON ที่คุณดาวน์โหลด) ดูวิธีการโดยละเอียดเกี่ยวกับการรับโทเค็น OAuth โดยใช้โปรแกรมได้ในเอกสารประกอบการตรวจสอบสิทธิ์ของ Google Cloud
สำคัญ: ขอบเขต OAuth ต้องเป็น https://www.googleapis.com/auth/doubleclickbidmanager