Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Autoryzacja i nagłówki HTTP

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wideo: uwierzytelnianie

Podczas wywoływania interfejsu Google Ads API potrzebujesz zarówno danych logowania do aplikacji OAuth 2.0, jak i tokena programisty. Jeśli wykonujesz wywołania interfejsu API jako konto menedżera Google Ads, przy każdym żądaniu musisz też określić nagłówek login-customer-id. Na tej stronie opisujemy, jak ustawić te wartości i dokumenty, oraz kilka dodatkowych nagłówków HTTP przeznaczonych dla interfejsu API, które są wysyłane i odbierane za pomocą interfejsu REST.

Dane logowania OAuth 2.0

Interfejs Google Ads API używa danych logowania aplikacji do identyfikowania i autoryzowania żądań do interfejsu API. Możesz skonfigurować zarówno klienty OAuth 2.0, jak i konta usługi. Więcej informacji o konfigurowaniu autoryzacji po stronie klienta znajdziesz w artykule OAuth2 w interfejsie Google Ads API.

Jeśli nie masz doświadczenia z interfejsami API Google, możesz napisać kod aplikacji za pomocą oauth2l lub OAuth 2.0 Playground, aby poeksperymentować z danymi logowania do aplikacji i interfejsem Google Ads API.

Korzystanie z procesów na komputerze lub w aplikacji internetowej

Postępuj zgodnie z instrukcjami konfigurowania projektu w Konsoli interfejsów API Google dla interfejsu Google Ads API. Zapisz identyfikator klienta i tajny klucz klienta, a następnie wróć na tę stronę.

Po utworzeniu klienta OAuth wykonaj instrukcje przepływu aplikacji na komputery lub instrukcje procesu aplikacji internetowej, aby wygenerować token odświeżania i token dostępu.

Korzystanie z kont usługi

Aby skonfigurować dostęp do konta usługi na potrzeby interfejsu API Google Ads, postępuj według typowych instrukcji z Przewodnika po kontach usługi.

Po skonfigurowaniu konta usługi w celu uzyskiwania dostępu do konta Google Ads postępuj zgodnie z instrukcjami zawartymi w przewodniku dotyczącym protokołu OAuth 2.0 dla aplikacji między serwerami i wybierz kartę HTTP/REST. scope używany w interfejsie Google Ads API to https://www.googleapis.com/auth/adwords.

Generowanie nowych tokenów dostępu

Mając identyfikator klienta, klucz klienta i token odświeżania, możesz wygenerować nowy token dostępu do użycia w wywołaniach interfejsu API za pomocą narzędzia wiersza poleceń 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

Następnie używasz tokena dostępu zwróconego w żądaniu curl w nagłówku HTTP Authorization każdego wywołania interfejsu API Google Ads:

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Nagłówki żądania

Token programisty

Interfejs API Google Ads wymaga również tokena programisty, aby przekazywać wywołania do interfejsu API. Możesz poprosić o token konta menedżera bezpośrednio w interfejsie Google Ads. Szczegółowe informacje o konfigurowaniu tokena programisty znajdziesz w artykule Uzyskiwanie tokena programisty.

Musisz podać wartość tokena programisty w nagłówku HTTP developer-token wywołania interfejsu API Google Ads:

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Identyfikator klienta logowania

W przypadku wywołań interfejsu API Google Ads wykonanych przez menedżera na koncie klienta (czyli logowania się jako menedżer na potrzeby wywołań interfejsu API na jednym z kont klientów) trzeba też podać nagłówek HTTP login-customer-id. Ta wartość reprezentuje identyfikator klienta Google Ads menedżera dokonującego wywołania interfejsu API.

Uwzględnienie tego nagłówka odpowiada wybraniu konta w interfejsie Google Ads po zalogowaniu się lub kliknięciu zdjęcia profilowego w prawym górnym rogu strony. Określając identyfikator klienta, pamiętaj o usunięciu myślników (—), na przykład: 1234567890, a nie 123-456-7890.

GET /v11/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

Identyfikator połączonego klienta

Tego nagłówka używają tylko zewnętrzni dostawcy analityki aplikacji podczas przesyłania konwersji na połączone konto Google Ads. Więcej informacji znajdziesz w przewodniku po strukturze wywołań interfejsu API.

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID

Nagłówki odpowiedzi

Te nagłówki są zwracane w odpowiedziach HTTP z interfejsu API.

Identyfikator żądania

request-id to ciąg znaków, który jednoznacznie identyfikuje żądanie do interfejsu API. W przypadku debugowania problemów z interfejsami API i rozwiązywania problemów z nimi interfejs request-id jest ważnym identyfikatorem, który przydaje się podczas kontaktowania się z zespołem pomocy Google dla programistów.

request-id: 2a5Cj89VV7CNhya1DZjjrC