Alur Aplikasi Web dan Desktop OAuth

Panduan ini membahas cara menyiapkan OAuth2 untuk akses API menggunakan kredensial Anda sendiri dan alur desktop atau alur web. Langkah-langkah ini hanya perlu dilakukan satu kali, kecuali jika Anda mencabut, menghapus, atau perlu mengubah cakupan yang diizinkan untuk kredensial OAuth2 Anda.

Membuat kredensial OAuth2

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

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

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

Menyiapkan library klien

  1. Di terminal, jalankan contoh GenerateUserCredentials. Gunakan tanda command line untuk meneruskan file JSON yang Anda download di 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 ini akan meminta Anda mengunjungi URL yang mengharuskan Anda 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 Continue di layar izin OAuth2.

    Layar persetujuan

  3. Anda akan diarahkan ke halaman dengan pesan yang menunjukkan bahwa otorisasi telah 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 contoh telah selesai dan menampilkan token refresh dan beberapa petunjuk, diikuti dengan properti yang Anda perlukan untuk mengonfigurasi 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 # hingga akhir output ke file ads.properties Anda.

    Ganti INSERT_DEVELOPER_TOKEN_HERE dengan token developer Anda.

    Untuk penyiapan paling mudah, tempatkan file ads.properties di direktori utama Anda.