Penyiapan OAuth

Semua panggilan Google AdMob API harus diizinkan 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

Menentukan jenis autentikasi Anda

Periksa tabel di bawah 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 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.

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 tersebut dan mengaktifkan AdMob API secara otomatis.

Mengaktifkan API untuk project yang sudah 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. Buka API Library di Konsol API Google.
  2. Jika diminta, pilih project, atau buat project baru. Library API 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 dalam kelompok produk yang terkait.
  4. Pilih API yang ingin Anda aktifkan, lalu klik tombol Aktifkan.
  5. Jika diminta, aktifkan penagihan.
  6. Jika diminta, baca dan setujui Persyaratan Layanan API.

Membuat kredensial OAuth2

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

  1. Buka halaman Klien.

  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 untuk 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 Anda download dalam format JSON dan simpan untuk digunakan nanti.

Buat permintaan

AdMob API dibangun di HTTP dan JSON, sehingga 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 tersedia dalam sejumlah bahasa pemrograman. Dengan menggunakannya, Anda tidak perlu lagi menyiapkan permintaan HTTP dan mengurai respons secara manual.

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. Hal 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 dan penghasilan iklan. 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 bersama

Anda dapat mencabut token bersama dengan dua cara:

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

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