Nasze biblioteki klienta automatycznie dbają o szczegóły opisane poniżej, więc czytaj dalej tylko wtedy, gdy interesuje Cię to, co dzieje się za kulisami, lub jeśli nie używasz jednej z naszych bibliotek klienta.
Ta sekcja jest przeznaczona dla zaawansowanych użytkowników, którzy znają specyfikację OAuth 2.0 i wiedzą, jak korzystać z OAuth 2 w przypadku interfejsów API Google.
Chcesz dowiedzieć się więcej o uwierzytelnianiu w interfejsie API?
Biblioteka filmów: uwierzytelnianie i autoryzacja
Zakres
Pojedynczy token dostępu może przyznawać różne poziomy dostępu do wielu interfejsów API. Parametr zmienny o nazwie scope kontroluje zestaw zasobów i operacji, do których pozwala na dostęp token dostępu. Podczas żądania tokena dostępu aplikacja wysyła co najmniej 1 wartość w parametrze scope.
Zakres interfejsu Google Ads API:
https://www.googleapis.com/auth/adwords
Dostęp offline
Aplikacja klienta interfejsu Google Ads API często prosi o dostęp offline. Na przykład aplikacja może wykonywać zadania zbiorcze, gdy użytkownik nie jest fizycznie online przeglądając Twoją witrynę.
Aby poprosić o dostęp offline w przypadku danego typu aplikacji internetowej, ustaw parametr access_type na offline. Więcej informacji znajdziesz w przewodniku Google OAuth2.
W przypadku aplikacji na komputer dostęp offline jest domyślnie włączony – nie musisz go prosić.
Nagłówki żądania
Nagłówki gRPC
Korzystając z interfejsu gRPC API, dołącz token dostępu do każdego żądania. Możesz związać Credential z Channel, aby używać go we wszystkich żądaniach na tym kanale. Możesz też wysłać dostosowane dane logowania dla każdego wywołania. Więcej informacji o obsługiwaniu autoryzacji znajdziesz w przewodniku dotyczącym autoryzacji gRPC.
Nagłówki REST
Podczas korzystania z interfejsu API REST podawaj token dostępu w nagłówku HTTPAuthorization. Poniżej znajduje się przykład żądania HTTP:
GET /v19/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 na potrzeby przyszłego użycia. Aby dowiedzieć się więcej o wysyłaniu prośby o dostęp i tokeny odświeżania, przeczytaj odpowiedni przewodnik dla danego typu aplikacji:
Wygaśnięcie tokena odświeżania
Więcej informacji o wygaśnięciu tokena odświeżania znajdziesz w dokumentacji OAuth platformy Google Identity Platform.
Wygaśnięcie tokena dostępu
Token dostępu ma określony czas ważności (na podstawie wartości parametru expires_in), po upływie którego 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.