Proces konta usługi

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

Konto usługi to konto należące do Twojej aplikacji, a nie do konkretnego użytkownika. Konta usług 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 do interfejsu Google Ads API na kontach Google Ads jest wykonywana jako krok konfiguracji, z wykorzystaniem funkcji autoryzacji i zarządzania kontami dostępnych w interfejsie Google Ads. Dzięki temu deweloperzy nie muszą tworzyć procesów OAuth 2.0 ani radzić sobie ze złożonymi problemami związanymi z interakcją z użytkownikiem, przechowywaniem danych logowania użytkownika itp.

• 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 przypadkach, gdy autoryzacja ma być kontynuowana 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. Otwórz Administracja > Dostęp i bezpieczeństwo.

3. Kliknij przycisk + na karcie Użytkownicy.

   

4. Wpisz adres e-mail konta usługi w polu E-mail. Wybierz odpowiedni poziom dostępu do konta i kliknij przycisk Dodaj konto.

   

5. Konto usługi ma dostęp.

   

6. [Opcjonalnie] Domyślnie nie możesz przyznać dostępu administratora do konta usługi. Jeśli wywołania interfejsu API wymagają dostępu administratora, możesz go uzyskać w ten sposób.

   • Kliknij strzałkę w dół obok poziomu dostępu konta usługi w kolumnie Poziom dostępu.
   • Z listy wybierz Administrator.

Konfiguracja biblioteki klienta

Aby uzyskać instrukcje konfigurowania biblioteki klienta, kliknij kartę odpowiadającą Twojemu językowi programowania.

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