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

สำคัญ: บทบาทและสิทธิ์ใหม่ของผู้ใช้จะส่งผลต่อข้อมูลที่ AdMob API แสดง ดูข้อมูลเพิ่มเติม

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

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

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

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

• บัญชี Google

• บัญชี Google AdMob

• ทำความคุ้นเคยกับข้อมูลเบื้องต้นเกี่ยวกับ REST และการให้สิทธิ์คำขอด้วย OAuth 2.0

ระบุประเภทการตรวจสอบสิทธิ์

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

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

ประเด็นสำคัญ: คุณยังคงเลือกขั้นตอนของแอปเดสก์ท็อปได้แม้ว่าจะพัฒนาแอปให้ทำงานบนเซิร์ฟเวอร์ก็ตาม ความแตกต่างคือการให้สิทธิ์ OAuth เสร็จสมบูรณ์ในเครื่องหรือจากระยะไกล ขั้นตอนการดำเนินการบนเดสก์ท็อปกำหนดให้ต้องให้สิทธิ์ในเครื่องคอมพิวเตอร์เครื่องนั้นๆ ให้เสร็จสมบูรณ์ ส่วนขั้นตอนการดำเนินการบนเว็บจะอนุญาตให้ให้สิทธิ์ในเซิร์ฟเวอร์การให้สิทธิ์ของ Google ให้เสร็จสมบูรณ์

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

หากต้องการเริ่มต้นใช้งาน 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 ระบบจะขอให้คุณระบุรหัสผู้เผยแพร่โฆษณา AdMob และยอมรับข้อความแจ้งการให้สิทธิ์ในเบราว์เซอร์ ก่อนยอมรับ โปรดตรวจสอบว่าคุณลงชื่อเข้าใช้ด้วยบัญชี Google ที่มีสิทธิ์เข้าถึงบัญชี AdMob จากนั้นแอปจะได้รับสิทธิ์เข้าถึงข้อมูลในนามของบัญชีที่เข้าสู่ระบบอยู่

เมื่อสร้างข้อมูลเข้าสู่ระบบ 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 ก็ได้