การตรวจสอบสิทธิ์

การเรียก 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

บัญชีบริการ
  1. เปิด หน้าข้อมูลเข้าสู่ระบบคอนโซล Google API
  2. จากรายการแบบเลื่อนลงของโปรเจ็กต์ ให้เลือกสร้างโปรเจ็กต์ใหม่ จากนั้นป้อนชื่อโปรเจ็กต์และแก้ไขรหัสโปรเจ็กต์ที่ระบุด้วยหรือไม่ก็ได้ คลิกสร้าง
  3. ในหน้าข้อมูลเข้าสู่ระบบ ให้เลือกสร้างข้อมูลเข้าสู่ระบบ จากนั้นเลือกคีย์บัญชีบริการ
  4. เลือกบัญชีบริการใหม่ แล้วเลือก JSON
  5. คลิกสร้างเพื่อดาวน์โหลดไฟล์ที่มีคีย์ส่วนตัว
เว็บแอปพลิเคชัน
  1. เปิด หน้าข้อมูลเข้าสู่ระบบคอนโซล Google API
  2. จากรายการแบบเลื่อนลงของโปรเจ็กต์ ให้เลือกสร้างโปรเจ็กต์ใหม่ ป้อนชื่อโปรเจ็กต์ (และแก้ไขรหัสโปรเจ็กต์ที่ระบุด้วยหรือไม่ก็ได้) และคลิกสร้าง
  3. ในหน้าข้อมูลเข้าสู่ระบบ ให้เลือกสร้างข้อมูลเข้าสู่ระบบ จากนั้นเลือกรหัสไคลเอ็นต์ OAuth
  4. ระบบอาจแจ้งให้คุณตั้งชื่อผลิตภัณฑ์ในหน้าหน้าจอคำยินยอม หากเป็นเช่นนั้น ให้คลิกกำหนดค่าหน้าจอคำยินยอม จัดเตรียมข้อมูลที่ขอ แล้วคลิกบันทึกเพื่อกลับไปที่หน้าข้อมูลเข้าสู่ระบบ
  5. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน ทำตามวิธีการเพื่อป้อนต้นทางของ JavaScript, เปลี่ยนเส้นทาง URI หรือทั้งสองอย่าง
  6. คลิกสร้าง
  7. ในหน้าเว็บที่ปรากฏขึ้น ให้คัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ไปยังคลิปบอร์ด เนื่องจากคุณจะต้องใช้ข้อมูลนี้เมื่อกำหนดค่าไลบรารีไคลเอ็นต์
ภาพหน้าจอรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

3. กำหนดค่าเครือข่าย Ad Manager

หากคุณเป็นนักพัฒนาแอปบุคคลที่สาม คุณอาจต้องให้ลูกค้าทำตามขั้นตอนนี้ให้คุณ

บัญชีบริการ
  1. ไปที่เครือข่าย Ad Manager
  2. คลิกแท็บผู้ดูแลระบบ
  3. ตรวจสอบว่าเปิดใช้การเข้าถึง API แล้ว
  4. คลิกปุ่มเพิ่มผู้ใช้บัญชีบริการ
  5. กรอกแบบฟอร์มโดยใช้อีเมลบัญชีบริการ ผู้ใช้บัญชีบริการต้องได้รับสิทธิ์ในการเข้าถึงเอนทิตีเหมือนกับว่าผู้ใช้บัญชีบริการนั้นเข้าถึงเอนทิตีใน UI
  6. คลิกปุ่มบันทึก ข้อความควรจะปรากฏขึ้นเพื่อยืนยันการเพิ่มบัญชีบริการ
  7. ดูผู้ใช้บัญชีบริการที่มีอยู่โดยไปที่แท็บผู้ใช้ แล้วคลิกตัวกรองบัญชีบริการ
เว็บแอปพลิเคชัน
  1. ไปที่เครือข่าย Ad Manager
  2. คลิกแท็บผู้ดูแลระบบ
  3. ตรวจสอบว่าเปิดใช้การเข้าถึง API แล้ว

4. กำหนดค่าและใช้ไลบรารีของไคลเอ็นต์

โปรดปฏิบัติตามคู่มือที่เหมาะสมด้านล่างเพื่อใช้ข้อมูลเข้าสู่ระบบในไลบรารีของไคลเอ็นต์

หากเลือกไม่ใช้ไลบรารีไคลเอ็นต์ของเรา คุณจะต้องใช้ขั้นตอนบัญชีบริการหรือเว็บแอป 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