Mulai menggunakan AdMob API

Penting: Peran dan izin pengguna baru akan memengaruhi data yang ditampilkan oleh AdMob API. Pelajari lebih lanjut

Panduan ini ditujukan bagi developer yang ingin menggunakan AdMob API untuk mendapatkan data secara terprogram di akun AdMob mereka.

Semua panggilan Google AdMob API harus diotorisasi melalui OAuth2 agar aplikasi Anda dapat berinteraksi dengan layanan web atas nama pengguna. OAuth2 memungkinkan aplikasi klien AdMob API Anda mengakses akun AdMob pengguna tanpa harus menangani atau menyimpan nama pengguna atau sandi pengguna. Untuk ringkasan otorisasi, lihat Otorisasi.

Lakukan langkah-langkah berikut untuk membuat kredensial OAuth2 dan membuat permintaan pertama Anda.

Prasyarat

• Akun Google.

• Akun Google AdMob.

• Pemahaman tentang dasar-dasar REST dan mengizinkan permintaan dengan OAuth 2.0.

Menentukan jenis autentikasi

Periksa tabel di bawah untuk melihat jenis autentikasi yang paling sesuai untuk aplikasi Anda:

Memilih jenis autentikasi OAuth2	Jika ...
Aplikasi desktop	Anda mengelola semua akun AdMob API menggunakan satu akun pengelola tingkat atas. Anda adalah pengguna pertama kali, atau ingin memulai dengan cepat dengan penyiapan yang paling sederhana. Aplikasi Anda hanya mengautentikasi pengguna Google AdMob dari satu mesin.
Aplikasi web	Anda ingin melakukan autentikasi sebagai pengguna yang dapat memberikan izin ke aplikasi Anda untuk mengakses data akun AdMob API-nya. Anda ingin membuat beberapa kredensial otorisasi dengan mudah, misalnya untuk mengelola akun pihak ketiga. Aplikasi Anda memerlukan URL callback. URL callback tidak didukung dalam alur aplikasi desktop.

Poin Penting: Anda masih dapat memilih alur aplikasi desktop meskipun sedang mengembangkan aplikasi untuk dijalankan di server. Perbedaannya adalah apakah otorisasi OAuth selesai secara lokal atau jarak jauh. Alur desktop memerlukan otorisasi untuk selesai di komputer lokal, sedangkan alur web memungkinkan otorisasi selesai di server otorisasi Google.

Membuat project

Untuk mulai menggunakan AdMob API, Anda harus membuat atau memilih project di Konsol Google API terlebih dahulu dan mengaktifkan API menggunakan alat penyiapan, yang memandu Anda menjalankan prosesnya dan mengaktifkan AdMob API secara otomatis.

Mengaktifkan API untuk project yang ada

Langkah-langkah berikut berlaku untuk pengguna yang memiliki project yang sudah ada dan lebih memilih untuk mengaktifkan AdMob API secara manual.

Untuk mengaktifkan API untuk proyek Anda:

1. Open the API Library di Google API Console .
2. If prompted, select a project, or create a new one. The API Library daftar semua API yang tersedia, dikelompokkan berdasarkan keluarga produk dan popularitas.
3. Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan pencarian untuk menemukannya, atau klik Lihat Semua dalam keluarga produk yang dimilikinya.
4. Pilih API yang ingin Anda aktifkan, lalu klik tombol Aktifkan .
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

Membuat kredensial OAuth2

Petunjuk berikut akan memandu Anda melalui proses pembuatan client ID OAuth 2.0 untuk digunakan dengan alur aplikasi yang diinstal.

1. Go to the Credentials page.

2. Klik CREATE CREDENTIALS > OAuth client ID.

   Jika belum mengonfigurasi layar izin OAuth untuk project ini sebelumnya, Anda akan diarahkan untuk melakukannya sekarang. Klik CONFIGURE CONSENT SCREEN. Ada beberapa cara untuk mengonfigurasi layar izin agar dapat menggunakan client ID OAuth 2.0 Anda.

   1. Tetapkan jenis pengguna ke Eksternal dan status publikasi ke Dipublikasikan.

   2. Atau, tetapkan jenis pengguna ke Eksternal dan status publikasi ke Pengujian, lalu tambahkan Pengguna pengujian dengan memilih tambahkan pengguna untuk memberi mereka akses guna menggunakan client ID OAuth 2.0 Anda.

      Lihat informasi tambahan tentang menyiapkan layar izin OAuth.

3. Pilih Aplikasi desktop atau Aplikasi Web sebagai jenis aplikasi, beri nama, lalu klik Buat.

Setelah selesai, Anda akan melihat client ID dan secret klien OAuth 2.0, yang dapat didownload dalam format JSON dan disimpan untuk digunakan nanti.

Buat permintaan

AdMob API dibuat berdasarkan HTTP dan JSON, sehingga semua klien HTTP standar dapat mengirim permintaan ke API ini dan mengurai responsnya. Namun, library klien Google API menyediakan integrasi bahasa yang lebih baik, keamanan yang lebih tinggi, dan dukungan untuk membuat permintaan yang diotorisasi. Library klien ini tersedia dalam sejumlah bahasa pemrograman. Dengan menggunakannya, Anda tidak perlu lagi menyiapkan permintaan HTTP dan mengurai respons secara manual.

Catatan: Saat pertama kali mengaktifkan alur OAuth, Anda akan diminta untuk memberikan ID penayang AdMob dan menyetujui permintaan otorisasi di browser. Sebelum menerima, pastikan Anda login dengan Akun Google yang memiliki akses ke akun AdMob Anda. Kemudian, aplikasi Anda akan diberi otorisasi untuk mengakses data atas nama akun yang saat ini login.

Setelah kredensial OAuth 2.0 dibuat, Anda siap untuk mulai menggunakan AdMob API. Untuk meminta akses menggunakan OAuth 2.0, aplikasi Anda juga memerlukan informasi cakupan:

Cakupan	Arti
https://www.googleapis.com/auth/admob.readonly	Melihat semua data AdMob. Data ini dapat mencakup informasi akun, setelan inventaris dan mediasi, laporan, dan data lainnya. Data ini tidak mencakup data sensitif, seperti pembayaran atau detail kampanye.
https://www.googleapis.com/auth/admob.report	Melihat laporan performa iklan dan penghasilan. Melihat ID penayang, zona waktu, dan kode mata uang default.

Buat permintaan pertama Anda untuk membuat laporan menggunakan contoh di Java, PHP, Python, atau curl.

Mencabut token bersama

Anda dapat mencabut token bersama dengan dua cara:

1. Buka halaman izin Akun Google dan cabut akses dari project yang relevan.

2. Atau, Anda dapat mencabut token aplikasi web menggunakan Google Identity API.