Sekcja danych logowania w Eksploratorze interfejsów API umożliwia testowanie różnych danych logowania i zakresów. Ta funkcja pomaga upewnić się, że do wywołania punktu końcowego interfejsu API używasz minimalnych wymaganych danych logowania i zakresu.
Testowanie z użyciem różnych danych logowania
Domyślnie zaznaczone są oba typy danych logowania: OAuth 2 i klucz interfejsu API. Jeśli chcesz przeprowadzić test tylko z jednymi danymi logowania, zaznacz typ danych logowania, którego chcesz użyć (i odznacz drugi typ). Oto ogólne zasady wyboru danych logowania do testowania:
Jeśli używasz metody dostępu do danych publicznych, np. danych Map Google, możesz użyć klucza interfejsu API jako danych logowania. Zaznacz Klucz interfejsu API i odznacz Google OAuth 2.0.
Jeśli używasz metody dostępu do danych prywatnych, np. danych użytkownika z Google Drive, 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 są wystarczające do uzyskania dostępu do danych. Jeśli otrzymasz wynik 401, musisz użyć danych logowania OAuth 2, aby uzyskać dostęp do danych.
Testowanie z różnymi zakresami
Zakres to ciąg znaków, np. https://www.googleapis.com/auth/drive.metadata.readonly, który określa poziom dostępu do zasobów wymaganych przez aplikację, np. poziom dostępu do danych należących do użytkowników. Najlepiej, aby aplikacja korzystała 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ć co najmniej zakresu tylko do odczytu, a inne metody mogą wymagać zakresu odczytu i zapisu.
Domyślnie w Exploratorze interfejsów API włączone są wszystkie zakresy OAuth 2.0 Google dla interfejsu API. Aby przeprowadzić test w określonym zakresie:
- W sekcji Dane logowania Google OAuth 2.0 kliknij Pokaż zakresy.
- Sprawdź zakres, którego należy użyć podczas wywoływania metody.
- Kliknij Wykonaj, aby wykonać interfejs API tylko w wybranym zakresie. W interfejsie API Explorer wyświetli się ekran autoryzacji z prośbą o przyznanie dostępu do zakresu.
- Kliknij Zezwól. Wyniki pojawią się pod przyciskiem Wykonaj.
Jeśli w sekcji „application/json” w Eksploratorze interfejsów API pojawi się wynik 200, zakres jest wystarczający do wywołania metody. Jeśli Eksplorator interfejsów API wyświetla wynik 403, oznacza to, że wybrany zakres jest niewystarczający do wywołania metody. Spróbuj szerszego zakresu.
Więcej informacji o wybieraniu zakresów znajdziesz w sekcji uwierzytelniania i autoryzacji w dokumentacji konkretnego interfejsu Google API.
Unieważnianie autoryzowanego dostępu do testowania z nowymi zakresami
Po zatwierdzeniu autoryzacji na ekranie autoryzacji Google Eksplorator interfejsów API zachowuje uprawnienia do wysyłania uwierzytelnionych żądań, dopóki dane logowania nie wygasną. Odznaczenie zakresów nie powoduje zresetowania wcześniej zatwierdzonych uprawnień i zakresów. Jeśli chcesz przeprowadzić testy z nową konfiguracją zakresu, musisz cofnąć wcześniej zatwierdzone dane logowania.
Aby cofnąć dane logowania używane przez Eksplorator interfejsów API:
- Otwórz Aplikacje, które mają dostęp do Twojego konta.
- W sekcji Aplikacje innych firm z dostępem do konta kliknij Google APIs Explorer.
- Kliknij Usuń dostęp.
- (opcjonalnie) Załaduj ponownie stronę dokumentacji, aby zresetować Eksploratora interfejsów API.