Wprowadzenie do biblioteki klienta w języku PHP

Aby zacząć korzystać z interfejsów API Zdjęć Google z biblioteką klienta PHP, musisz skonfigurować bibliotekę klienta w środowisku programistycznym. Zanim to zrobisz, skonfiguruj projekt, włączając interfejs API w 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żytkownik Zdjęć Google. Gdy na przykład tworzysz albumy w bibliotece Zdjęć Google użytkownika lub przesyłasz elementy multimedialne na jego konto Zdjęć Google, użytkownik autoryzuje te żądania interfejsu API za pomocą protokołu OAuth 2.0.

Identyfikator klienta OAuth 2.0 pozwala użytkownikom aplikacji logować się, uwierzytelniać i tym samym używają interfejsów API Zdjęć. Interfejsy API Zdjęć Google nie obsługują konta usługi; aby korzystać z tego interfejsu API, użytkownicy muszą być zalogowani na Konto.

Konfiguracja aplikacji

Włącz API

Aby móc korzystać z interfejsów API Zdjęć, musisz je włączyć 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 „Zdjęcia Google API”. Wybierz właściwy wynik i kliknij Włącz.

Prośba o identyfikator 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 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 przypadku innych 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 w następujący sposób:

    1. Wpisz nazwę, aby zidentyfikować identyfikator klienta.

    2. W polu Autoryzowane źródła JavaScriptu 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ły, domeny i subdomeny. Adresy URL, które wpisujesz, mogą uruchamiać żą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. Zwykle obejmuje to środowisko programistyczne 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 publiczną aplikację, która uzyskuje dostęp do interfejsów API Zdjęć, Twoja aplikacja musi zostać sprawdzona przez Google. Podczas testowania aplikacji na ekranie będzie widoczny komunikat „Aplikacja niezweryfikowana” do czasu, aż zweryfikujesz aplikację.

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 interfejsów API Zdjęć Google dla języka PHP zależności z GitHub. Następnie skonfiguruj dane logowania OAuth2 dla PHP.

Opcje pobierania

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

composer require google/photos-library

Możesz też skopiować repozytorium lub pobrać skompresowany plik tarball.

Konfigurowanie danych logowania OAuth2 w 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 przykłady w GitHubie do wypróbowania.