Library API'yi kullanmaya başlama

Library API, kullanıcılarınızın Google Fotoğraflar kitaplıklarındaki fotoğraflar, videolar ve albümlerle etkileşimde bulunmanıza olanak tanır. Ancak, yalnızca uygulamanız tarafından oluşturulan içeriğe erişip bunları yönetebilirsiniz.

Başlamadan önce

• Genel bakışı inceleyin: Library API'nin kullanım alanınıza uygun olduğundan emin olmak için Picker API ile Library API'yi karşılaştırın.
• Uygulamanızı yapılandırın: API'yi etkinleştirin ve kimlik doğrulamayı ayarlayın. Ayrıntılı adımları Uygulamanızı yapılandırma başlıklı makalede bulabilirsiniz.

Kitaplık API'sinin temel kullanım alanları

Kitaplık API'si, uygulamanızın aşağıdakileri yapması gereken senaryolar için idealdir:

• Medya yükleme ve depolama: Fotoğraf ve videoları (uygulamanız tarafından oluşturulan) kullanıcılarınızın Google Fotoğraflar kitaplıklarına güvenli bir şekilde aktarın.
• İçeriği düzenleyin: Kullanıcıların uygulamayla ilgili medyalarını düzenlemelerine yardımcı olmak için albümler oluşturun ve yönetin.
• Fotoğrafları ve albümleri iyileştirme: Başlıklar, açıklamalar veya konum bilgileri gibi zenginleştirmeler aracılığıyla medya öğelerine ve albümlere bağlam bilgisi ekleyin.
• Uygulamanın oluşturduğu verilere erişme: Uygulamanızın daha önce oluşturduğu fotoğraf, video ve albümleri alıp bunlarla etkileşime geçebilirsiniz.

Tipik Kitaplık API iş akışı

Kitaplık API'si çeşitli işlevler sunsa da yaygın bir iş akışı aşağıdaki adımları içerebilir:

1. Medya yükleme: Fotoğraf veya video baytlarını Google Fotoğraflar'a güvenli bir şekilde yüklemek için uploads uç noktasını kullanın. Bu adımda bir uploadToken oluşturulur.

2. Medya öğeleri oluşturma: Kullanıcının kitaplığında medya öğeleri oluşturmak için uploadToken sağlayan mediaItems.batchCreate yöntemini kullanın.

3. Albüm oluşturma (isteğe bağlı): Medya öğelerini düzenlemek için kullanıcının kitaplığında albüm oluşturmak üzere albums.create yöntemini kullanın.

4. Albümleri yönetme:

   • albums.batchAddMediaItems kullanarak albümlere medya öğeleri (uygulamanız tarafından oluşturulan) ekleyin.
   • albums.batchRemoveMediaItems simgesini kullanarak medya öğelerini albümlerden kaldırın.
   • albums.addEnrichment simgesini kullanarak albümlere zenginleştirmeler (başlıklar veya konumlar gibi) ekleyin.
   • albums.get kullanarak belirli albümlerle ilgili bilgileri alın.
   • albums.list kullanarak uygulamanız tarafından oluşturulan albümleri listeleyin.

5. Uygulama tarafından oluşturulan medyaya erişme:

   • mediaItems.get veya mediaItems.batchGet kullanarak belirli medya öğeleriyle ilgili ayrıntıları alın.
   • mediaItems.search ile uygulamanız tarafından oluşturulan medya öğelerini arayın.
   • Albüm kimliğiyle birlikte mediaItems.search kullanarak uygulama tarafından oluşturulan belirli bir albümdeki medya öğelerini listeleyin.

Sonraki adımlar

• Referans dokümanlarını inceleyin: Mevcut tüm yöntemler ve parametreler hakkında bilgi edinmek için ayrıntılı Library API referans belgelerini inceleyin.
• Örnekleri deneyin: Library API'nin işleyiş şeklini görmek ve entegrasyonunuz için ilham almak üzere örneklerimize göz atın.