Penyiapan OAuth

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

• Akun Google.

• Akun Google AdMob.

• Memahami dasar-dasar REST dan mengotorisasi permintaan dengan OAuth 2.0.

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.

Poin Penting: Anda masih dapat memilih alur aplikasi desktop meskipun sedang mengembangkan aplikasi untuk dijalankan di server. Perbedaannya adalah apakah otorisasi OAuth diselesaikan secara lokal atau 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 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.

Catatan: Saat pertama kali mengaktifkan alur OAuth, Anda akan diminta untuk memberikan ID penayang AdMob dan menyetujui permintaan otorisasi di browser. Sebelum menyetujuinya, pastikan Anda login dengan Akun Google yang memiliki akses ke akun AdMob Anda. Aplikasi Anda kemudian diberi otorisasi untuk mengakses data atas nama akun mana pun 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	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.