Eylül 2024'te yayınlanmıştır.
Bu sayfada, Google Fotoğraflar API'lerinde yapılan belirli değişikliklerle ilgili ayrıntılı bilgiler verilmektedir. Kullandığınız yöntemlerin ve kapsamların nasıl etkilenebileceğini anlamak için bu sayfadaki ayrıntıları inceleyin. Bu değişikliklerin duyurusu hakkında daha fazla bilgiyi ilgili blog yayınında bulabilirsiniz.
Kitaplık API'si: Yaygın kullanım alanları üzerindeki etkisi
Aşağıdaki bölümlerde, yaklaşan değişikliklerin yaygın kullanım alanlarını nasıl etkileyeceği ayrıntılı olarak açıklanmıştır.
Medya öğeleri yükleme ve albüm oluşturma
Neler değişiyor? Değişiklik yok. photoslibrary.appendonly
kapsamını kullanarak medya öğeleri yüklemeye ve albüm oluşturmaya devam edebilirsiniz.
Yapabilecekleriniz:
Uygulamanız medya öğeleri yüklüyor veya albüm oluşturuyorsa photoslibrary
kapsamını değil, photoslibrary.appendonly
kapsamını kullandığınızdan emin olun. photoslibrary
kapsamı kaldırılıyor.
Medya öğelerini ve albümleri listeleme, arama ve alma
Neler değişiyor? Artık yalnızca uygulamanız tarafından oluşturulan albümleri ve medya öğelerini listeleyebilir, arayabilir ve alabilirsiniz.
Yapabilecekleriniz:
- Uygulamanızın, 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, kullanıcıların belirli içeriklere erişim izni vermesi için güvenli ve kullanıcı dostu bir yöntem sunar.
- Uygulamanız, kullanıcının kitaplığının tamamına erişmek için tasarlandıysa uygulamanızı yeniden değerlendirmeniz veya alternatif yaklaşımlar düşünmeniz gerekebilir.
Paylaşım ve paylaşılan albümler
Neler değişiyor? Paylaşılan albümler ve ilişkili API işlevleri (paylaş, paylaşmayı iptal et, al, katıl, ayrıl ve listele), 31 Mart 2025'ten sonra 403 PERMISSION_DENIED
döndürecek.
Yapabilecekleriniz:
Kullanıcıları, paylaşımı kendileri yönetmeleri için Google Fotoğraflar uygulamasına yönlendirin. Uygulamanızda, kullanıcılara yol göstermek için net talimatlar veya derin bağlantılar sağlayabilirsiniz.
Uygulama tarafından oluşturulan albümleri yönetme: zenginleştirmeler ve albüm içerikleri
Neler değişiyor? Kavramsal tutarlılık için photoslibrary.edit.appcreateddata
, aşağıdaki üç yönteme eklenmektedir:
albums.addEnrichment
albums.batchAddMediaItems
albums.batchRemoveMediaItems
Yapabilecekleriniz:
- Uygulamanız bu yöntemleri zaten kullanıyorsa yetkilendirme sürecinizi basitleştirmek için
photoslibrary.edit.appcreateddata
kapsamını kullanmayı düşünebilirsiniz.
Library API: Etkilenen kapsamlar ve yöntemler
Google Fotoğraflar API'lerinde yaptığımız değişiklikler kapsamında aşağıdaki güncellemeleri yaptık.
Güncellenen Yetkilendirme sayfasında gösterildiği gibi, aşağıdaki kapsamlar 31 Mart 2025'ten sonra Library API'den kaldırılacaktır:
photoslibrary.readonly
photoslibrary.sharing
photoslibrary
Aşağıdaki kapsamlar geçerli olmaya devam edecek:
photoslibrary.appendonly
photoslibrary.readonly.appcreateddata
photoslibrary.edit.appcreateddata
Bu tablolarda, etkilenen belirli Kitaplık API yöntemleri ve kapsamları ayrıntılı olarak açıklanmıştı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. | Kalan kapsamlar:
|
|
Kalan kapsamlar:
|
||
Bu yöntemler artık kullanılamayacak. | Kalan kapsamlar:
|
|
Bu yöntemlere photoslibrary.edit.appcreateddata eklenir. Bu yöntemler artık yalnızca uygulamanız tarafından oluşturulan albümler ve medya öğeleriyle kullanılabilir. |
Kalan kapsamlar:
|
|
Kalan kapsamlar:
|
||
Bu yöntemlerde herhangi bir değişiklik yapılmayacaktır. | Kalan kapsamlar:
|
Fotoğraflar 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 Politikası ile değiştirilecek. Yeni politika şu anda önizlenebilir.
Fotoğraflar API dokümanlarında yapılan güncellemeler
Yaklaşan güncellemeleri yansıtmak ve geliştirme deneyiminizi desteklemek için Fotoğraflar API dokümanlarında önemli değişiklikler yaptık:
- Birleştirilmiş Fotoğraflar API'leri Sitesi: Tüm Fotoğraflar API kaynaklarını tek bir yerde (bu site) birleştirerek geliştiricilere kolaylaştırılmış bir deneyim sunuyoruz. Burada şunları bulabilirsiniz:
- Merkezi Kaynaklar: Hem Picker API hem de Library API için kurulum talimatları ve genel kullanım kılavuzu ile destek ve politika bilgileri
- Ö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 Kitaplık API İçeriği: Kitaplık API dokümanları, kullanımdan kaldırma döneminden sonraki Kitaplık API'nin özelliklerini yansıtacak şekilde düzeltildi.
- Eski dokümanlar korundu: Mevcut entegrasyonlarını taşıması gereken geliştiriciler için orijinal Kitaplık API dokümanlarını koruduk. Yeni bir proje başlatıyorsanız güncellenen dokümanları kullanın. Mevcut bir projeyi güncelliyorsanız taşıma işlemi sırasında gerektiğinde hem eski hem de güncellenmiş dokümanlara bakın.
Sık sorulan sorular
Google Fotoğraflar API'lerinde neler değişecek?
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. Fotoğraf seçimi için Kitaplık API'yi kullanan mevcut entegrasyonlara sahip olan herkesi, en kısa sürede Picker API'ye geçmeye teşvik ediyoruz.
Library API bu durumdan nasıl etkilenecek?
photoslibrary.readonly
, photoslibrary.sharing
ve photoslibrary
kapsamları kaldırılacak. Yalnızca bu kapsamlara dayanan API çağrıları, 31 Mart 2025'ten sonra 403 PERMISSION_DENIED
döndürür. Diğer bazı çağrılar, yalnızca uygulamanız tarafından oluşturulan fotoğraf ve videolarla çalışmakla sınırlandırılır.
Değişikliklerin tamamını bu sayfadaki etkilenen kapsamlar ve yöntemler tablosunda 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 aşağıdaki adımları uygulamanızı öneririz:
- Fotoğraf seçimi için: Google Fotoğraflar Picker API'ye geçin.
- Diğer işlevler için: Değişiklikleri anlamak ve uygulamanızda artık kullanılamayabilecek özellikleri belirlemek üzere güncellenmiş Library API belgelerini inceleyin. Uygulamanızın işlevini ayarlamanız veya bazı kullanım alanları için alternatif çözümler keşfetmeniz gerekebilir.
Google Fotoğraflar Picker API nedir?
Picker API, geliştiricilerin kullanıcıların Google Fotoğraflar kitaplıklarından fotoğraf ve video seçmesine ve bunları sorunsuz bir şekilde uygulamanıza geri göndermesine olanak tanıyan yeni ve güvenli bir yöntemdir.
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 sunulur.
Sitemizdeki belgelerin geri kalanı, güncellenen API'leri yansıtacak şekilde güncellendi.
Değişiklikler bu blog yayınında duyuruldu.
Başka sorularım varsa veya uygulamamı taşıma konusunda yardıma ihtiyacım olursa ne yapmalıyım?
Geliştirici dokümanlarıyla ilgili sorularınız varsa yardım almayla ilgili daha fazla bilgi için destek sayfamızı inceleyin.