เริ่มต้นใช้งาน AdMob API

คู่มือนี้มีไว้สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการใช้ AdMob API เพื่อรับข้อมูลเกี่ยวกับบัญชี AdMob แบบเป็นโปรแกรม

การเรียก 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. Open the API Library ใน Google API Console
  2. If prompted, select a project, or create a new one. The API Library แสดงรายการ API ที่มีอยู่ทั้งหมดจัดกลุ่มตามตระกูลผลิตภัณฑ์และความนิยม
  3. หาก API ที่คุณต้องการเปิดใช้งานไม่ปรากฏในรายการให้ใช้การค้นหาเพื่อค้นหาหรือคลิก ดูทั้งหมด ในตระกูลผลิตภัณฑ์ที่เป็นของมัน
  4. เลือก API ที่คุณต้องการเปิดใช้งานจากนั้นคลิกปุ่ม เปิดใช้งาน
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

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

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

  1. Go to the Credentials page.

  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 ก็ได้