Alur Aplikasi Web dan Desktop OAuth

Panduan ini membahas cara menyiapkan OAuth2 untuk akses API menggunakan kredensial Anda sendiri dan instance desktop flow atau web alur. Langkah-langkah ini hanya perlu dilakukan sekali, kecuali jika Anda mencabut, menghapus, atau perlu mengubah cakupan kredensial OAuth2{i> <i}yang Anda miliki.

Membuat kredensial OAuth2

  1. Ikuti langkah-langkah untuk mengonfigurasi project Konsol API Google untuk API Google Ads.

  2. Download file JSON klien dengan mengklik Download OAuth terlebih dahulu klien, lalu tombol DOWNLOAD JSON di layar berikutnya.

    Simpan file ke direktori utama sehingga Anda sekarang memiliki file lokal ~/client_secret_XXX.apps.googleusercontent.com.json (XXX adalah nilai spesifik untuk proyek Anda). Kita akan menggunakan {i>file<i} ini di langkah berikutnya untuk menjalankan contoh kode.

Menyiapkan library klien

  1. Di terminal, jalankan GenerateUserCredentials contoh. Gunakan flag command line untuk meneruskan file JSON yang Anda download ke file tersebut ke langkah sebelumnya.

    Untuk menjalankan dari command line menggunakan Gradle

    ./gradlew --console=plain --quiet runExample \
  --example="authentication.GenerateUserCredentials \
  --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"

  2. Contoh tersebut akan meminta Anda mengunjungi URL tempat Anda perlu mengizinkan Kredensial OAuth2 untuk mengakses akun Google Ads atas nama Anda.

    Paste this URL in your browser:
https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...

    Buka URL di sesi browser pribadi atau jendela samaran. Login dengan Akun Google yang sama dengan yang Anda gunakan untuk mengakses Google Ads. Klik Lanjutkan di layar izin OAuth2.

    Layar persetujuan

  3. Anda akan diarahkan ke halaman dengan pesan yang menunjukkan bahwa otorisasi berhasil.

    Kode otorisasi berhasil diambil.

    Periksa output konsol dari GenerateUserCredentials untuk mendapatkan petunjuk lebih lanjut.

  4. Kembali ke konsol tempat Anda menjalankan contoh. Anda akan melihat bahwa selesai dan menampilkan token refresh dan beberapa petunjuk khusus, diikuti dengan properti yang harus Anda konfigurasi library klien:

    #Mon Apr 18 09:07:51 EDT 2022
api.googleads.refreshToken=1/Yw.........................................
api.googleads.clientId=...........-...............apps.googleusercontent.com
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.clientSecret=........................

  5. Salin baris dari komentar tanggal # ke akhir output ke File ads.properties.

    Ganti INSERT_DEVELOPER_TOKEN_HERE dengan token developer Anda.

    Untuk penyiapan termudah, tempatkan file ads.properties di rumah Anda saat ini.