Krótkie wprowadzenie

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

Aby włączyć dostęp przez interfejs API, musisz najpierw uzyskać wymagane dane logowania OAuth2.

Następnie dodaj dane autoryzacji i konta do pliku konfiguracyjnego. Po skonfigurowaniu pliku konfiguracji możesz wywołać interfejs API.

Parametry konfiguracji biblioteki klienta

Podaj te informacje w pliku konfiguracyjnym biblioteki klienta.

Token programisty

Token programisty pozwala aplikacji korzystać z interfejsu API, ale nie jest ograniczony tylko do jednego konta Google Ads. Po zatwierdzeniu tokena możesz używać tego samego tokena do przesyłania żądań dotyczących wszystkich kont Google Ads, nawet jeśli nie są one połączone z kontem menedżera Google Ads powiązanym z tokenem.

Konta, którymi zarządzasz, są autoryzowane przez dane logowania OAuth z konta menedżera. Konto menedżera wymaga tylko jednego zestawu danych logowania, aby zarządzać wszystkimi jego subkontami.

Z interfejsem API w celu produkcji Google Ads mogą się łączyć tylko zatwierdzone tokeny. Tokeny oczekujące mogą łączyć się tylko z kontami testowymi.

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

Identyfikator klienta

Identyfikator klienta to numer konta klienta Google Ads, którym chcesz zarządzać za pomocą interfejsu API, zwykle w formacie 123-456-7890.

Opcjonalnie identyfikator klienta można pozostawić w pliku konfiguracyjnym i ustawić go automatycznie. Po zatwierdzeniu tokena programisty możesz używać identyfikatora klienta z konta produkcyjnego zamiast konta testowego.

Identyfikator klienta OAuth2 i tajny klucz klienta

Identyfikator klienta OAuth2 i tajny klucz klienta mapują aplikację kliencką na projekt w konsoli Google API i służą do uwierzytelniania OAuth2. Dzięki temu aplikacja może działać w imieniu Twojego konta. Identyfikują Twoją aplikację w Google i pozwalają Ci generować tokeny 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 protokołu OAuth2

Zanim aplikacja będzie mogła uzyskiwać dostęp do danych prywatnych za pomocą interfejsu API, musi uzyskać token dostępu OAuth2, który przyznaje dostęp do interfejsu API.

Jeśli używasz bibliotek klienta, token dostępu OAuth2 jest automatycznie obsługiwany. Jeśli nie, spróbuj uzyskać tokeny za pomocą OAuth Playground.

Tokeny dostępu OAuth2 wygasają po określonym czasie. Dlatego biblioteki klienta używają tokenu odświeżania OAuth2, który automatycznie generuje token dostępu OAuth2. Token dostępu i odświeżania zawiera instrukcje tworzenia tokena odświeżania.