การเริ่มต้นใช้งาน DV360 Seller API
ขั้นตอนการเริ่มต้นใช้งาน API สําหรับ DV360 Seller API มี 2-3 ขั้นตอนหลักๆ DV360 Seller API จะแสดงเป็น Google Cloud API ตามรายการที่อนุญาต และใช้ OAuth สำหรับการตรวจสอบสิทธิ์
โปรดติดต่อทีม DV360 Seller API เพื่อดำเนินการตามกระบวนการเพิ่มลงในรายการที่อนุญาต
ขั้นตอนการเริ่มต้นใช้งาน
- ลงชื่อสมัครใช้บัญชี Google โดยไปที่ https://console.cloud.google.com/
- ระบบจะใช้บัญชีนี้เพื่อจัดการโทเค็นการเข้าถึงสําหรับลูกค้าเวอร์ชันที่ใช้งานจริง อย่าใช้บัญชี Gmail ส่วนตัว
- บัญชีต้องไม่ใช่ Google Group
- หากคุณใช้โปรเจ็กต์ Google Cloud ที่มีอยู่: บัญชีต้องเป็นผู้ดูแลระบบของโปรเจ็กต์
- ติดต่อ Google DV360 พร้อมข้อมูลบัญชีที่คุณลงชื่อสมัครใช้เพื่อขอให้เพิ่มบัญชีลงในรายการที่อนุญาต
- รอให้ระบบเพิ่มบัญชีของคุณลงในรายการที่อนุญาต
- ไม่บังคับและไม่บล็อก: ส่งคําขอการตรวจสอบการยืนยัน OAuth สําหรับแอปของคุณเพื่อเข้าถึงขอบเขต(doubleclickbidmanager)
- ไปที่ https://console.cloud.google.com/ ไปที่ API และบริการ -> คลัง -> ส่วนตัว คุณควรเห็น DV360 Seller API แสดงอยู่ในรายการ API ที่พร้อมใช้งาน
- เปิดใช้ DV360 Seller API
- ไปที่ข้อมูลเข้าสู่ระบบ -> สร้างข้อมูลเข้าสู่ระบบ -> คีย์บัญชีบริการ ทำตามวิธีการที่นี่ https://developers.google.com/identity/protocols/OAuth2ServiceAccount
วิธีตั้งค่าบัญชีบริการ
หมายเหตุ: โปรดแจ้งให้เราทราบหากต้องการใช้บัญชีบริการที่มีอยู่ซ้ำ เช่น สําหรับ DV360 Reporting APIการตรวจสอบสิทธิ์และการให้สิทธิ์ Google Cloud API (มักรวมกันเป็น "auth") มักจะทำโดยใช้บัญชีบริการ บัญชีบริการช่วยให้โค้ดส่งข้อมูลเข้าสู่ระบบของแอปพลิเคชันไปยัง Cloud API ได้โดยตรง บัญชีบริการจะแสดงด้วยอีเมลเช่นเดียวกับบัญชีผู้ใช้ อย่างไรก็ตาม บัญชีบริการเป็นของแอปพลิเคชันเท่านั้น ต่างจากบัญชีผู้ใช้ และอาจใช้เพื่อเข้าถึง API ที่สร้างขึ้นเท่านั้น ตัวอย่างเช่น เราจะแสดงวิธีสร้างข้อมูลเข้าสู่ระบบบัญชีบริการโดยใช้คอนโซล Google Cloud Platform
การใช้คอนโซล Google Cloud
จากหน้า API Manager→Credentials ของ Google Cloud Console ให้เลือก "สร้างข้อมูลเข้าสู่ระบบ→คีย์บัญชีบริการ"
ถัดไป ให้เลือก "บัญชีบริการใหม่" จากเมนูแบบเลื่อนลง "บัญชีบริการ"
พิมพ์ "ชื่อ" ของบัญชีบริการนี้ ระบบจะใช้ชื่อนี้เป็นชื่อเริ่มต้นสำหรับ "รหัสบัญชีบริการ" (ทางด้านซ้ายของ "@" ในที่อยู่รหัสบัญชีบริการที่สร้างขึ้น) แต่คุณเปลี่ยนชื่อรหัสบัญชีบริการนี้ได้หากต้องการ ชื่อเหล่านี้จะเป็นชื่ออะไรก็ได้ ขอแค่คุณจำได้ก็พอ ในส่วน "ประเภทคีย์" เราขอแนะนำให้คุณคงค่านี้เป็น "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 พร้อมแจ้งข้อมูล บัญชีบริการ ที่คุณสร้างขึ้น โดยเฉพาะอย่างยิ่ง เราต้องการอีเมลของบัญชีบริการนี้ นี่เป็นกระบวนการเพิ่มในรายการที่อนุญาตอีกวิธีหนึ่งสำหรับการให้สิทธิ์
- เมื่อบัญชีบริการได้รับสิทธิ์เรียก API แล้ว คุณสามารถดูเอกสารประกอบ API ได้ที่ https://developers.google.com/display-video/seller หากต้องการรับโทเค็นการให้สิทธิ์ด้วยตนเอง โปรดดูวิธีการที่นี่ https://github.com/google/oauth2l (คุณจะต้องดาวน์โหลดคีย์บัญชีบริการเวอร์ชัน JSON ไว้แล้ว) นอกจากนี้ ยังมีวิธีการโดยละเอียดเกี่ยวกับวิธีรับโทเค็น Oauth โดยใช้โปรแกรมที่ https://cloud.google.com/docs/authentication/production
สำคัญ: ขอบเขต OAuth ต้องเป็น "doubleclickbidmanager"