Daftar sekarang untuk mengikuti workshop Performa Maksimal dan Google Ads API yang akan diselenggarakan pada 17 Juli.

Halaman ini diterjemahkan oleh Cloud Translation API.

Alur Aplikasi Web dan Desktop OAuth

Panduan ini akan memandu 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 yang ingin Anda gunakan untuk 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 klien OAuth2 Anda.

Ini adalah contoh interaktif, yang mengharuskan Anda untuk 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 tidak login ke sesi browser, halaman web akan meminta Anda login ke Akun Google. Jika sudah login, permintaan login akan dilewati dan Anda akan dialihkan ke URL yang meminta Anda memberikan otorisasi kepada aplikasi untuk mengakses akun Google Ads atas nama Anda.

Catatan: Login dengan Akun Google yang sama dengan 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 berdasarkan hierarki akunnya.
Selanjutnya, Anda akan diarahkan ke halaman dengan pesan yang menunjukkan bahwa otorisasi berhasil.

Token refresh telah diambil. Periksa output konsol untuk petunjuk lebih lanjut.

Kembali ke konsol tempat Anda menjalankan contoh. Contoh ini seharusnya sudah selesai dan menampilkan token refresh dan beberapa petunjuk, yang 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 Anda tidak mengetahui akun Google Ads yang akan digunakan untuk melakukan panggilan API terlebih dahulu, Anda dapat menemukannya saat runtime menggunakan kredensial pengguna yang login untuk sesi. Lihat AuthenticateInAspNetCoreApplication untuk mengetahui contoh jika pengguna yang saat ini login diautentikasi dan kredensial OAuth2 diperoleh saat runtime.