การเรียก Google Ad Manager API ทั้งหมดต้องได้รับสิทธิ์ผ่าน OAuth2 ซึ่งเป็นมาตรฐานแบบเปิดที่อนุญาตให้ผู้ใช้ให้สิทธิ์แก่แอปพลิเคชันของบุคคลที่สาม เพื่อให้แอปพลิเคชันโต้ตอบกับบริการบนเว็บในนามของผู้ใช้ได้ OAuth2 ทำให้แอปพลิเคชันไคลเอ็นต์ Ad Manager API เข้าถึงบัญชี Ad Manager ของผู้ใช้ได้โดยไม่ต้องจัดการหรือจัดเก็บชื่อผู้ใช้หรือรหัสผ่านของผู้ใช้
สร้างข้อมูลเข้าสู่ระบบ OAuth2
ทำตามขั้นตอนต่อไปนี้เพื่อสร้างข้อมูลเข้าสู่ระบบ OAuth2
1. กำหนดประเภทการตรวจสอบสิทธิ์
ดูตารางด้านล่างเพื่อดูว่าประเภทการตรวจสอบสิทธิ์ใดเหมาะกับแอปพลิเคชัน Ad Manager API ของคุณมากที่สุด
เลือกประเภทการตรวจสอบสิทธิ์ OAuth2 | |
---|---|
บัญชีบริการ |
เลือกตัวเลือกนี้หากคุณต้องการเข้าถึงข้อมูล Ad Manager ของคุณเองเท่านั้น ดูข้อมูลเพิ่มเติม |
เว็บแอปพลิเคชัน |
เลือกตัวเลือกนี้หากคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ที่ให้สิทธิ์แอปพลิเคชันเพื่อเข้าถึงข้อมูล Ad Manager ของตน ดูข้อมูลเพิ่มเติม |
2. สร้างข้อมูลเข้าสู่ระบบ OAuth2
เมื่อคุณระบุประเภทการตรวจสอบสิทธิ์แล้ว ให้คลิกแท็บที่เกี่ยวข้องด้านล่างและทำตามวิธีการเพื่อสร้างข้อมูลเข้าสู่ระบบ OAuth2
- เปิด หน้าข้อมูลเข้าสู่ระบบคอนโซล Google API
- จากรายการแบบเลื่อนลงของโปรเจ็กต์ ให้เลือกสร้างโปรเจ็กต์ใหม่ จากนั้นป้อนชื่อโปรเจ็กต์และแก้ไขรหัสโปรเจ็กต์ที่ระบุด้วยหรือไม่ก็ได้ คลิกสร้าง
- ในหน้าข้อมูลเข้าสู่ระบบ ให้เลือกสร้างข้อมูลเข้าสู่ระบบ จากนั้นเลือกคีย์บัญชีบริการ
- เลือกบัญชีบริการใหม่ แล้วเลือก JSON
- คลิกสร้างเพื่อดาวน์โหลดไฟล์ที่มีคีย์ส่วนตัว
- เปิด หน้าข้อมูลเข้าสู่ระบบคอนโซล Google API
- จากรายการแบบเลื่อนลงของโปรเจ็กต์ ให้เลือกสร้างโปรเจ็กต์ใหม่ ป้อนชื่อโปรเจ็กต์ (และแก้ไขรหัสโปรเจ็กต์ที่ระบุด้วยหรือไม่ก็ได้) และคลิกสร้าง
- ในหน้าข้อมูลเข้าสู่ระบบ ให้เลือกสร้างข้อมูลเข้าสู่ระบบ จากนั้นเลือกรหัสไคลเอ็นต์ OAuth
- ระบบอาจแจ้งให้คุณตั้งชื่อผลิตภัณฑ์ในหน้าหน้าจอคำยินยอม หากเป็นเช่นนั้น ให้คลิกกำหนดค่าหน้าจอคำยินยอม จัดเตรียมข้อมูลที่ขอ แล้วคลิกบันทึกเพื่อกลับไปที่หน้าข้อมูลเข้าสู่ระบบ
- เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน ทำตามวิธีการเพื่อป้อนต้นทางของ JavaScript, เปลี่ยนเส้นทาง URI หรือทั้งสองอย่าง
- คลิกสร้าง
- ในหน้าเว็บที่ปรากฏขึ้น ให้คัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ไปยังคลิปบอร์ด เนื่องจากคุณจะต้องใช้ข้อมูลนี้เมื่อกำหนดค่าไลบรารีไคลเอ็นต์
3. กำหนดค่าเครือข่าย Ad Manager
หากคุณเป็นนักพัฒนาแอปบุคคลที่สาม คุณอาจต้องให้ลูกค้าทำตามขั้นตอนนี้ให้คุณ
- ไปที่เครือข่าย Ad Manager
- คลิกแท็บผู้ดูแลระบบ
- ตรวจสอบว่าเปิดใช้การเข้าถึง API แล้ว
- คลิกปุ่มเพิ่มผู้ใช้บัญชีบริการ
- กรอกแบบฟอร์มโดยใช้อีเมลบัญชีบริการ ผู้ใช้บัญชีบริการต้องได้รับสิทธิ์ในการเข้าถึงเอนทิตีเหมือนกับว่าผู้ใช้บัญชีบริการนั้นเข้าถึงเอนทิตีใน UI
- คลิกปุ่มบันทึก ข้อความควรจะปรากฏขึ้นเพื่อยืนยันการเพิ่มบัญชีบริการ
- ดูผู้ใช้บัญชีบริการที่มีอยู่โดยไปที่แท็บผู้ใช้ แล้วคลิกตัวกรองบัญชีบริการ
- ไปที่เครือข่าย Ad Manager
- คลิกแท็บผู้ดูแลระบบ
- ตรวจสอบว่าเปิดใช้การเข้าถึง API แล้ว
4. กำหนดค่าและใช้ไลบรารีของไคลเอ็นต์
โปรดปฏิบัติตามคู่มือที่เหมาะสมด้านล่างเพื่อใช้ข้อมูลเข้าสู่ระบบในไลบรารีของไคลเอ็นต์
Java
.NET
Python
PHP
Ruby
หากเลือกไม่ใช้ไลบรารีไคลเอ็นต์ของเรา คุณจะต้องใช้ขั้นตอนบัญชีบริการหรือเว็บแอป OAuth2 ด้วยตนเอง
วิดีโอเบื้องหลัง
ไลบรารีไคลเอ็นต์ของเราจะดูแลรายละเอียดที่ครอบคลุมด้านล่างนี้โดยอัตโนมัติ ดังนั้น ให้อ่านต่อเมื่อคุณสนใจในสิ่งที่กำลังเกิดขึ้นเบื้องหลังเท่านั้น ส่วนนี้มีไว้สำหรับผู้ใช้ขั้นสูงที่คุ้นเคยกับข้อกำหนด OAuth2 อยู่แล้วและทราบวิธีใช้ OAuth2 กับ Google APIs
ส่วนหัวของคำขอ HTTP
ส่วนหัว HTTP ในทุกคำขอที่ส่งไปยัง Ad Manager API ต้องมีโทเค็นเพื่อการเข้าถึงในแบบฟอร์มนี้
Authorization: Bearer ACCESS_TOKEN
เช่น
POST … HTTP/1.1 Host: … Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg Content-Type: text/xml;charset=UTF-8 Content-Length: … <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"> … </soap:Envelope>
ขอบเขต
โทเค็นเพื่อการเข้าถึงรายการเดียวสามารถให้สิทธิ์เข้าถึง API หลายรายการได้ในระดับที่แตกต่างกัน พารามิเตอร์ตัวแปรที่ชื่อ scope
จะควบคุมชุดทรัพยากรและการดำเนินการที่โทเค็นเพื่อการเข้าถึงอนุญาต ในระหว่างการขอโทเค็นเพื่อการเข้าถึง แอปพลิเคชันจะส่งค่าอย่างน้อย 1 ค่าในพารามิเตอร์ scope
Ad Manager มีขอบเขตเดียวเท่านั้นตามที่แสดงด้านล่าง ควรดำเนินการให้สิทธิ์ ในระดับผู้ใช้ภายในผลิตภัณฑ์
ขอบเขต | สิทธิ์ |
---|---|
https://www.googleapis.com/auth/dfp |
ดูและจัดการแคมเปญใน Ad Manager |