Interfejs Picker API zapewnia użytkownikom bezpieczny sposób wybierania zdjęć i filmów z ich biblioteki Zdjęć Google oraz udostępniania ich w aplikacji.
Zanim rozpoczniesz
- Zapoznaj się z omówieniem: porównaj interfejs Picker API z interfejsem Library API, aby upewnić się, że interfejs Picker API jest odpowiedni do Twojego zastosowania.
- Skonfiguruj aplikację: włącz interfejs API i skonfiguruj uwierzytelnianie. Szczegółowe instrukcje znajdziesz w artykule Konfigurowanie aplikacji.
Schemat interfejsu Picker API
Oto ogólny opis działania interfejsu Picker API:
Sprawdzanie tokena OAuth: zanim rozpoczniesz proces interfejsu Picker API, sprawdź, czy użytkownik ma prawidłowy token dostępu OAuth 2.0. Jeśli token nie istnieje, rozpocznij proces autoryzacji OAuth 2.0, aby go uzyskać.
Utwórz sesję: rozpocznij proces, wykonując wywołanie interfejsu Picker API, aby utworzyć nową sesję. To wywołanie zwróci unikalny identyfikator
pickerUri.Przekierowywanie użytkowników do aplikacji Zdjęcia Google: podaj użytkownikom
pickerUri(jako klikalny link lub kod QR). Ten adres URL otworzy aplikację Zdjęcia Google w bezpieczny sposób.Użytkownik wybiera elementy multimedialne: w aplikacji Zdjęcia Google użytkownicy mogą przeglądać swoją bibliotekę oraz wybierać zdjęcia i filmy, które chcą udostępnić aplikacji. Przeczytaj omówienie procesu wyboru treści przez użytkownika.
Sprawdzanie sesji: aplikacja powinna okresowo sprawdzać stan sesji. Chcesz, aby właściwość
mediaItemsSetzwracała wartość „prawda”, co oznacza, że użytkownik zakończył zaznaczanie.Wyświetlanie listy wybranych elementów multimedialnych: gdy funkcja
mediaItemsSetzwróci wartość true, możesz użyć metody listy, aby uzyskać szczegółowe informacje o wybranych elementach multimedialnych.Pobieranie i używanie multimediów: masz teraz dostęp do wybranych multimediów. Możesz pobrać ich
baseUrltreści za pomocą aplikacji.
Dalsze kroki
- Przeczytaj dokumenty referencyjne: zapoznaj się ze szczegółową dokumentacją interfejsu Picker API, aby dowiedzieć się więcej o wszystkich dostępnych metodach i parametrach.
- Wypróbuj przykłady: zapoznaj się z przykładami, aby zobaczyć, jak działa interfejs Picker API, i znaleźć inspirację do integracji.