คู่มือนี้มีไว้สําหรับนักพัฒนาแอปที่ต้องการใช้ AdMob API เพื่อรับ ข้อมูลในบัญชี AdMob โดยใช้โปรแกรม
การเรียกใช้ Google AdMob API ทั้งหมดต้องได้รับสิทธิ์ผ่าน OAuth2 เพื่อให้แอปโต้ตอบกับบริการเว็บในนามของผู้ใช้ได้ OAuth2 ช่วยให้แอปไคลเอ็นต์ AdMob API เข้าถึงบัญชี AdMob ของผู้ใช้ได้โดยไม่ต้องจัดการหรือจัดเก็บชื่อผู้ใช้หรือรหัสผ่านของผู้ใช้ ดูภาพรวมเกี่ยวกับการให้สิทธิ์ได้ที่หัวข้อการให้สิทธิ์
ทําตามขั้นตอนต่อไปนี้เพื่อสร้างข้อมูลเข้าสู่ระบบ OAuth2 และส่งคําขอแรก
ข้อกำหนดเบื้องต้น
ทำความคุ้นเคยกับข้อมูลเบื้องต้นเกี่ยวกับ REST และการให้สิทธิ์คำขอด้วย OAuth 2.0
ระบุประเภทการตรวจสอบสิทธิ์
ดูตารางด้านล่างเพื่อดูว่าประเภทการตรวจสอบสิทธิ์ใดเหมาะกับแอปของคุณมากที่สุด
| เลือกประเภทการตรวจสอบสิทธิ์ OAuth2 | หาก ... |
|---|---|
| แอปบนเดสก์ท็อป |
|
| เว็บแอป |
|
สร้างโปรเจ็กต์
หากต้องการเริ่มต้นใช้งาน AdMob API ก่อนอื่นคุณต้องสร้างหรือเลือกโปรเจ็กต์ในคอนโซล Google API และเปิดใช้ API โดยใช้เครื่องมือการตั้งค่า ซึ่งจะแนะนําคุณตลอดกระบวนการและเปิดใช้งาน AdMob API โดยอัตโนมัติ
การเปิดใช้ API สำหรับโปรเจ็กต์ที่มีอยู่
ขั้นตอนต่อไปนี้มีไว้สําหรับผู้ใช้ที่มีโปรเจ็กต์อยู่แล้วและต้องการเปิดใช้งาน AdMob API ด้วยตนเอง
To enable an API for your project:
- Open the API Library in the Google API Console.
- If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
- If the API you want to enable isn't visible in the list, use search to find it, or click View All in the product family it belongs to.
- Select the API you want to enable, then click the Enable button.
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
สร้างข้อมูลเข้าสู่ระบบ OAuth2
วิธีการต่อไปนี้จะช่วยแนะนำขั้นตอนการสร้างรหัสไคลเอ็นต์ OAuth 2.0 เพื่อใช้กับขั้นตอนสำหรับแอปที่ติดตั้ง
- Go to the Credentials page.
คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
หากก่อนหน้านี้คุณยังไม่ได้กําหนดค่าหน้าจอคํายินยอม OAuth สําหรับโปรเจ็กต์นี้ ระบบจะนําคุณไปยังส่วนดังกล่าว คลิกกำหนดค่าหน้าจอขอความยินยอม คุณสามารถกำหนดค่าหน้าจอคำยินยอมให้ใช้รหัสไคลเอ็นต์ OAuth 2.0 ได้หลายวิธี
- ตั้งค่าประเภทผู้ใช้เป็นภายนอกและสถานะการเผยแพร่เป็นเผยแพร่แล้ว
หรือตั้งค่าประเภทผู้ใช้เป็นภายนอกและสถานะการเผยแพร่เป็นการทดสอบ จากนั้นเพิ่มผู้ใช้ทดสอบโดยเลือกเพิ่มผู้ใช้เพื่อให้สิทธิ์เข้าถึงรหัสไคลเอ็นต์ OAuth 2.0
ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าหน้าจอขอความยินยอม OAuth
เลือกแอปเดสก์ท็อปหรือเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน ตั้งชื่อแอป แล้วคลิกสร้าง
เมื่อดำเนินการเสร็จแล้ว คุณจะเห็นรหัสไคลเอ็นต์ 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 วิธี ดังนี้
ไปที่หน้าสิทธิ์ของบัญชี Google แล้วยกเลิกสิทธิ์เข้าถึงจากโปรเจ็กต์ที่เกี่ยวข้อง
หรือจะเพิกถอนโทเค็นเว็บแอปพลิเคชันโดยใช้ Google Identity API ก็ได้