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

Google Fotoğraflar API'lerini 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 kullanıcısı adına Google Fotoğraflar ile etkileşim kurar. Örneğin, bir kullanıcının Google Fotoğraflar kitaplığında albüm oluşturduğunuzda veya kullanıcının Google Fotoğraflar hesabına medya öğeleri yüklediğinizde kullanıcı, bu API isteklerine OAuth 2.0 protokolü üzerinden yetki verir.

OAuth 2.0 istemci kimliği, uygulama kullanıcılarınızın oturum açmasına, kimlik doğrulamasına ve böylece Fotoğraflar API'lerini kullanmasına olanak tanır. Fotoğraflar API'leri hizmet hesaplarını desteklemez. Bu API'yi kullanmak için kullanıcıların geçerli bir Google Hesabı'nda oturum açmış olmaları gerekir.

Uygulamanızı yapılandırma

API'yi etkinleştirme

Fotoğraflar API'lerini kullanabilmek için projenizde etkinleştirmeniz gerekir.

Google API Konsolu'na gidin.
Menü çubuğundan bir proje seçin veya yeni proje oluşturun.
Google API Kitaplığı'nı açmak için Gezinme menüsünden API'ler ve Hizmetler > Kitaplık'ı seçin.
"Google Fotoğraflar API'leri"ni arayın. Doğru sonucu seçin ve Etkinleştir'i tıklayın.

OAuth 2.0 istemci kimliği isteme

Aşağıdaki adımları uygulayarak bir OAuth istemci kimliği isteyin ve bunu kabul edersiniz. 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, diğer uygulama senaryoları için değişiklik gösterebilir.

Google API Konsolu'na gidin. projenizi seçin.
Menüden API'ler ve Hizmetler > Kimlik Bilgileri'ni seçin.
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayın.
Uygulama türünüzü seçin. Bu örnekte uygulama türü Web uygulamasıdır.
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şlatmasına izin verilir.
  
  Aşağıdaki örnekte bir yerel geliştirme URL'si gösterilmektedir (örneklerimiz localhost:8080) ve bir üretim URL'si.
```
http://localhost:8080
https://myproductionurl.example.com
```
3. Yetkilendirilmiş yönlendirme URI'si alanı, OAuth 2.0 sunucusundan yanıt alan uç noktadır. 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.

Ortaya çıkan OAuth istemci iletişim kutusunda, istemci yapılandırmanızı içeren JSON dosyasını indirin. 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 bu istemci kitaplığıyla çalışan PHP için Google Kimlik Doğrulama kitaplığını kurmak amacıyla kullanılır.

Fotoğraflar API'lerine erişen herkese açık bir uygulamayı kullanıma sunmadan ö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 de dahil olmak üzere uyumlu nesneler. Öncelikle, PHP için Google Fotoğraflar API'leri istemci kitaplığını ve bağımlılıklarını GitHub'dan indirip yükleyin. 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 vendor/ dizinine indirmek için aşağıdaki komutu çalıştırın.

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 PHP için Google API İstemci Kitaplığı ile OAuth 2.0'ı kullanma başlıklı makaleyi inceleyin.

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

Bazı örnekleri 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.

PHP istemci kitaplığını kullanmaya başlama Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.