Panduan ini akan menuntun Anda menyiapkan OAuth2 untuk akses API menggunakan kredensial Anda sendiri 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 tempat Anda ingin melakukan panggilan API dalam satu akun pengelola Google Ads.
Gunakan contoh
GenerateUserCredentials
untuk membuat kredensial OAuth2 bagi pengguna yang memiliki akses ke akun pengelola.Gunakan kredensial OAuth2 untuk melakukan panggilan ke semua akun yang perlu Anda kelola menggunakan Google Ads API.
Langkah-langkah ini hanya perlu dilakukan sekali, kecuali jika Anda mencabut, menghapus, atau perlu mengubah cakupan yang diizinkan untuk kredensial OAuth2 Anda.
Langkah 1 - Buat kredensial OAuth2
Ikuti langkah-langkah untuk mengonfigurasi project Konsol API Google untuk Google Ads API.
Catat client ID dan rahasia, lalu kembali ke halaman ini.
Langkah 2 - Menyiapkan library klien
Di terminal, jalankan contoh
GenerateUserCredentials
, yang meminta Anda memasukkan client ID dan rahasia OAuth2.Ini adalah contoh interaktif, yang mengharuskan Anda untuk memberikan input.
dotnet run GenerateUserCredentials.csproj
Contoh ini meminta Anda memberikan client ID dan rahasia OAuth2. Berikan detail dari langkah 1.
Contoh ini akan membuka URL secara otomatis di browser. Jika Anda belum login ke sesi browser, halaman web akan meminta Anda login ke Akun Google. Jika Anda sudah login, permintaan tersebut akan melewati permintaan login dan mengalihkan Anda ke URL yang mengharuskan Anda mengizinkan aplikasi untuk mengakses akun Google Ads atas nama Anda.
Anda kemudian akan diarahkan ke halaman yang menampilkan pesan yang menunjukkan bahwa otorisasi berhasil.
Token refresh Anda telah diambil. Periksa output konsol untuk mengetahui petunjuk lebih lanjut.
Kembali ke konsol tempat Anda menjalankan contoh. Contoh seharusnya sudah selesai dan menampilkan token refresh Anda dan beberapa petunjuk, diikuti dengan properti yang Anda perlukan untuk mengonfigurasi library klien:
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 tidak mengetahui akun Google Ads yang akan menerima panggilan API sebelumnya, Anda dapat
menemukannya saat runtime menggunakan kredensial pengguna yang login untuk
sesi tersebut. Lihat
AuthenticateInAspNetCoreApplication
untuk mengetahui contoh pengguna yang saat ini login diautentikasi dan kredensial OAuth2
diperoleh saat runtime.