เริ่มต้นใช้งาน 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 ก็ได้