Panduan ini akan memandu Anda menyiapkan OAuth 2.0 untuk akses API menggunakan kredensial Anda sendiri dan alur desktop atau alur web. Langkah-langkah ini hanya perlu dilakukan sekali, kecuali jika Anda mencabut, menghapus, atau perlu mengubah cakupan yang diizinkan untuk kredensial OAuth 2.0 Anda.
Membuat kredensial OAuth 2.0
Ikuti langkah-langkah untuk mengonfigurasi project Konsol API Google untuk Google Ads API.
Catat client ID dan rahasia klien, lalu kembali ke halaman ini.
Menyiapkan library klien
-
Di terminal, jalankan contoh
GenerateUserCredentials
. Masukkan client ID dan rahasia klien OAuth 2.0 saat diminta.dotnet run GenerateUserCredentials.csproj
Contoh kode ini akan membuka URL secara otomatis di browser. Jika Anda tidak login ke sesi browser, halaman web akan meminta Anda untuk login ke Akun Google Anda. Jika Anda sudah login, aplikasi ini akan melewati perintah login dan mengalihkan Anda ke URL tempat Anda harus memberi otorisasi kepada aplikasi untuk mengakses akun Google Ads atas nama Anda.
Login dengan Akun Google yang Anda gunakan untuk mengakses Google Ads. Biasanya, ini adalah email login ke akun pengelola Google Ads yang berisi semua akun yang perlu Anda kelola dalam hierarki akunnya. Klik Lanjutkan di layar izin OAuth 2.0.
Anda akan diarahkan ke halaman dengan pesan yang menunjukkan bahwa otorisasi berhasil.
Your refresh token has been fetched. Check the console output for further instructions.
Kembali ke konsol tempat Anda menjalankan contoh kode. Anda akan melihat bahwa contoh kode telah selesai dan menampilkan token refresh dan beberapa petunjuk, diikuti dengan petunjuk yang harus Anda ikuti 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 = '******' />Pastikan Anda juga menetapkan header
LOGIN_CUSTOMER_ID
dalam fileApp.config
. Lihat panduan konfigurasi untuk mempelajari lebih lanjut.<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
Lihat panduan konfigurasi untuk opsi konfigurasi alternatif.
Membuat kredensial OAuth2 untuk aplikasi interaktif
Jika tidak mengetahui akun Google Ads yang akan digunakan untuk melakukan panggilan API sebelumnya, Anda dapat menemukannya saat runtime menggunakan kredensial pengguna yang login untuk sesi tersebut. Lihat
AuthenticateInAspNetCoreApplication
untuk mengetahui contoh saat pengguna yang saat ini login diautentikasi dan kredensial OAuth2 diperoleh saat runtime.