การตั้งค่า OAuth

การเรียก Google AdMob API ทั้งหมดต้องได้รับอนุญาตผ่าน OAuth2 เพื่อให้แอปของคุณโต้ตอบกับบริการบนเว็บในนามของผู้ใช้ได้ OAuth2 ช่วยให้แอปไคลเอ็นต์ AdMob API เข้าถึงบัญชี AdMob ของผู้ใช้ได้โดยไม่ต้องจัดการหรือจัดเก็บชื่อผู้ใช้หรือรหัสผ่านของผู้ใช้ ดูภาพรวมของการให้สิทธิ์ได้ที่ การให้สิทธิ์

ทำตามขั้นตอนต่อไปนี้เพื่อสร้างข้อมูลเข้าสู่ระบบ OAuth2 และส่งคำขอแรก

ข้อกำหนดเบื้องต้น

กำหนดประเภทการตรวจสอบสิทธิ์

ดูตารางด้านล่างเพื่อดูว่าประเภทการตรวจสอบสิทธิ์ใดเหมาะสมที่สุด สำหรับแอปของคุณ

เลือกประเภทการตรวจสอบสิทธิ์ OAuth2 หาก ...
แอปบนเดสก์ท็อป
  • คุณจัดการบัญชี AdMob API ทั้งหมดโดยใช้บัญชีดูแลจัดการระดับบนสุดบัญชีเดียว
  • คุณเป็นผู้ใช้ครั้งแรกหรือต้องการเริ่มต้นใช้งานอย่างรวดเร็วด้วยการตั้งค่าที่ง่ายที่สุด
  • แอปของคุณจะตรวจสอบสิทธิ์ผู้ใช้ Google AdMob จากเครื่องเดียวเท่านั้น
เว็บแอป
  • คุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ที่ให้สิทธิ์แก่แอปเพื่อ เข้าถึงข้อมูลบัญชี AdMob API ของตนได้
  • คุณต้องการสร้างข้อมูลเข้าสู่ระบบการให้สิทธิ์หลายรายการได้อย่างง่ายดายเพื่อจัดการ บัญชีของบุคคลที่สาม เช่น
  • แอปของคุณต้องใช้ URL ของการเรียกกลับ แต่โฟลว์ของแอปบนเดสก์ท็อปไม่รองรับ URL ของการเรียกกลับ

สร้างโปรเจ็กต์

หากต้องการเริ่มต้นใช้งาน AdMob API ก่อนอื่นคุณต้องสร้างหรือเลือกโปรเจ็กต์ในคอนโซล Google API และเปิดใช้ API โดยใช้เครื่องมือการตั้งค่า ซึ่งจะนำทางคุณตลอดกระบวนการและเปิดใช้งาน AdMob API โดยอัตโนมัติ

การเปิดใช้ API สำหรับโปรเจ็กต์ที่มีอยู่

ขั้นตอนต่อไปนี้ใช้กับผู้ใช้ที่มีโปรเจ็กต์อยู่แล้วและต้องการ เปิดใช้งาน AdMob API ด้วยตนเอง

วิธีเปิดใช้ API สำหรับโปรเจ็กต์

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

สร้างข้อมูลเข้าสู่ระบบ OAuth2

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

  1. ไปที่หน้าไคลเอ็นต์

  2. คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth

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

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

      ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าหน้าจอขอความยินยอม OAuth

  3. เลือกแอปเดสก์ท็อปหรือเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน ตั้งชื่อ แล้วคลิกสร้าง

เมื่อเสร็จแล้ว คุณจะเห็นรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ OAuth 2.0 ซึ่งคุณสามารถดาวน์โหลดในรูปแบบ JSON และบันทึกไว้ใช้ในภายหลังได้

ส่งคำขอ

AdMob API สร้างขึ้นในรูปแบบ HTTP และ JSON ไคลเอ็นต์ HTTP มาตรฐานต่างๆ จึงส่งคำขอไปยัง API นี้และแยกวิเคราะห์การตอบกลับได้ อย่างไรก็ตาม ไลบรารีของไคลเอ็นต์ Google API มีการผสานรวมภาษาที่ดีกว่า ความปลอดภัยที่ดียิ่งขึ้น และการรองรับการส่งคำขอที่ได้รับอนุญาต ไลบรารีของไคลเอ็นต์พร้อมให้บริการเป็นภาษาโปรแกรมต่างๆ เมื่อใช้งานไลบรารีเหล่านี้ คุณจะไม่ต้องตั้งค่าคำขอ HTTP และแยกวิเคราะห์การตอบกลับด้วยตนเอง

เมื่อสร้างข้อมูลเข้าสู่ระบบ OAuth 2.0 แล้ว คุณก็พร้อมที่จะเริ่มใช้ AdMob API หากต้องการขอสิทธิ์โดยใช้ OAuth 2.0 แอปของคุณต้องมีข้อมูลขอบเขตด้วย

ขอบเขต ความหมาย
https://www.googleapis.com/auth/admob.readonly ดูข้อมูล AdMob ทั้งหมด ซึ่งอาจรวมถึงข้อมูลบัญชี การตั้งค่าพื้นที่โฆษณาและการไกล่เกลี่ย รายงาน และข้อมูลอื่นๆ แต่ไม่รวมข้อมูลที่ละเอียดอ่อน เช่น การชำระเงินหรือรายละเอียดของแคมเปญ
https://www.googleapis.com/auth/admob.report ดูรายงานประสิทธิภาพโฆษณาและรายงานรายได้ ดูรหัสผู้เผยแพร่โฆษณา เขตเวลา และรหัสสกุลเงินเริ่มต้น

ส่งคำขอแรกเพื่อสร้างรายงานโดยใช้ตัวอย่างใน Java PHP Python หรือ curl

เพิกถอนโทเค็นที่แชร์

คุณเพิกถอนโทเค็นที่แชร์ได้ 2 วิธี ดังนี้

  1. ไปที่หน้าสิทธิ์ของบัญชี Google แล้วเพิกถอนสิทธิ์เข้าถึงจาก โปรเจ็กต์ที่เกี่ยวข้อง

  2. หรือคุณจะเพิกถอนโทเค็นของเว็บแอปพลิเคชันโดยใช้ Google Identity API ก็ได้