Memulai AdMob API

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

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 mengakses akun AdMob pengguna tanpa harus menangani atau menyimpan nama pengguna atau sandi pengguna. Untuk ringkasan tentang otorisasi, lihat Otorisasi.

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

Prasyarat

Menentukan jenis autentikasi

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

Pilih jenis autentikasi OAuth2 Anda Jika ...
Aplikasi desktop
  • Anda mengelola semua akun AdMob API menggunakan satu akun pengelola tingkat teratas.
  • Anda adalah pengguna pemula, atau ingin langsung memulai dengan penyiapan paling sederhana.
  • Aplikasi Anda hanya mengautentikasi pengguna Google AdMob dari satu komputer.
Aplikasi web
  • Anda ingin melakukan autentikasi sebagai pengguna yang dapat memberikan izin ke aplikasi Anda untuk mengakses data akun AdMob API mereka.
  • 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.

Membuat project

Untuk mulai menggunakan AdMob API, pertama-tama Anda harus membuat atau memilih project di Konsol API Google dan mengaktifkan API menggunakan alat penyiapan, yang akan memandu Anda melalui proses ini dan mengaktifkan AdMob API secara otomatis.

Mengaktifkan API untuk project yang sudah ada

Langkah-langkah berikut berlaku bagi pengguna yang sudah memiliki project 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 menjalani proses pembuatan client ID OAuth 2.0 untuk digunakan dengan alur aplikasi yang diinstal.

  1. Go to the Credentials page.
  2. Klik BUAT KREDENSIAL > client ID OAuth.

    Jika Anda belum mengonfigurasi layar izin OAuth untuk project ini sebelumnya, Anda akan diarahkan untuk melakukannya sekarang. Klik KONFIGURASI LAYAR LAYAR. Ada beberapa cara untuk mengonfigurasi layar izin Anda 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 uji coba dengan memilih tambahkan pengguna untuk memberi mereka akses menggunakan client ID OAuth 2.0 Anda.

      Lihat informasi tambahan tentang menyiapkan layar izin OAuth.

  3. Pilih Desktop app atau Web Application sebagai jenis aplikasi, beri nama, lalu klik Create.

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

Buat permintaan

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

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 Lihat semua data AdMob. Data ini dapat mencakup informasi akun, setelan inventaris dan mediasi, laporan, serta data lainnya. Data ini tidak mencakup data sensitif, seperti pembayaran atau detail kampanye.
https://www.googleapis.com/auth/admob.report Lihat laporan performa iklan dan penghasilan. Lihat 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 yang dibagikan

Anda dapat mencabut token bersama dengan dua cara:

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

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