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.
- Otwórz konsolę interfejsów API Google.
- Na pasku menu wybierz projekt lub utwórz nowy.
- Aby otworzyć bibliotekę interfejsów API Google, w menu nawigacyjnym wybierz Interfejsy API Usługi > Biblioteka.
- 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 po stronie serwera, jak w przykładach. Proces konfiguracji może się różnić w przypadku innych scenariuszy implementacji.
- Otwórz konsolę interfejsów API Google. i wybierz swój projekt.
- Z menu wybierz Interfejsy API i Usługi > Dane logowania.
- Na stronie Credentials (Dane logowania) kliknij Create Credentials (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 w następujący sposób:
- Wpisz nazwę, aby zidentyfikować identyfikator klienta.
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
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
Kliknij Utwórz.
-
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.