Google Fotoğraflar API'leriyle ilgili güncellemeler

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:
  • photoslibrary.appendonly
Kaldırılan kapsamlar:
  • photoslibrary
  • photoslibrary.sharing
Kalan kapsamlar:
  • photoslibrary.readonly.appcreateddata
Kaldırılan kapsamlar:
  • photoslibrary
  • photoslibrary.readonly
Bu yöntemler artık kullanılamayacak. Kalan kapsamlar:
  • Yok
Kaldırılan kapsamlar:
  • photoslibrary.sharing
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:
  • photoslibrary.appendonly
  • photoslibrary.edit.appcreateddata
Kaldırılan kapsamlar:
  • photoslibrary
Kalan kapsamlar:
  • photoslibrary.edit.appcreateddata
Kaldırılan kapsamlar:
  • photoslibrary
Bu yöntemlerde herhangi bir değişiklik yapılmayacaktır. Kalan kapsamlar:
  • photoslibrary.edit.appcreateddata
Kaldırılan kapsamlar:
  • Yok

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:
  • 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.