Krótkie wprowadzenie

Ten przewodnik korzysta z biblioteki klienta do pobierania kampanii Google Ads.

Aby włączyć dostęp do interfejsu API, najpierw musisz uzyskać wymagane dane logowania OAuth2. Następnie dodaj dane autoryzacji i konta do pliku konfiguracji. Po skonfigurowaniu pliku konfiguracji możesz wywołać interfejs API.

Wymagania wstępne

Parametry konfiguracji

W pliku konfiguracyjnym biblioteki klienta musisz podać następujące informacje.

Token programisty

Token dewelopera umożliwia aplikacji dostęp do interfejsu API, ale nie jest ograniczony do jednego konta Google Ads. Po zatwierdzeniu tokena możesz go używać w żądaniach wszystkich kont Google Ads, nawet jeśli nie są one powiązane z kontem menedżera Google Ads powiązanym z tokenem. Konta, którymi zarządzasz, są uwierzytelnione przez dane logowania OAuth z konta menedżera. Konto menedżera wymaga tylko jednego zestawu danych logowania, aby zarządzać wszystkimi jego subkontami.

Tylko zatwierdzone tokeny mogą łączyć się z interfejsem API w przypadku produkcyjnych kont Google Ads. Tokeny oczekujące mogą łączyć się tylko z kontami testowymi.

Aby pobrać token programisty, zaloguj się na konto menedżera, a następnie przejdź do Centrum interfejsu API (NARZĘDZIA & USTAWIENIA > KONFIGURACJA > Centrum API).

Najważniejsze punkty

  • Firma powinna mieć tylko 1 token programisty.
  • Po użyciu identyfikatora klienta z projektu Google Cloud z tokenem programisty identyfikator klienta jest powiązany z tokenem programisty i nie można go używać z innym tokenem dewelopera. Innymi słowy:
    • Tokenu programisty można używać z wieloma identyfikatorami klientów.
    • Identyfikatora klienta można jednak używać tylko z jednym tokenem programisty.
Identyfikator klienta

Identyfikator klienta to numer konta klienta Google Ads, którym chcesz zarządzać za pomocą interfejsu API. Zwykle ma on postać 123-456-7890.

Opcjonalnie: identyfikator klienta możesz pominąć w pliku konfiguracyjnym i ustaw go automatycznie. Po zatwierdzeniu tokena programisty możesz używać identyfikatora klienta z konta produkcyjnego, a nie konta testowego.

Identyfikator klienta OAuth2 i tajny klucz klienta

Identyfikator klienta OAuth2 i tajny klucz klienta mapują aplikację kliencką na projekt w konsoli interfejsu Google API i służą do uwierzytelniania OAuth2 – dzięki temu aplikacja może działać w imieniu Twojego konta. Identyfikują Twoją aplikację do Google i umożliwiają generowanie tokenów OAuth do zarządzania użytkownikami Google Ads.

Więcej informacji znajdziesz w artykule Tworzenie identyfikatora klienta i tajnego klucza klienta.

Tokeny dostępu i odświeżania OAuth2

Zanim aplikacja będzie mogła korzystać z danych prywatnych, musi otrzymać token dostępu OAuth2, który przyznaje dostęp do interfejsu API.

Jeśli używasz bibliotek klienta, token dostępu OAuth2 zrobi to automatycznie. W innym przypadku zapoznaj się z przykładowym wywołaniem interfejsu API w przewodniku po OAuth2, aby dowiedzieć się więcej o generowaniu tokena dostępu.

Tokeny dostępu OAuth2 wygasają po pewnym czasie. Z tego powodu biblioteki klienta używają tokena odświeżania OAuth2 do automatycznego ponownego generowania tokena dostępu OAuth2.

Dostęp i tokeny odświeżania OAuth2 zawierają instrukcje tworzenia tokena odświeżania.

Więcej informacji o korzystaniu z OAuth2 z interfejsami API Google znajdziesz w dokumentacji OAuth2 Authentication (Uwierzytelnianie OAuth2) i OAuth2 Identity Platform (Platforma OAuth2).