Pierwsze kroki z interfejsem Picker API

Interfejs Picker API zapewnia użytkownikom bezpieczny sposób wybierania zdjęć i filmów z biblioteki Zdjęć Google oraz udostępniania ich Twojej 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.

Przepływ interfejsu Picker API

Oto ogólny opis działania interfejsu Picker API:

1. Sprawdź token OAuth: przed rozpoczęciem przepływu interfejsu Picker API sprawdź, czy użytkownik ma prawidłowy token dostępu OAuth 2.0. Jeśli nie ma tokena, rozpocznij proces autoryzacji OAuth 2.0, aby go uzyskać.

2. Utwórz sesję: rozpocznij proces, wywołując interfejs Picker API, aby utworzyć nową sesję. To wywołanie zwróci unikalny pickerUri.

3. Kierowanie użytkowników do aplikacji Zdjęcia Google: udostępnij użytkownikom pickerUri (jako klikalny link lub kod QR). Ten adres URL bezpiecznie otworzy aplikację Zdjęcia Google. W przypadku aplikacji internetowych możesz dodać do tego identyfikatora URI parametr /autoclose, aby automatycznie zamknąć okno Zdjęć Google po dokonaniu wyboru przez użytkownika.

4. Użytkownik wybiera elementy multimedialne: w aplikacji Zdjęcia Google użytkownicy mogą przeglądać bibliotekę i wybierać zdjęcia oraz filmy, które chcą udostępnić Twojej aplikacji. Zapoznaj się z omówieniem procesu wybierania przez użytkownika.

5. Odpytywanie sesji: aplikacja powinna okresowo odpytywać sesję, aby sprawdzać jej stan. Chcesz, aby właściwość mediaItemsSet zwracała wartość „prawda”, co oznacza, że użytkownik zakończył wybór.

   Uwaga: za każdym razem, gdy wysyłasz zapytanie o sesję, odpowiedź zawiera zalecane interwały i limity czasu, które możesz wykorzystać do skonfigurowania wysyłania zapytań.

6. Wyświetlanie listy wybranych elementów multimedialnych: gdy funkcja mediaItemsSet zwróci wartość „prawda”, możesz użyć metody list, aby uzyskać szczegółowe informacje o wybranych elementach multimedialnych.

7. Pobieranie i używanie elementów multimedialnych: masz teraz dostęp do wybranych elementów multimedialnych. Możesz pobrać ich treść za pomocą baseUrl i wykorzystać je w swojej aplikacji.

Dalsze kroki

• Zapoznaj się z dokumentacją referencyjną: przejrzyj szczegółową dokumentację referencyjną interfejsu Picker API, aby poznać wszystkie dostępne metody i parametry.
• Wypróbuj przykłady: zapoznaj się z naszym przykładem, aby zobaczyć, jak działa interfejs Picker API, i znaleźć inspirację do integracji.