Bagian ini ditujukan bagi pengguna tingkat lanjut 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 yang disebut 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
Aplikasi klien Google Ads API biasanya meminta akses offline. Misalnya, aplikasi Anda mungkin ingin menjalankan tugas batch saat pengguna Anda tidak sedang online secara fisik menjelajahi situs Anda.
Untuk meminta akses offline untuk jenis aplikasi web, pastikan Anda menyetel 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 dalam setiap permintaan. Anda dapat mengikat
Credential ke Channel untuk digunakan pada semua permintaan di saluran 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}" \