Wprowadzenie do biblioteki klienta w języku PHP

Aby zacząć korzystać z interfejsu Google Photos Library API z biblioteką klienta PHP, wykonaj te czynności: Skonfiguruj bibliotekę klienta w środowisku programistycznym. Zanim to zrobisz, skonfiguruj projekt, włączając interfejs API. za pomocą Konsoli interfejsów API Google i skonfigurować identyfikator klienta OAuth 2.0.

Twoja aplikacja wchodzi w interakcję ze Zdjęciami Google w imieniu Użytkownik Zdjęć Google. Jeśli na przykład utworzysz albumy w w bibliotece Zdjęć Google ani przesyłać elementów multimedialnych do folderu użytkownika; konta Zdjęć Google, użytkownik autoryzuje te żądania do interfejsu API za pomocą Protokół OAuth 2.0.

Identyfikator klienta OAuth 2.0 pozwala użytkownikom aplikacji logować się, uwierzytelniać i tym samym używać interfejsu Library API. Interfejs Library API nie obsługuje konta usługi; aby korzystać z tego interfejsu API, użytkownicy muszą być zalogowani na Konto.

Konfiguracja aplikacji

Włącz API

Zanim użyjesz interfejsu Library API, musisz włączyć go w swoim projekcie.

  1. Otwórz konsolę interfejsów API Google.
  2. Na pasku menu wybierz projekt lub utwórz nowy.
  3. Aby otworzyć bibliotekę interfejsów API Google, w menu nawigacyjnym wybierz Interfejsy API Usługi > Biblioteka.
  4. Wyszukaj „Google Photos Library API”. Wybierz właściwy wynik i kliknij Włącz.

Żądanie identyfikatora klienta OAuth 2.0

Wykonaj poniższe 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 po stronie serwera, jak w przykładach. Proces konfiguracji może się różnić w przypadku innych scenariuszy implementacji.

  1. Otwórz konsolę interfejsów API Google. i wybierz swój projekt.
  2. Z menu wybierz Interfejsy API i Usługi > Dane logowania.
  3. Na stronie Credentials (Dane logowania) kliknij Create Credentials (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 w następujący sposób:

    1. Wpisz nazwę, aby zidentyfikować identyfikator klienta.
    2. W polu Autoryzowane źródła JavaScript wpisz źródło źródła . 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ły, domeny i subdomeny. Wpisane adresy URL mogą i uruchomić żądanie OAuth.

      W poniższym przykładzie pokazano adres URL na potrzeby lokalnego programowania (w naszych przykładach użyto localhost:8080) i produkcyjny adres URL.

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. Pole Autoryzowany identyfikator URI przekierowania to punkt końcowy, który odbiera z serwera OAuth 2.0. Zazwyczaj są to i wskazuje ścieżkę w aplikacji.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. Kliknij Utwórz.

  1. W wyświetlonym oknie klienta OAuth pobierz plik JSON. zawierający konfigurację klienta. Na dane klienta składają się: :

    • Identyfikator klienta
    • Tajny klucz klienta

    Ten plik JSON zostanie użyty później do konfiguracji biblioteki Google Auth dla języka PHP, która współpracuje z tą biblioteką klienta.

Zanim uruchomisz aplikację publiczną, która uzyskuje dostęp do interfejsu Library API, Twoja aplikacja musi zostać sprawdzona przez Google. „Niezweryfikowana aplikacja” w podczas testowania aplikacji, aż stanie się zweryfikowane.

Konfigurowanie biblioteki klienta

Biblioteka klienta PHP obsługuje za Ciebie wszystkie wywołania interfejsu API backendu i udostępnia łatwe do wykorzystania obiekty, w tym przykłady kodu do typowych zadań interfejsu API. Najpierw pobierz i zainstaluj bibliotekę klienta interfejsu Google Photos Library API dla języka PHP oraz zależności z GitHub. Następnie skonfiguruj dane logowania OAuth2 dla PHP.

Opcje pobierania

Użyj narzędzia composer. , aby uwzględnić bibliotekę jako zależność w środowisku programistycznym. Użycie to polecenie, aby dodać bibliotekę do konfiguracji projektu i pobrać do katalogu vendor/.

composer require google/photos-library

Możesz też sklonuj lub pobierz skompresowany

Konfigurowanie danych logowania OAuth2 na potrzeby PHP

Ta biblioteka kliencka działa z Biblioteka uwierzytelniania Google dla PHP. Aby dowiedzieć się więcej, znajdziesz w artykule Używanie OAuth 2.0 z biblioteką klienta interfejsów API Google do PHP.

Podczas konfiguracji użyj danych uwierzytelniających zwróconych przez bibliotekę uwierzytelniania PhotosLibraryClient.

Wypróbuj kilka przykładów

Wypróbuj poniższy kod, aby wykonać pierwsze wywołanie interfejsu API za pomocą biblioteki klienta PHP.

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

Jest więcej samples w GitHubie do wypróbowania.