Panduan ini membahas cara menyiapkan OAuth2 untuk akses API menggunakan kredensial, dan alur desktop atau alur web.
Membuat kredensial OAuth2 untuk satu akun
Cara termudah untuk melakukan panggilan ke akun Google Ads API adalah dengan
Tautkan semua akun yang ingin Anda gunakan untuk melakukan panggilan API di satu akun akun pengelola Google Ads.
Menggunakan
GenerateUserCredentials
contoh untuk membuat kredensial OAuth2 bagi pengguna yang memiliki akses ke akun pengelola menggunakan akun layanan.Gunakan kredensial OAuth2 untuk melakukan panggilan ke semua akun yang Anda perlukan mengelola menggunakan Google Ads API.
Langkah-langkah ini hanya perlu dilakukan sekali, kecuali jika Anda mencabut, menghapus, atau harus mengubah cakupan yang diizinkan untuk kredensial OAuth2 Anda.
Langkah 1 - Buat kredensial OAuth2
Ikuti langkah-langkah untuk mengonfigurasi project Konsol API Google untuk API Google Ads.
Catat client ID dan rahasia, lalu kembali ke halaman ini.
Langkah 2 - Menyiapkan library klien
Di terminal, jalankan
GenerateUserCredentials
misalnya, yang meminta ID klien dan rahasia OAuth2 Anda.Ini adalah contoh interaktif, yang mengharuskan Anda memberikan input.
dotnet run GenerateUserCredentials.csproj
Contoh ini meminta Anda untuk memberikan client ID dan rahasia OAuth2. Berikan detail dari langkah 1.
Contoh ini membuka URL secara otomatis di browser. Jika Anda belum masuk masuk ke sesi browser Anda, laman web akan meminta Anda untuk masuk ke Akun Google. Jika Anda sudah login, proses login akan dilewati dan mengalihkan Anda ke URL tempat Anda diminta untuk melakukan otorisasi aplikasi untuk mengakses akun Google Ads atas nama Anda.
Anda kemudian akan diarahkan ke halaman dengan pesan yang menunjukkan bahwa otorisasi berhasil.
Token refresh telah diambil. Periksa output konsol untuk mengetahui informasi selengkapnya petunjuk.
Kembali ke konsol tempat Anda menjalankan contoh. Contoh seharusnya telah selesai dan menampilkan token refresh dan beberapa petunjuk, diikuti dengan properti yang harus Anda konfigurasi library kliennya:
Copy the following content into your App.config file. <add key = 'OAuth2Mode' value = 'APPLICATION' /> <add key = 'OAuth2ClientId' value = '******' /> <add key = 'OAuth2ClientSecret' value = '******' /> <add key = 'OAuth2RefreshToken' value = '******' /> Make sure you also set the LOGIN_CUSTOMER_ID header. See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings to learn more. <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' /> See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration for alternate configuration options.
Membuat kredensial OAuth2 untuk aplikasi interaktif
Jika Anda tidak mengetahui akun Google Ads yang akan digunakan untuk melakukan panggilan API terlebih dahulu, Anda dapat
menemukannya saat runtime menggunakan
kredensial pengguna yang masuk untuk
sesi. Lihat
AuthenticateInAspNetCoreApplication
misalnya pengguna yang saat ini masuk
diotentikasi dan OAuth2
kredensial yang diperoleh saat runtime.