ให้สิทธิ์คำขอ

เมื่อแอปพลิเคชันขอข้อมูลส่วนตัว คำขอจะต้องได้รับอนุญาตจากผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งมีสิทธิ์เข้าถึงข้อมูลดังกล่าว

ทุกคำขอที่แอปพลิเคชันส่งไปยัง Display & Video 360 API ต้องมีโทเค็นการให้สิทธิ์ โทเค็นดังกล่าวจะระบุตัวตนแอปพลิเคชันของคุณให้ Google ทราบด้วย

เกี่ยวกับโปรโตคอลการให้สิทธิ์

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

การให้สิทธิ์คำขอด้วย OAuth 2.0

คำขอทั้งหมดที่ส่งไปยัง API ของ Display & Video 360 ต้องได้รับอนุญาตจากผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

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

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

บางกระบวนการจะมีขั้นตอนเพิ่มเติม เช่น การใช้โทเค็นการรีเฟรชเพื่อขอโทเค็นเพื่อการเข้าถึงใหม่ ดูข้อมูลอย่างละเอียดเกี่ยวกับกระบวนการของแอปพลิเคชันประเภทต่างๆ ได้ที่เอกสารประกอบเกี่ยวกับ OAuth 2.0 ของ Google

ข้อมูลขอบเขตของ OAuth 2.0 สำหรับ API ของ Display & Video 360 มีดังนี้

ขอบเขต	ความหมาย
https://www.googleapis.com/auth/display-video	สิทธิ์การอ่าน/เขียน
https://www.googleapis.com/auth/display-video-user-management	สิทธิ์การอ่าน/เขียนบริการ users ใช้ได้เฉพาะกับผู้ใช้บัญชีบริการเท่านั้น

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

เคล็ดลับ: ไลบรารีของไคลเอ็นต์ Google APIs จัดการขั้นตอนการให้สิทธิ์บางส่วนให้คุณได้ ไลบรารีเหล่านี้พร้อมให้บริการเป็นภาษาโปรแกรมต่างๆ โปรดดูรายละเอียดเพิ่มเติมที่หน้าที่มีไลบรารีและตัวอย่าง

สิทธิ์ของผู้ใช้

บัญชี Google ที่ตรวจสอบสิทธิ์ต้องเป็นผู้ใช้ Display & Video 360 ที่มีสิทธิ์เข้าถึงพาร์ทเนอร์หรือผู้ลงโฆษณาที่เกี่ยวข้อง จึงจะใช้ Display & Video 360 API ได้

ผู้ใช้ Display & Video 360 ต้องมีบทบาทของผู้ใช้อย่างใดอย่างหนึ่งต่อไปนี้เพื่อให้พาร์ทเนอร์หรือผู้ลงโฆษณาที่เกี่ยวข้องดำเนินการต่อไปนี้ได้

• อ่านอย่างเดียว: เรียกข้อมูลทรัพยากรโดยใช้การเรียก get หรือ list โดยไม่รวมทรัพยากร user
• มาตรฐาน: เรียกข้อมูล สร้าง และอัปเดตทรัพยากร เรียกข้อมูลทรัพยากร user รายการที่ให้สิทธิ์แก่พาร์ทเนอร์หรือผู้ลงโฆษณาเดียวกัน
• ผู้ดูแลระบบ: เรียกข้อมูล สร้าง และอัปเดตทรัพยากร เรียกข้อมูล สร้าง และให้สิทธิ์เข้าถึงทรัพยากร user แก่พาร์ทเนอร์หรือผู้ลงโฆษณาที่คุณดูแล