Aby zacząć korzystać z interfejsów API Zdjęć Google, skonfiguruj projekt, włączając potrzebne interfejsy API Zdjęć za pomocą konsoli interfejsów API Google i konfigurując identyfikator klienta OAuth 2.0.
Twoja aplikacja wchodzi w interakcję ze Zdjęciami Google w imieniu użytkownika Zdjęć Google. Gdy na przykład utworzysz albumy w bibliotece Zdjęć Google użytkownika lub prześlesz elementy multimedialne na konto tego użytkownika, autoryzuje on 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 interfejsów API Zdjęć. Interfejsy API Photos nie obsługują kont usługi. Aby z nich korzystać, użytkownicy muszą zalogować się na prawidłowe konto Google.
Konfiguracja aplikacji
Najpierw włącz interfejs API, a następnie poproś o identyfikator klienta OAuth 2.0.
Włącz API
Zanim zaczniesz korzystać z interfejsów API Zdjęć, musisz je włączyć w projekcie.
- Otwórz konsolę interfejsów API Google.
- Na pasku menu wybierz projekt lub utwórz nowy.
- Aby otworzyć jeden z interfejsów API Zdjęć Google, z menu nawigacyjnego wybierz Interfejsy API i usługi > Biblioteka.
- Wyszukaj „Zdjęcia”. Wybierz co najmniej 1 interfejs API Zdjęć i kliknij Włącz.
Żądanie identyfikatora klienta OAuth 2.0
Wykonaj te czynności, aby zażądać identyfikatora klienta OAuth i skonfigurować go dla swojej aplikacji. W tym przykładzie użyliśmy aplikacji, w której cały proces OAuth jest obsługiwany po stronie serwera, np. takiej jak w naszych 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.
- W menu kliknij 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 aplikacja może uzyskiwać dostęp do interfejsów API Google:
- Aby zidentyfikować identyfikator klienta, wpisz jego nazwę.
W polu Autoryzowane źródła JavaScript wpisz źródło aplikacji. W tym polu nie można używać symboli wieloznacznych.
Możesz podać wiele źródeł, aby umożliwić aplikacji działanie w ramach różnych protokołów, domen lub subdomen. Adresy URL, które wpisujesz, mogą uruchamiać żądanie OAuth.
Poniższy przykład przedstawia adres URL do lokalnego programowania (w naszych przykładach używany jest parametr
localhost:8080) i adres URL produkcyjny.http://localhost:8080 https://myproductionurl.example.comPole Autoryzowany identyfikator URI przekierowania to punkt końcowy, który otrzymuje odpowiedzi od 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 te elementy:
- Identyfikator klienta
- Tajny klucz klienta
Aplikacja może uzyskiwać dostęp do włączonych interfejsów API Google za pomocą tych wartości.
Zanim uruchomisz publiczną aplikację, która uzyskuje dostęp do interfejsów API Zdjęć, musi zostać sprawdzona przez Google. Gdy testujesz aplikację, na ekranie będzie widoczny komunikat „Aplikacja niezweryfikowana” do czasu, aż zostanie zweryfikowana.
Po skonfigurowaniu aplikacji możesz rozpocząć:
Zmiana identyfikatora klienta
Zasoby utworzone za pomocą dowolnego interfejsu API Zdjęć Google można uzyskać lub zmodyfikować tylko za pomocą oryginalnego identyfikatora klienta użytego do ich utworzenia. Jeśli na przykład utworzysz „sesję” w interfejsie Picker API z określonym identyfikatorem klienta, a potem zmienisz ten identyfikator w aplikacji, aplikacja utraci dostęp do wszystkich zasobów interfejsu API utworzonych za pomocą poprzedniego identyfikatora klienta.
Zaplanuj wszystko dokładnie i wybierz odpowiedni typ identyfikatora klienta dla interfejsu Photos API, którego używasz. Zmień identyfikator klienta tylko wtedy, gdy jest to absolutnie konieczne, aby uniknąć problemów z dostępem.