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:
- İstemci kimliğini tanımlamak için bir ad girin.
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
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
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.
git clone https://github.com/google/java-photoslibrary.git
çalıştır komut istemi.- Bir
java-photoslibrary
dizini alırsınız. Bu sayfaya gitmek içincd java-photoslibrary
- 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.