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 dan mengelola 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 Anda

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

Memilih jenis autentikasi OAuth2 Anda	Jika ...
Aplikasi desktop	Anda mengelola semua akun AdMob API menggunakan satu akun pengelola tingkat teratas. Anda adalah pengguna baru, atau ingin memulai dengan cepat menggunakan 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 kepada aplikasi Anda untuk mengakses data akun AdMob API miliknya. 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 tetap dapat memilih alur aplikasi desktop meskipun Anda mengembangkan aplikasi untuk dijalankan di server. Perbedaannya adalah apakah otorisasi OAuth diselesaikan secara lokal atau dari jarak jauh. Alur desktop memerlukan otorisasi untuk diselesaikan di komputer lokal, sedangkan alur web memungkinkan otorisasi diselesaikan di server otorisasi Google.

Membuat project

Untuk mulai menggunakan AdMob API, pertama-tama Anda harus membuat atau memilih project di Konsol Google API 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 project Anda:

1. Open the API Library di Google API Console.
2. If prompted, select a project, or create a new one. API Library mencantumkan semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
3. Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan penelusuran untuk menemukannya, atau klik Lihat Semua di kelompok produk tempat API tersebut berada.
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 ID klien OAuth 2.0 untuk digunakan dengan alur aplikasi yang diinstal.

1. Go to the Credentials page.

2. Klik CREATE CREDENTIALS > OAuth client ID.

   Jika sebelumnya Anda belum mengonfigurasi layar izin OAuth untuk project ini, Anda akan diarahkan untuk melakukannya sekarang. Klik KONFIGURASIKAN LAYAR IZIN. Ada beberapa cara untuk mengonfigurasi layar izin Anda agar menggunakan ID klien OAuth 2.0 Anda.

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

   2. Atau, tetapkan jenis pengguna Anda ke Eksternal dan status publikasi ke Pengujian, lalu tambahkan Pengguna pengujian dengan memilih tambahkan pengguna untuk memberi mereka akses menggunakan ID klien 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 rahasia 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 setiap 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 sah. Library klien ini tersedia dalam sejumlah bahasa pemrograman. Dengan menggunakannya, Anda tidak perlu lagi menyetel permintaan HTTP dan mengurai respons secara manual.

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

Setelah kredensial OAuth 2.0 dibuat, Anda siap 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 Anda dan cabut akses dari project yang relevan.

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