PHP istemci kitaplığını kullanmaya başlama

Google Photos Library API'yi PHP istemci kitaplığıyla kullanmaya başlamak için: istemci kitaplığını geliştirme ortamınızda ayarlayın. Bunu yapmadan önce API'yi etkinleştirerek projenizi yapılandırın. API'yi kullanarak ve OAuth 2.0 istemci kimliği ayarlayarak bu hizmeti test etmenizi öneririz.

Uygulamanız, Google Fotoğraflar ile Google Fotoğraflar kullanıcısı. Örneğin, bir kullanıcının Kullanıcının Google Fotoğraflar kitaplığına medya öğeleri yükleme Google Fotoğraflar hesabından çıkış yapıyorsa kullanıcı, bu API isteklerini OAuth 2.0 protokolüyle uyumlu olması gerekir.

OAuth 2.0 istemci kimliği, uygulama kullanıcılarınızın oturum açma, kimlik doğrulama ve ve dolayısıyla Library API'yi kullanır. Library API tarafından desteklenmez hizmet hesapları; Bu API'yi kullanmak için kullanıcıların geçerli bir Google Hesap'a dokunun.

Uygulamanızı yapılandırma

API'yi etkinleştirme

Library API'yi kullanmadan önce projenizde etkinleştirmeniz gerekir.

  1. Google API Konsolu'na gidin.
  2. Menü çubuğundan bir proje seçin veya yeni proje oluşturun.
  3. Google API Kitaplığı'nı açmak için gezinme menüsünden API'ler ve Hizmetler > Kitaplık.
  4. "Google Photos Library API"yi arayın. Doğru sonucu seçip Etkinleştir.

OAuth 2.0 istemci kimliği isteyin

Aşağıdaki adımları uygulayarak bir OAuth istemci kimliği isteyin ve bunu bir uygulamadır. Bu örnekte, tüm OAuth akışının gerektiği gibi olduğu bir uygulama kullanılıyor. sunucu tarafında işlenenlere benzer. Kurulum işlemi değişiklik gösterebilir göz atın.

  1. Google API Konsolu'na gidin. projenizi seçin.
  2. Menüden API'ler ve Hizmetler > Kimlik Bilgileri.
  3. Credentials (Kimlik Bilgisi) sayfasında Create Credentials > (Kimlik Bilgisi Oluştur) > OAuth istemci kimliği.
  4. Uygulama türünüzü seçin. Bu örnekte, uygulama türü Web uygulaması.
  5. Uygulamanızın Google API'lerine erişmesine izin verilen kaynakları kaydedin. şu şekilde:

    1. İstemci kimliğini tanımlamak için bir ad girin.
    2. Yetkilendirilmiş JavaScript kaynakları alanına uygulamasını indirin. Bu alanda joker karakterlere izin verilmez.

      Uygulamanızın farklı cihazlarda çalışmasına izin vermek için birden fazla kaynak girebilirsiniz alt alan adları olduğunu unutmayın. Girdiğiniz URL'lerin OAuth isteği başlatın.

      Aşağıdaki örnekte, yerel geliştirme URL'si gösterilmektedir (örneklerimiz localhost:8080) ve bir üretim URL'si.

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. Yetkili yönlendirme URI'si alanı, OAuth 2.0 sunucusundan alınan yanıtları. Bunlar genellikle ve uygulamanızdaki bir yola işaret eder.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. Oluştur'u tıklayın.

  1. Açılan OAuth istemcisi iletişim kutusundan JSON dosyasını indirin. içerir. Müşteri ayrıntılarınız şunlardan oluşur: takip etmek için:

    • İstemci Kimliği
    • İstemci gizli anahtarı

    Bu JSON dosyası daha sonra kurulum için kullanılacak bu istemci kitaplığıyla çalışan PHP için Google Auth kitaplığını destekler.

Library API'ye erişen herkese açık bir uygulamayı başlatmadan önce Uygulamanız Google tarafından incelenmelidir. Bir "Doğrulanmamış uygulama" mesajın şurada görünür: test ettiğiniz bir E-posta alırsınız. doğrulanmış olduğundan emin olun.

İstemci kitaplığını oluşturma

PHP istemci kitaplığı, tüm arka uç API çağrılarını sizin için işler ve bazı yaygın API görevleri için kod örnekleri dahil olmak üzere uyumlu nesneler. İlk olarak, aşağıdakilerle birlikte PHP için Google Photos Library API istemci kitaplığını indirip yükleyin: bağımlılıklarını GitHub'dan öğrenin. Ardından, PHP için OAuth2 kimlik bilgilerinizi ayarlayın.

İndirme seçenekleri

composer kullanma kitaplığını geliştirme ortamınıza bağımlılık olarak dahil edebilirsiniz. kitaplığı proje yapılandırmanıza eklemek ve indirmek için bu dosyayı vendor/ dizinine gönderebilirsiniz.

composer require google/photos-library

Alternatif olarak, repository veya sıkıştırılmış bir tarball.

PHP için OAuth2 kimlik bilgilerinizi ayarlama

Bu istemci kitaplığı Google Auth Library PHP. Daha fazla bilgi için OAuth 2.0'ı Google API İstemci Kitaplığı ile kullanma PHP.

Kurulum sırasında kimlik doğrulama kitaplığı tarafından döndürülen kimlik doğrulama bilgilerini kullan PhotosLibraryClient.

Birkaç örnek deneyin

PHP istemci kitaplığını kullanarak ilk API çağrınızı yapmak için aşağıdaki kodu deneyin.

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;
}

Daha fazla GitHub'da samples bir şablondur.