Google Fotoğraflar API'leriyle ilgili güncellemeler

Yayınlanma tarihi: Eylül 2024.

Bu sayfada, Google Fotoğraflar'da yapılan belirli değişiklikler hakkında ayrıntılı bilgi verilmektedir. API'ler. Yöntemlerin ve kapsamların nasıl performans gösterdiğini anlamak için bu değişiklikten etkilenebilir. Bu değişikliklerin duyurusu hakkında daha fazla bilgiyi ilgili blog yayınında bulabilirsiniz.

Not: Tüm değişiklikler Mart 2025'ten itibaren geçerli olacaktır.

Library API: Yaygın kullanım alanlarına etkisi

Aşağıdaki bölümlerde, yapılacak değişikliklerin yaygın kullanım üzerindeki etkisi ayrıntılı olarak açıklanmaktadır durumlarda işe yarar.

Medya öğeleri yükleme ve albüm oluşturma

Neler değişiyor? Değişiklik yok. Medya öğelerini yüklemeye ve photoslibrary.appendonly kapsamını kullanarak albümler oluşturabilirsiniz.

Ne yapabilirsiniz?

Uygulamanız medya öğeleri yüklüyor veya albüm oluşturuyorsa photoslibrary kapsamı değil, photoslibrary.appendonly kapsamı. photoslibrary kapsamı kaldırılıyor.

Medya öğelerini ve albümleri listeleme, arama ve alma

Neler değişiyor? Artık yalnızca albümleri ve albümleri medya öğeleri (uygulamanız tarafından oluşturulan)

Ne yapabilirsiniz?

• Uygulamanızda kullanıcıların kitaplıklarının tamamından fotoğraf veya albüm seçmesi gerekiyorsa yeni Google Fotoğraflar Picker API'yi kullanın. Bu sayede hem kullanıcı dostu bir yol izleyerek belirli içeriklere erişim izni verebilir.
• Uygulamanız, kullanıcının tüm kitaplığına erişmeyi gerektiriyorsa şunları yapmanız gerekebilir: uygulamanızı tekrar değerlendirin veya alternatif yaklaşımlar düşünün.

Paylaşım ve paylaşılan albümler

Neler değişiyor? Paylaşılan albümler ve ilişkili API işlevleri (paylaşım, paylaşımı iptal et, al, katıl, ayrıl ve listele) sonra bir 403 PERMISSION_DENIED döndürecektir 31 Mart 2025.

Yapabilecekleriniz:

Kullanıcıları, paylaşımı kendileri yönetmeleri için Google Fotoğraflar uygulamasına yönlendirin. Şunları yapabilirsiniz: Uygulamanızda onlara yol gösterecek net talimatlar veya derin bağlantılar sağlayın.

Uygulama tarafından oluşturulan albümleri yönetme: zenginleştirmeler ve albüm içerikleri

Neler değişiyor? photoslibrary.edit.appcreatedata şuna ekleniyor: kavramsal tutarlılık için aşağıdaki üç yöntemden bahsedeceğiz:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

Ne yapabilirsiniz?

• Uygulamanızda zaten bu yöntemler kullanılıyorsa Yetkilendirmenizi basitleştirmek için photoslibrary.edit.appcreatedata kapsam bahsedeceğim.

Library API: Etkilenen kapsamlar ve yöntemler

Google Fotoğraflar API'lerinde yaptığımız değişiklikler kapsamında aşağıdaki işlemleri yaptık: güncellemelerine göz atın.

Güncellenen Yetkilendirme belgesinde gösterildiği gibi sayfasında 31 Mart 2025'ten sonra Library API'den kaldırılacaktır:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Aşağıdaki kapsamlar kalacaktır:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

Bu tablolarda, etkilenen belirli Library API yöntemleri ve kapsamları ayrıntılı olarak açıklanmaktadır.

Güncellemeler	Yöntemler	Kapsamlar
Bu yöntemler artık yalnızca uygulamanız tarafından oluşturulan albümler ve medya öğeleriyle kullanılabilir. Buna, Picker API ile seçilen ve kullanıcının Library API ile kitaplığına eklenen medya öğeleri dahildir.	albums.create mediaItems.batchCreate	Kalan kapsamlar: photoslibrary.appendonly Kaldırılan kapsamlar: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Kalan kapsamlar: photoslibrary.readonly.appcreatedata Kaldırılan kapsamlar: photoslibrary photoslibrary.readonly
Bu yöntemler artık kullanılamayacaktır.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Kalan kapsamlar: Yok Kaldırılan kapsamlar: photoslibrary.sharing Not: sharedAlbums.list, uygulamanız tarafından oluşturulan paylaşılan albümler artık listelenmeyeceğinden kaldırılıyor.
Bu yöntemlere photoslibrary.edit.appcreatedata eklenir. Bu yöntemler artık yalnızca uygulamanız tarafından oluşturulan albümler ve medya öğeleriyle kullanılabilir. Buna, Picker API ile seçilen ve kullanıcının Library API ile kitaplığına eklenen medya öğeleri dahildir.	albums.addEnrichment albums.batchAddMediaItems	Kalan kapsamlar: photoslibrary.appendonly photoslibrary.edit.appcreatedata Kaldırılan kapsamlar: photoslibrary
	albums.batchRemoveMediaItems	Kalan kapsamlar: photoslibrary.edit.appcreatedata Kaldırılan kapsamlar: photoslibrary
Bu yöntemlerde herhangi bir değişiklik yapılmayacaktır.	albums.patch mediaItems.patch	Kalan kapsamlar: photoslibrary.edit.appcreatedata Kaldırılan kapsamlar: Yok

Photos API politikasında yapılan güncellemeler

Mevcut Kabul Edilebilir Kullanım Politikası 31 Mart 2025'ten sonra yeni Photos API Kullanıcı Verileri ve Geliştirici Politika. Yeni politikayı önizle.

Photos API belgelerinde yapılan güncellemeler

Photos API dokümanlarında bazı değişiklikleri yaptık: daha fazla bilgi edinip geliştirme deneyiminizi destekleyebilirsiniz:

• Birleştirilmiş Fotoğraflar API'leri Sitesi: Tüm Photos API kaynaklarını bir araya getirdik tek ve uygun bir konuma (bu site) sunarak çok çaba sarf etti. Buradan:
  • Merkezi Kaynaklar: Birleştirilmiş kurulum talimatları ve genel kullanım rehberliği ve destek ve politika bilgilerini seçici API'yi ve Library API'yi kullanıyor.
  • Özel API siteleri: Picker API ve Library API ile ilgili ayrıntılı kılavuzlar, referans dokümanları ve kod örnekleri içeren ayrı siteler
• Güncellenen Library API İçeriği: Library API dokümanları kullanımdan kaldırıldıktan sonraki yeteneklerini yansıtacak şekilde yeniden düzenlendi. Güncellenen belgelerde, değiştirilen veya kaldırılan içerik (ilgili eski içeriklerin bağlantılarıyla birlikte) referans olması gerekir.
• Korunan Eski Belgeler: Orijinal Library API'yi koruyoruz. belgelerinden yararlanın. mevcut entegrasyonları taşımanız gerekir. Yeni bir projeye başlıyorsanız güncellenen belgeleri inceleyin. Eğer mevcut bir projeyi güncelliyorsanız hem eski hem de güncellenmiş sürüm gerektiği şekilde kontrol edin.

Sık sorulan sorular

Google Fotoğraflar API'leriyle ilgili değişiklikler

Güvenli fotoğraf seçimi için yeni Google Fotoğraflar Picker API'yi kullanıma sunuyoruz ve mevcut Kitaplık API'yi, uygulamanız tarafından oluşturulan fotoğraf ve videoları yönetmeye odaklanacak şekilde güncelliyoruz.

Bu değişiklikler ne zaman geçerli olacak?

Bu değişiklikler 31 Mart 2025'ten itibaren geçerli olacak. Projeye katılan herkesi Taşımak için fotoğraf seçme işlemi için Library API'yi kullanan mevcut entegrasyonlar en kısa sürede Picker API'sını kullanmaya başlayın.

Library API nasıl etkilenecek?

photoslibrary.readonly, photoslibrary.sharing ve photoslibrary kapsamlar kaldırılacak. Yalnızca bu kapsamlara dayanan API çağrıları 403 PERMISSION_DENIED Birçok diğer çağrı yalnızca çalışmayla kısıtlanacak uygulamanız tarafından oluşturulan fotoğraf ve videolarla.

Değişikliklerin tamamını bu sayfanın üst kısmındaki tabloda inceleyebilirsiniz.

Uygulamam şu anda etkilenen kapsamları veya yöntemleri kullanıyorsa ne yapmalıyım?

Uygulamanız etkilenen kapsamlardan veya yöntemlerden herhangi birini kullanıyorsa şunu yapmanızı öneririz: şu adımları uygulayın:

• Fotoğraf seçimi için: Google Fotoğraflar Seçici API'sine geçin.
• Diğer işlevler için: Güncellenen Library API dokümanlarını inceleyerek değişiklikleri anlayın ve uygulamanızda artık işlerliğini yitirmeyecek özellikleri belirleyin kullanılabilir. Uygulamanızın işlevlerini ayarlamanız veya gibi bazı kullanım alanları için alternatif çözümler sunmak.

Google Fotoğraflar Seçici API nedir?

Picker API'si, geliştiriciler tarafından kullanıcıların fotoğraf seçmesine olanak tanıyan yeni ve güvenli bir yöntemdir. ve albümlere kolayca geri gönderebilirler. en iyi yoludur. Picker API'si, güçlü fotoğraf seçme özellikleri sunar. öğeleri tek tek seçme, albümdeki tüm öğeleri seçme ve Google Fotoğraflar Kitaplığı'nda arama yapıyor.

Bu değişiklikler hakkında daha fazla bilgiyi nerede bulabilirim?

Şu anda görüntülemekte olduğunuz bu sayfada tüm değişikliklere genel bir bakış ve özet sunulmaktadır.

Sitemizdeki diğer dokümanlar, güncellenen API'leri yansıtacak şekilde güncellendi.

Bu blog yayını bir duyurudur.

Başka sorularım veya uygulamamı taşımayla ilgili yardıma ihtiyacım olursa ne yapabilirim?

Geliştirici belgeleriyle ilgili sorularınız varsa destek makalemizi inceleyin sayfasına göz atın.