Bagian ini ditujukan untuk pengguna lanjutan yang sudah memahami spesifikasi OAuth 2.0 dan mengetahui cara menggunakan OAuth 2.0 dengan Google API.
Cakupan
Satu token akses dapat memberikan berbagai tingkat akses ke beberapa API. Parameter variabel bernama scope mengontrol kumpulan resource dan operasi yang diizinkan oleh token akses. Selama permintaan token akses, aplikasi Anda mengirimkan satu atau beberapa nilai dalam parameter scope.
Cakupan untuk Google Ads API adalah:
https://www.googleapis.com/auth/adwords
Akses offline
Umumnya, aplikasi klien Google Ads API meminta akses offline. Misalnya, aplikasi Anda mungkin ingin menjalankan tugas batch saat pengguna tidak online secara fisik menjelajahi situs Anda.
Untuk meminta akses offline untuk jenis aplikasi web, pastikan Anda menetapkan parameter access_type ke offline. Anda dapat menemukan informasi tambahan di
panduan OAuth2 Google.
Untuk jenis aplikasi desktop, akses offline diaktifkan secara default—Anda tidak perlu memintanya secara eksplisit.
Header permintaan
Header gRPC
Saat menggunakan gRPC API, sertakan token akses di setiap permintaan. Anda dapat mengikat Credential ke Channel untuk digunakan pada semua permintaan di channel tersebut. Anda juga dapat mengirimkan kredensial yang disesuaikan untuk setiap panggilan. Panduan Otorisasi gRPC berisi detail selengkapnya tentang penanganan
otorisasi.
Header REST
Saat menggunakan REST API, teruskan token akses melalui header HTTP Authorization. Contoh permintaan HTTP ditampilkan:
# Returns the resource names of customers directly accessible by the user # authenticating the call. # # Variables: # API_VERSION, # DEVELOPER_TOKEN, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # curl -f --request GET \ "https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \