Konfigurowanie aplikacji

Aby zacząć korzystać z interfejsów API Zdjęć Google, skonfiguruj projekt, włączając interfejsy API Zdjęć, których potrzebujesz, w Konsoli interfejsów API Google i konfigurując identyfikator klienta OAuth 2.0.

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ę, uwierzytelnianie i korzystanie z interfejsów API Zdjęć. Interfejsy API Zdjęć nie obsługują kont usługi. Aby korzystać z tych interfejsów API, użytkownicy muszą być zalogowani na prawidłowe konta 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.

  1. Otwórz konsolę interfejsów API Google.
  2. Na pasku menu wybierz projekt lub utwórz nowy.
  3. Aby otworzyć jeden z interfejsów API Zdjęć Google, z menu nawigacyjnego wybierz Interfejsy API i usługi > Biblioteka.
  4. Wyszukaj „Zdjęcia”. Wybierz co najmniej 1 interfejs API Zdjęć i kliknij Włącz.

Zrzut ekranu interfejsów API selektora w konsoli Google Cloud

Prośba o identyfikator klienta OAuth 2.0

Wykonaj te czynności, aby zażądać identyfikatora klienta OAuth i skonfigurować go dla swojej aplikacji. W tym przykładzie korzystamy z aplikacji, w której cały przepływ OAuth jest obsługiwany po stronie serwera, np. ta w naszych przykładach. Proces konfiguracji może się różnić w zależności od scenariuszy implementacji.

  1. Otwórz konsolę interfejsów API Google i wybierz projekt.
  2. W menu kliknij Interfejsy API i usługi > Dane logowania.

  3. Na stronie Dane logowania kliknij Utwórz dane logowania > Identyfikator klienta OAuth.

  4. Wybierz Typ aplikacji. W tym przykładzie typ aplikacji to Aplikacja internetowa.

  5. Zarejestruj źródła, z których aplikacja może uzyskiwać dostęp do interfejsów API Google:

    1. Wpisz nazwę, aby zidentyfikować identyfikator klienta.
    2. 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 aplikacja działała w różnych protokołach, domenach lub subdomenach. Wpisane adresy URL mogą wysyłać żądania OAuth.

    Poniższy przykład zawiera adres URL dla programistów zapisanych lokalnie (w naszych próbkach jest używany atrybut localhost:8080) i adres URL produkcyjny.

        http://localhost:8080
    https://myproductionurl.example.com
    ```

1.  The **Authorized redirect URI** field is the endpoint that receives
    responses from the OAuth 2.0 server. Typically, this includes your
    development environment and points to a path in your application.

```none
    http://localhost:8080/auth/google/callback
    https://myproductionurl.example.com/auth/google/callback
    ```

1.  Click **Create**.

  1. W wyświetlonym oknie klienta OAuth skopiuj te informacje:

    • Identyfikator klienta
    • Tajny klucz klienta

    Aplikacja może uzyskać dostęp do włączonych interfejsów Google API 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 w interfejsie Picker API utworzysz „sesję” z określonym identyfikatorem klienta, a później zmienisz ten identyfikator w swojej aplikacji, aplikacja utraci dostęp do wszystkich zasobów interfejsu API utworzonych przy użyciu 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.