Aby zacząć korzystać z interfejsu Google Photos Library API, skonfiguruj projekt, włączając go w konsoli interfejsów API Google i ustawiając identyfikator klienta OAuth 2.0.
Twoja aplikacja współpracuje ze Zdjęciami Google w imieniu użytkownika tej usługi. Gdy na przykład tworzysz albumy w bibliotece Zdjęć Google użytkownika lub przesyłasz elementy multimedialne na konto użytkownika Zdjęć Google, użytkownik autoryzuje te żądania do interfejsu API za pomocą protokołu OAuth 2.0.
Identyfikator klienta OAuth 2.0 umożliwia użytkownikom aplikacji logowanie się i uwierzytelnianie, a tym samym korzystanie z interfejsu Library API. Interfejs Library API nie obsługuje kont usługi. Aby korzystać z tego interfejsu API, użytkownicy muszą być zalogowani na prawidłowe konto Google.
Konfiguracja aplikacji
Włącz API
Aby korzystać z interfejsu Library API, musisz go włączyć w swoim projekcie.
- Otwórz konsolę interfejsów API Google.
- Na pasku menu wybierz projekt lub utwórz nowy projekt.
- Aby otworzyć bibliotekę interfejsów API Google, w menu nawigacyjnym wybierz Interfejsy API i usługi > Biblioteka.
- Wyszukaj „Google Photos Library API”. Wybierz właściwy wynik i kliknij Włącz.
Poproś o identyfikator klienta OAuth 2.0
Wykonaj czynności opisane poniżej, aby zażądać identyfikatora klienta OAuth i skonfigurować go dla swojej aplikacji. W tym przykładzie używamy aplikacji, w której cały proces OAuth jest obsługiwany po stronie serwera, tak jak w przykładach. Proces konfiguracji może się różnić w zależności od scenariuszy implementacji.
- Otwórz Konsolę interfejsów API Google i wybierz projekt.
- Z menu wybierz Interfejsy API i usługi > Dane logowania.
- Na stronie Dane logowania kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- Wybierz Typ aplikacji. W tym przykładzie typ aplikacji to Aplikacja internetowa.
Zarejestruj źródła, z których Twoja aplikacja może uzyskiwać dostęp do interfejsów API Google, wykonaj te czynności:
- Aby zidentyfikować identyfikator klienta, wpisz nazwę.
W polu Autoryzowane źródła JavaScript wpisz pochodzenie aplikacji. W tym polu nie można używać symboli wieloznacznych.
Aby umożliwić działanie aplikacji w różnych protokołach, domenach lub subdomenach, możesz podać wiele źródeł. Wpisane adresy URL mogą uruchamiać żądanie OAuth.
Poniższy przykład zawiera adres URL do lokalnego tworzenia treści (nasze przykłady korzystają z elementu
localhost:8080) i adres URL do środowiska produkcyjnego.http://localhost:8080 https://myproductionurl.example.comPole Identyfikator URI autoryzowanego przekierowania to punkt końcowy, który otrzymuje odpowiedzi z serwera OAuth 2.0. Zwykle obejmuje to środowisko programistyczne i wskazuje ścieżkę w aplikacji.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callbackKliknij Utwórz.
-
Z wyświetlonego okna klienta OAuth skopiuj następujące elementy:
- Identyfikator klienta
- Tajny klucz klienta
Za pomocą tych wartości Twoja aplikacja może uzyskiwać dostęp do włączonych interfejsów API Google.
Zanim udostępnisz publiczną aplikację, która uzyskuje dostęp do interfejsu Library API, Google musi ją sprawdzić. Podczas testowania aplikacji na ekranie wyświetla się komunikat „Niezweryfikowana aplikacja”, dopóki nie zostanie ona zweryfikowana.
Wypróbuj fragment
Po skonfigurowaniu projektu do wykorzystania z interfejsem Library API możesz zapoznać się z przykładową aplikacją w serwisie GitHub. Ta przykładowa aplikacja pokazuje, jak za pomocą interfejsu Library API utworzyć inteligentną ramkę na zdjęcia.