Sekcja danych logowania do interfejsów API APIs Explorer pozwala testować różne dane logowania i zakresy. Ta funkcja pozwala upewnić się, że do wywołania punktu końcowego API używasz minimalnej wymaganej liczby danych logowania i zakresu.
Testuj za pomocą różnych danych logowania
Domyślnie zaznaczone są oba typy danych logowania: OAuth 2 i Klucz API. Jeśli testujesz tylko z jednym rodzajem danych logowania, zaznacz używany typ danych logowania (i usuń zaznaczenie drugiego typu danych logowania). Oto ogólne zasady wybierania danych logowania do testowania:
Jeśli korzystasz z metody uzyskiwania dostępu do danych publicznych, takich jak dane Map Google, możesz użyć klucza interfejsu API jako swoich danych logowania. Zaznacz Klucz interfejsu API i odznacz opcję Google OAuth 2.0.
Jeśli używasz metody dostępu do danych prywatnych, takich jak dane użytkownika Dysku Google, musisz użyć danych logowania OAuth 2. Odznacz pole Klucz interfejsu API i zaznacz Google OAuth 2.0.
Jeśli otrzymasz wynik 200, dane logowania będą wystarczające do uzyskania dostępu do danych. Jeśli otrzymasz błąd 401, musisz użyć danych logowania OAuth 2, aby uzyskać dostęp do danych.
Testuj z różnymi zakresami
Zakres jest ciągiem znaków, takim jak https://www.googleapis.com/auth/drive.metadata.readonly, określający poziom dostępu do zasobów wymaganych przez aplikację, np. poziom dostępu do danych należących do użytkowników. Najlepiej, gdyby aplikacje korzystały z zakresów o najwęższym poziomie dostępu do danych użytkownika. Różne metody mogą wymagać
różnych zakresów. Na przykład metoda w interfejsie API może wymagać zakresu co najmniej tylko do odczytu, a inne metody do odczytu i zapisu.
Domyślnie wszystkie interfejsy Google OAuth 2.0 dla interfejsu API są włączone w narzędziu APIs Explorer. Aby przetestować konkretny zakres:
- W sekcji Dane logowania Google OAuth 2.0 kliknij pokaż zakresy.
- Sprawdź zakres, który ma być używany podczas wywoływania metody.
- Kliknij Uruchom, aby uruchomić interfejs API, używając tylko wybranego zakresu. Eksplorator interfejsów API wyświetli ekran autoryzacji z prośbą o przyznanie dostępu do używania zakresu.
- Kliknij Zezwól. Wyniki zostaną wyświetlone pod przyciskiem Wykonaj.
Jeśli eksplorator interfejsów API wyświetla wynik 200 w sekcji "application/json", to zakres wystarcza do wywołania metody. Jeśli eksplorator interfejsów API wyświetla wynik 403, wybrano niewystarczający zakres do wywołania metody. Spróbuj poszerzyć zakres.
Więcej informacji o wyborze zakresu znajdziesz w sekcji dotyczącej uwierzytelniania i autoryzacji w dokumentacji konkretnego interfejsu Google API.
Cofnij autoryzowany dostęp do testów z nowymi zakresami
Gdy ekran autoryzacji Google zostanie zatwierdzony, Eksplorator interfejsów API pozostanie uprawniony do uwierzytelniania żądań, dopóki dane logowania nie wygasną. Odznaczenie zakresów nie powoduje zresetowania wcześniej zatwierdzonych danych logowania i zakresów. Jeśli chcesz przetestować za pomocą nowej konfiguracji zakresu, musisz unieważnić wcześniej zatwierdzone dane logowania.
Aby unieważnić dane logowania używane przez eksploratora interfejsów API:
- Kliknij Aplikacje, które mają dostęp do Twojego konta.
- W sekcji Aplikacje innych firm mające dostęp do konta kliknij Google APIs Explorer.
- Kliknij Usuń dostęp.
- (Opcjonalnie) Załaduj ponownie stronę z dokumentacją, aby zresetować Eksplorator API.