Potrzebujesz zarówno danych logowania do aplikacji OAuth 2.0, jak i dewelopera
token przy wywołaniu interfejsu Google Ads API. Jeśli wykonujesz wywołania interfejsu API
z kontem menedżera Google Ads, musisz też określić login-customer-id
z każdym żądaniem. Na tej stronie dowiesz się, jak ustawić te wartości
dokumentuje kilka dodatkowych nagłówków HTTP specyficznych dla interfejsu API, które są wysyłane i
otrzymane przy użyciu interfejsu REST.
Dane logowania OAuth 2.0
Interfejs Google Ads API używa danych logowania do aplikacji do identyfikowania i autoryzacji interfejsu API. żądań. Klienty i usługa OAuth 2.0 kont, jakie można skonfigurować. Więcej informacji o konfigurowaniu autoryzacji po stronie klienta zawiera artykuł OAuth2 w interfejsu Google Ads API.
Jeśli dopiero zaczynasz korzystać z interfejsów API Google, możesz użyć oauth2l lub OAuth 2.0 Playground, z którymi możesz poeksperymentować danych logowania do aplikacji i interfejsu Google Ads API przed napisaniem kodu .
Korzystanie z procesów w aplikacji na komputerze lub w aplikacji internetowej
Wykonaj te czynności, aby skonfigurować projekt Konsoli interfejsów API Google na potrzeby interfejsu Google Ads API. Zapisz identyfikator klienta oraz tajny klucz klienta, a potem wróć na tę stronę.
Po utworzeniu klienta OAuth postępuj zgodnie z procedurą tworzenia aplikacji komputerowej instrukcje lub proces w aplikacji internetowej instrukcje wygenerować token odświeżania i token dostępu.
Korzystanie z kont usługi
Postępuj zgodnie z typowymi instrukcjami w usłudze Konta przewodnik po konfigurowaniu dostępu konta usługi do interfejsu Google Ads API.
Po skonfigurowaniu konta usługi, aby uzyskać dostęp do konta Google Ads, postępuj zgodnie z
Używanie protokołu OAuth 2.0 na potrzeby połączeń między serwerami
Zgłoszenia
pamiętaj, aby wybrać kartę HTTP/REST. scope, który ma być używany w przypadku interfejsu Google Ads API
dostęp wynosi https://www.googleapis.com/auth/adwords.
Generowanie nowych tokenów dostępu
Mając identyfikator klienta, tajny klucz klienta i token odświeżania, możesz
do wygenerowania nowego tokena dostępu do użycia w wywołaniach interfejsu API z
Narzędzie 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żyj tokena dostępu zwróconego przez żądanie curl w polu
Authorization Nagłówek HTTP każdego wywołania interfejsu Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Nagłówki żądania
Token programisty
Interfejs Google Ads API wymaga też tokena programisty do wywoływania interfejs API. O token dla swojego konta menedżera możesz poprosić bezpośrednio na stronie Interfejs Google Ads. Więcej informacji o konfigurowaniu tokena programisty znajdziesz w artykule Uzyskaj token programisty.
W żądaniu HTTP developer-token podaj wartość tokena programisty
nagłówek każdego wywołania interfejsu Google Ads API do interfejsu Google Ads API:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Login klienta
W przypadku wywołań interfejsu Google Ads API wysyłanych przez menedżera na konto klienta (tzn. gdy
zalogowanie się jako menedżer w celu wywołania interfejsu API na jednym z jego kont klientów),
musisz też podać nagłówek HTTP login-customer-id. Ta wartość reprezentuje
identyfikator klienta Google Ads menedżera wykonującego wywołanie interfejsu API.
Podanie tego nagłówka jest równoważne z wyborem konta w interfejsie Google Ads
po zalogowaniu się lub kliknięciu zdjęcia profilowego w prawym górnym rogu
stronę. Określając identyfikator klienta, pamiętaj o usunięciu wszelkich łączników (—).
na przykład: 1234567890, a nie 123-456-7890.
GET /v17/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
Ten nagłówek jest używany tylko przez zewnętrznych dostawców analityki aplikacji, gdy przesyłanie konwersji na połączone konto Google Ads, . Zobacz Przewodnik 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
Poniższe 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. Kiedy
debugowanie lub rozwiązywanie problemów z konkretnymi wywołaniami interfejsu API, request-id
to ważny identyfikator, który jest potrzebny podczas kontaktowania się z deweloperem Google
.
request-id: 2a5Cj89VV7CNhya1DZjjrC