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

Google Photos Library API'yi Java 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.

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.
"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.

Google API Konsolu'na gidin. projenizi seçin.
Menüden API'ler ve Hizmetler > Kimlik Bilgileri.
Credentials (Kimlik Bilgisi) sayfasında Create Credentials > (Kimlik Bilgisi Oluştur) > OAuth istemci kimliği.
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, 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.

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.

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

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 dahil olmak üzere uyumlu nesneler. İlk olarak, Java için Google Photos Library API istemci kitaplığını indirip yükleyin GitHub'daki bağımlılıklarla değiştirin. 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 aşağıdaki bağımlılığı Gradle'a ekleyin: build.gradle dosyası yükleyin.
```
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ıkta değişiklik yapmak veya katkıda bulunmak isterseniz örneklerimizi denemeye karar verebilirsiniz. Google Takvim widget'ını kod deposunu klonladıktan sonra, bu depodaki tüm dosyalar indirilir.
1. git clone https://github.com/google/java-photoslibrary.git çalıştır komut istemi.
2. Bir java-photoslibrary dizini alırsınız. Bu sayfaya gitmek için cd java-photoslibrary
3. IDE'nizde build.gradle dosyasını açın veya ./gradlew assemble öğesini şurada çalıştırın: komut istemini kullanmanız gerekir. Görmek için ./gradlew tasks adresini ziyaret edin kullanılabilir görevlerdir.

Java için OAuth2 kimlik bilgilerinizi ayarlama

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

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
}

Daha fazla örnek var. ziyaret edebilirsiniz.

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