Pierwsze kroki z interfejsem Library API

Interfejs Library API umożliwia interakcję ze zdjęciami, filmami i albumami w bibliotekach Zdjęć Google użytkowników, ale z jednym ważnym wyjątkiem: możesz uzyskać dostęp tylko do treści utworzonych przez Twoją aplikację i nimi zarządzać.

Zanim rozpoczniesz

• Zapoznaj się z omówieniem: porównaj interfejs Picker API z interfejsem Library API, aby upewnić się, że ten drugi jest odpowiedni do Twojego zastosowania.
• Skonfiguruj aplikację: włącz interfejs API i skonfiguruj uwierzytelnianie. Szczegółowe instrukcje znajdziesz w sekcji Konfigurowanie aplikacji.

Najważniejsze zastosowania interfejsu Library API

Interfejs Library API jest idealny do scenariuszy, w których aplikacja musi:

• Przesyłanie i przechowywanie multimediów: bezpieczne importowanie zdjęć i filmów (wygenerowanych przez aplikację) do bibliotek Zdjęć Google użytkowników.
• Uporządkowanie treści: tworzenie albumów i zarządzanie nimi w celu ułatwienia użytkownikom porządkowania multimediów związanych z aplikacją.
• Ulepsz zdjęcia i albumy: dodaj kontekst do elementów multimedialnych i albumów przez wzbogacanie zdjęć, np. tytuły, opisy czy informacje o lokalizacji.
• Dostęp do danych utworzonych przez aplikację: możesz pobierać i używać zdjęć, filmów oraz albumów utworzonych wcześniej przez aplikację.

Typowy przepływ danych w ramach interfejsu Library API

Chociaż interfejs Library API ma różne funkcje, typowy przepływ pracy może obejmować te kroki:

1. Przesyłanie multimediów: użyj punktu końcowego przesyłania, aby bezpiecznie przesłać bajty zdjęć lub filmów do Zdjęć Google. Ten krok generuje uploadToken.

2. Tworzenie elementów multimedialnych: użyj metody mediaItems.batchCreate, podając parametr uploadToken, aby utworzyć elementy multimedialne w bibliotece użytkownika.

3. Tworzenie albumów (opcjonalnie): użyj metody albums.create, aby utworzyć albumy w bibliotece użytkownika i uporządkować elementy multimedialne.

4. Zarządzanie albumami:

   • Dodaj elementy multimedialne (utworzone przez Twoją aplikację) do albumów za pomocą albums.batchAddMediaItems.
   • Usuwanie elementów multimedialnych z albumów za pomocą albums.batchRemoveMediaItems.
   • Dodawaj do albumów informacje dodatkowe (np. tytuły lub lokalizacje) za pomocą albums.addEnrichment.
   • Pobieraj informacje o konkretnych albumach za pomocą albums.get.
   • Lista albumów utworzonych przez Twoją aplikację za pomocą interfejsu albums.list.

5. Dostęp do multimediów utworzonych przez aplikację:

   • Pobieraj szczegóły dotyczące konkretnych elementów multimedialnych za pomocą mediaItems.get lub mediaItems.batchGet.
   • Wyszukaj elementy multimedialne utworzone przez Twoją aplikację za pomocą funkcji mediaItems.search.
   • Wyświetlić elementy multimedialne w określonym albumie utworzonym przez aplikację za pomocą elementu mediaItems.search z identyfikatorem albumu.

Dalsze kroki

• Przeczytaj dokumenty referencyjne: zapoznaj się ze szczegółową dokumentacją interfejsu Library API, aby dowiedzieć się więcej o dostępnych metodach i parametrach.
• Wypróbuj przykłady: zapoznaj się z przykładami, aby zobaczyć, jak działa interfejs Library API, i znaleźć inspirację do integracji.