เริ่มต้นใช้งาน 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. API Library แสดงรายการ API ทั้งหมดที่พร้อมใช้งาน โดยจัดกลุ่มตามตระกูลผลิตภัณฑ์ และความนิยม
  3. หากไม่เห็น API ที่ต้องการเปิดใช้ในรายการ ให้ใช้การค้นหาเพื่อค้นหา หรือคลิกดูทั้งหมดในกลุ่มผลิตภัณฑ์ที่ 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 ก็ได้