Nasze biblioteki klienta automatycznie zajmują się szczegółami opisanymi poniżej, więc czytaj dalej tylko wtedy, gdy interesuje Cię to, co dzieje się w tle, lub jeśli nie używasz jednej z naszych bibliotek klienta.
Ta sekcja jest przeznaczona dla zaawansowanych użytkowników, którzy znają już specyfikację OAuth 2.0 i wiedzą, jak używać OAuth2 z interfejsami API Google.
Chcesz dowiedzieć się więcej o uwierzytelnianiu w API?
Biblioteka filmów: uwierzytelnianie i autoryzacja
Zakres
Pojedynczy token dostępu może przyznawać różny poziom dostępu do wielu interfejsów API. Parametr zmienny o nazwie scope kontroluje zestaw zasobów i operacji, do których dostęp umożliwia token dostępu. Podczas żądania tokena dostępu aplikacja wysyła co najmniej 1 wartość w parametrze scope.
Zakres interfejsu Google Ads API to:
https://www.googleapis.com/auth/adwords
Dostęp offline
Aplikacja kliencka interfejsu Google Ads API często prosi o dostęp offline. Na przykład aplikacja może chcieć uruchamiać zadania wsadowe, gdy użytkownik nie jest fizycznie online i nie przegląda Twojej witryny.
Aby poprosić o dostęp offline w przypadku aplikacji internetowej, ustaw parametr access_type na offline. Dodatkowe informacje znajdziesz w przewodniku Google dotyczącym OAuth2.
W przypadku aplikacji na komputery dostęp offline jest domyślnie włączony – nie musisz o niego prosić.
Nagłówki żądania
Nagłówki gRPC
Jeśli używasz interfejsu gRPC API, dołączaj token dostępu do każdego żądania. Możesz powiązać Credential z Channel, aby używać go we wszystkich żądaniach w tym kanale. Możesz też wysyłać dostosowane dane logowania przy każdym wywołaniu. Więcej informacji o obsłudze autoryzacji znajdziesz w przewodniku po autoryzacji gRPC.
Nagłówki REST
Gdy używasz interfejsu API REST, przekaż token dostępu przez nagłówek HTTP Authorization. Poniżej znajduje się przykładowe żądanie HTTP:
GET /v20/customers/123456789 HTTP/2 Host: googleads.googleapis.com User-Agent: INSERT_USER_AGENT Accept: */* Authorization: Bearer INSERT_ACCESS_TOKEN developer-token: INSERT_DEVELOPER_TOKEN
Token dostępu i token odświeżania
W większości przypadków musisz bezpiecznie przechowywać token odświeżania, aby móc go użyć w przyszłości. Więcej informacji o tym, jak poprosić o tokeny dostępu i odświeżania, znajdziesz w odpowiednim przewodniku dotyczącym Twojego typu aplikacji:
Wygasanie tokena odświeżania
Więcej informacji o wygaśnięciu tokena odświeżania znajdziesz w dokumentacji OAuth usługi Google Identity Platform.
Wygaśnięcie tokena dostępu
Token dostępu ma czas ważności (określony na podstawie wartości expires_in), po którym traci ważność. Tokena odświeżania możesz użyć do odświeżenia wygasłego tokena dostępu. Domyślnie nasze biblioteki klienta automatycznie odświeżają wygasłe tokeny dostępu.