Alur Kerja Autentikasi Multi-Pengguna

Catatan: Panduan ini mengasumsikan bahwa Anda telah memahami model akses Google Ads. Jika Anda belum melakukannya, sebaiknya baca panduan model akses Google Ads untuk memahami konsepnya.

Dalam alur kerja autentikasi multi-pengguna, Anda membangun alur OAuth Anda sendiri untuk mengautentikasi pengguna Anda. Ada beberapa jenis aplikasi yang dibahas sebagai bagian dari dokumentasi Google Identity, dan konfigurasi project Google Cloud Console yang Anda perlukan untuk mendukung jenis aplikasi tersebut. Semua jenis aplikasi ini didukung oleh Google Ads API. Detail teknis tambahan yang perlu diperhatikan adalah:

1. Untuk mengakses Google Ads API, Anda harus mengonfigurasi aplikasi untuk melakukan autentikasi bagi cakupan berikut:

   https://www.googleapis.com/auth/adwords
   

2. Aplikasi Anda mungkin harus melakukan panggilan API atas nama pengguna saat pengguna sedang offline. Skenario umum adalah mendownload metrik akun secara offline untuk membuat laporan dan melakukan analisis akun. Oleh karena itu, sebaiknya minta akses offline OAuth.

3. Anda harus melalui proses verifikasi Aplikasi OAuth dan mendapatkan sertifikasi aplikasi Anda.

Konfigurasi library klien

Setelah mengizinkan pengguna dan mendapatkan kredensial OAuth 2.0, Anda dapat mengonfigurasi library klien dengan mengikuti petunjuk di tab yang sesuai dengan bahasa pemrograman Anda.

Java

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

UserCredentials credentials =
    UserCredentials.newBuilder()
        .setClientId(OAUTH_CLIENT_ID)
        .setClientSecret(OAUTH_CLIENT_SECRET)
        .setRefreshToken(REFRESH_TOKEN)
        .build();

// Creates a GoogleAdsClient with the provided credentials.
GoogleAdsClient client =
    GoogleAdsClient.newBuilder()
        // Sets the developer token which enables API access.
        .setDeveloperToken(DEVELOPER_TOKEN)
        // Sets the OAuth credentials which provide Google Ads account access.
        .setCredentials(credentials)
        // Optional: sets the login customer ID.
        .setLoginCustomerId(Long.valueOf(LOGIN_CUSTOMER_ID))
        .build();
``` See the [configuration guide][java-config-guide] for additional options.

.NET

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

GoogleAdsConfig googleAdsConfig = new GoogleAdsConfig()
{
    DeveloperToken = DEVELOPER_TOKEN,
    LoginCustomerId = LOGIN_CUSTOMER_ID,
    OAuth2ClientId = OAUTH_CLIENT_ID,
    OAuth2ClientSecret = OAUTH_CLIENT_SECRET,
    OAuth2RefreshToken = REFRESH_TOKEN,
};

GoogleAdsClient googleAdsClient = new GoogleAdsClient(googleAdsConfig);

Lihat panduan konfigurasi untuk opsi tambahan.

Python

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

from google.ads.googleads.client import GoogleAdsClient

credentials = {
    "developer_token": "INSERT_DEVELOPER_TOKEN_HERE",
    "login_customer_id": "INSERT_LOGIN_CUSTOMER_ID_HERE",
    "refresh_token": "REFRESH_TOKEN",
    "client_id": "OAUTH_CLIENT_ID",
    "client_secret": "OAUTH_CLIENT_SECRET"}

client = GoogleAdsClient.load_from_dict(credentials)

Lihat panduan konfigurasi untuk opsi tambahan.

PHP

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

$oAuth2Credential = (new OAuth2TokenBuilder())
->withClientId('INSERT_CLIENT_ID_HERE')
->withClientSecret('INSERT_CLIENT_SECRET_HERE')
->withRefreshToken('INSERT_REFRESH_TOKEN_HERE')
->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    ->withDeveloperToken('INSERT_DEVELOPER_TOKEN_HERE')
    ->withLoginCustomerId('INSERT_LOGIN_CUSTOMER_ID_HERE')
    ->build();

Lihat panduan konfigurasi untuk opsi tambahan.

Ruby

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

  client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
    config.client_id = 'INSERT_CLIENT_ID_HERE'
    config.client_secret = 'INSERT_CLIENT_SECRET_HERE'
    config.refresh_token = 'INSERT_REFRESH_TOKEN_HERE'
    config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
    config.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
  end

Lihat panduan konfigurasi untuk opsi tambahan.

Perl

Anda dapat menginisialisasi instance GoogleAdsClient saat runtime, menggunakan kredensial yang telah Anda peroleh dari pengguna yang akunnya Anda panggil API-nya.

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

Lihat panduan konfigurasi untuk opsi tambahan.

curl

Mulai dengan menggunakan klien HTTP untuk mengambil token akses OAuth 2.0. Panduan ini menggunakan perintah curl.

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://www.googleapis.com/oauth2/v3/token

Sekarang Anda dapat menggunakan token akses dalam panggilan API. Contoh berikut menunjukkan cara menjalankan laporan kampanye menggunakan metode GoogleAdsService.SearchStream untuk mengambil kampanye di akun Anda. Panduan ini tidak membahas detail pelaporan.

curl -i -X POST https://googleads.googleapis.com/v21/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"

Isi query.json adalah sebagai berikut:

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