Alur Kerja Akun Layanan

Panduan ini membahas cara mengakses Google Ads API dengan akun layanan.

Akun layanan adalah akun yang dimiliki oleh aplikasi Anda, bukan oleh pengguna akhir perorangan. Akun layanan menggunakan alur OAuth 2.0 yang tidak memerlukan otorisasi manusia, tetapi menggunakan file kunci yang hanya dapat diakses oleh aplikasi Anda.

Penggunaan akun layanan memberikan dua manfaat utama:

• Otorisasi untuk akses Google Ads API ke akun Google Ads dilakukan sebagai langkah konfigurasi, dengan memanfaatkan fitur otorisasi dan pengelolaan akun yang ditawarkan oleh UI Google Ads. Hal ini menghemat upaya developer karena tidak perlu membuat alur OAuth 2.0 dan menangani komplikasi yang melibatkan interaksi pengguna, menyimpan kredensial pengguna, dll.

• Otorisasi untuk akses ke akun Google Ads tidak terikat pada kredensial pengguna perorangan, yang mungkin berguna jika otorisasi tersebut diharapkan akan terus berlanjut meskipun karyawan yang awalnya mengotorisasi akses tersebut keluar dari tim atau perusahaan.

Penyiapan akses akun

1. Mulailah dengan membuat akun layanan dan kredensial.

   Download kunci akun layanan dalam format JSON dan catat ID serta email akun layanan.

2. Login ke akun Google Ads Anda sebagai administrator. Buka Admin > Akses dan keamanan.

3. Klik tombol + di tab Pengguna.

   

4. Ketik email akun layanan ke dalam kotak input Email. Pilih tingkat akses akun yang sesuai, lalu klik tombol Tambahkan akun.

   

5. Akun layanan akan diberi akses.

   

6. [Opsional] Secara default, Anda tidak dapat memberikan akses administrator ke akun layanan. Jika panggilan API Anda memerlukan akses administrator, Anda dapat mengupgrade aksesnya sebagai berikut.

   • Klik panah drop-down di samping tingkat akses akun layanan di kolom Tingkat akses.
   • Pilih Admin dari daftar drop-down.

Konfigurasi library klien

Pilih tab yang sesuai dengan bahasa pemrograman Anda untuk mengetahui petunjuk cara mengonfigurasi library klien.

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_JSON_SECRETS_PATH",
    ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "developer-token: DEVELOPER_TOKEN" \
   -H "login-customer-id: LOGIN_CUSTOMER_ID" \
   --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}