Proces konta usługi

Z tego przewodnika dowiesz się, jak uzyskiwać dostęp do interfejsu Google Ads API za pomocą kont usługi.

Konto usługi to konto, które należy do Twojej aplikacji, a nie do użytkownika. Konta usługi korzystają z przepływu OAuth 2.0, który nie wymaga autoryzacji przez człowieka, ale używa pliku klucza, z którego może korzystać tylko Twoja aplikacja.

Korzystanie z kont usług ma 2 główne zalety:

• Autoryzacja dostępu interfejsu Google Ads API do kont Google Ads odbywa się w ramach konfiguracji z wykorzystaniem funkcji autoryzacji i zarządzania kontami oferowanych przez interfejs Google Ads. Dzięki temu deweloperzy nie muszą tworzyć przepływów OAuth 2.0 ani radzić sobie z komplikacjami związanymi z interakcją użytkownika, przechowywaniem danych logowania użytkownika i zarządzaniem tokenami.

• Autoryzacja dostępu do kont Google Ads nie jest powiązana z danymi logowania poszczególnych użytkowników, co może być przydatne w sytuacjach, gdy autoryzacja ma obowiązywać nawet wtedy, gdy pracownik, który pierwotnie autoryzował dostęp, opuści zespół lub firmę.

Konfigurowanie dostępu do konta

1. Zacznij od utworzenia konta usługi i danych logowania.

   Pobierz klucz konta usługi w formacie JSON i zanotuj identyfikator oraz adres e-mail konta usługi.

2. Zaloguj się na konto Google Ads jako administrator. Kliknij Administracja > Dostęp i bezpieczeństwo.

3. Na karcie Użytkownicy kliknij przycisk +.

4. Wpisz adres e-mail konta usługi w polu Adres e-mail. Wybierz odpowiedni poziom dostępu do konta (pamiętaj, że konta usługi nie obsługują poziomu dostępu Tylko e-mail) i kliknij przycisk Dodaj konto.

5. Konto usługi otrzymuje dostęp.

6. Opcjonalnie: domyślnie nie możesz przyznać dostępu administratora do konta usługi. Postępuj zgodnie z zasadą jak najmniejszych uprawnień i przyznawaj dostęp administratora tylko wtedy, gdy jest to wymagane przez wywołania interfejsu API. Dostęp możesz uaktualnić w ten sposób:

   • W kolumnie Poziom dostępu kliknij strzałkę menu obok poziomu dostępu konta usługi.
   • Z menu wybierz Administrator.

Konfiguracja biblioteki klienta

Wybierz kartę odpowiadającą Twojemu językowi programowania, aby uzyskać instrukcje konfigurowania biblioteki klienta. Jeśli Twoje konto usługi uzyskuje dostęp do kont klientów za pomocą konta menedżera Google Ads (MCK), ustaw też wartość login-customer-id (lub loginCustomerId) na 10-cyfrowy identyfikator klienta tego konta menedżera bez łączników (patrz Logowanie za pomocą identyfikatora klienta).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_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

[OAUTH2]
; 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=JSON_KEY_FILE_PATH

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 "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"
}