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

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.