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

Google Fotoğraflar API'lerini Java istemci kitaplığıyla kullanmaya başlamak için geliştirme ortamınızda istemci kitaplığını ayarlamanız gerekir. Bunu yapmadan önce, Google API Konsolu üzerinden API'yi etkinleştirip bir OAuth 2.0 istemci kimliği oluşturarak projenizi yapılandırın.

Uygulamanız, Google Fotoğraflar ile Google Fotoğraflar kullanıcısı. Ö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çma, kimlik doğrulama ve ve dolayısıyla Fotoğraflar API'lerini kullanır. Photos API'leri 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

Photos API'lerini kullanmadan önce projenizde etkinleştirmeniz gerekir.

Google API Konsolu'na gidin.
Menü çubuğundan bir proje seçin veya yeni bir proje oluşturun.
Google API Kitaplığı'nı açmak için gezinme menüsünden API'ler ve Hizmetler > Kitaplık.
"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 isteyin

OAuth istemci kimliği istemek ve uygulamanız için yapılandırmak üzere aşağıdaki adımları uygulayın. 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.

Google API Konsolu'na gidin. projenizi seçin.
Menüden API'ler ve Hizmetler > Kimlik Bilgileri.
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ı.
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 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.

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 Java için Google Auth kitaplığını destekler.

Fotoğraflar API'lerine erişen herkese açık bir uygulamayı kullanıma sunmadan önce Uygulamanız Google tarafından incelenmelidir. Uygulamanızı test ettiğinizde, doğrulanana kadar ekranda "Doğrulanmamış uygulama" mesajı gösterilir.

İstemci kitaplığını ayarlama

Java istemci kitaplığı tüm arka uç API çağrılarını sizin yerinize işler ve bazı yaygın API görevleri için kod örnekleri de dahil olmak üzere uyumlu nesneler. Öncelikle, Java için Google Fotoğraflar API'leri istemci kitaplığını ve bağımlılıklarını GitHub'dan indirip yükleyin. Ardından, Java için OAuth2 kimlik bilgilerinizi ayarlayın.

İndirme seçenekleri

İstemci kitaplığını indirmek için aşağıdaki seçenekleri kullanabilirsiniz:

Gradle bağımlılığı:

Bu kitaplığı Gradle ile kullanmak için build.gradle dosyanıza aşağıdaki bağımlılık ekleyin.

repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}

Maven bağımlılığı:

Bu kitaplığı Maven ile kullanmak için aşağıdakileri Maven'e (pom.xml) ekleyin dosyası olarak kaydedebilirsiniz.

<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>

Bir sürümü indirme:

Sürümler sayfası her kitaplık sürümü için farklı yapılar içerir (jar dosyaları dahil).
Depoyu klonlama:

Bu kitaplığı değiştirmek veya kitaplığa katkıda bulunmak (ör. çekme isteği göndermek) istiyorsanız ya da örneklerimizi denemek istiyorsanız bu yöntemi kullanın. Google Takvim widget'ını kod deposunu klonladıktan sonra, bu depodaki tüm dosyalar indirilir.
1. Komut isteminde git clone https://github.com/google/java-photoslibrary.git dosyasını çalıştırın.
2. Bir java-photoslibrary dizini alırsınız. cd java-photoslibrary çalıştırarak bu sayfaya gidin.
3. IDE'nizde build.gradle dosyasını açın veya ./gradlew assemble öğesini şurada çalıştırın: komut istemini kullanmanız gerekir. Kullanılabilir görevleri görmek için ./gradlew tasks bölümüne bakın.

Java için OAuth2 kimlik bilgilerinizi ayarlama

Bu istemci kitaplığı, Google Auth Kitaplığı ile Java. Daha fazla bilgi için Java için Google API İstemci Kitaplığı ile OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

Aşağıdaki durumlarda CredentialsProvider içinde istemci OAuth yapılandırmanızı belirtin: PhotosLibraryClient nesnesi için PhotoLibrarySettings oluşturuluyor.

Birkaç örnek deneyin

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

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

GitHub'da denemeniz için daha fazla örnek vardır.

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