1 kwietnia 2025 r. usunięto niektóre zakresy interfejsu Library API.
Więcej informacji
Pierwsze kroki z interfejsem Picker API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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
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ść mediaItemsSet zwracała wartość „prawda”, co oznacza, że użytkownik zakończył zaznaczanie.
Wyświetlanie listy wybranych elementów multimedialnych: gdy funkcja mediaItemsSet zwró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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[[["\u003cp\u003eThe Picker API lets users securely select photos and videos from their Google Photos library and share them with your application.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the Picker API, ensure it's the right fit for your use case and properly configure your app with the necessary API and authentication setup.\u003c/p\u003e\n"],["\u003cp\u003eThe Picker API flow involves creating a session, directing users to the Google Photos app for selection, polling the session for completion, and then retrieving the selected media items.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should check the provided resources like reference documentation and samples for detailed information and implementation examples.\u003c/p\u003e\n"]]],["The Picker API enables users to share media from Google Photos with your app. First, check for and obtain an OAuth token. Then, create a new session via the Picker API, generating a `pickerUri`. Direct users to this URI to select media. Periodically poll the session until `mediaItemsSet` is true. Use the list method to retrieve details of selected items, and then access their content using `baseUrl` for use in your application.\n"],null,["# Get started with the Picker API\n\nThe Picker API provides a secure way for your users to select photos and videos\nfrom their Google Photos library and share them with your application.\n\nBefore you start\n----------------\n\n- **Check out the overview:** [Compare the Picker API and the Library API](/photos/overview/about) to make sure the Picker API is the right fit for your use case.\n- **Configure your app:** Enable the API and set up authentication. See [Configure your app](/photos/overview/configure-your-app) for detailed steps.\n\nThe Picker API flow\n-------------------\n\nHere is an overview of the how the Picker API works:\n\n1. **Check for OAuth token:** Before starting the Picker API flow, check for a\n valid OAuth 2.0 access token for the user. If there is no token, [initiate\n the OAuth 2.0 authorization flow](/identity/protocols/oauth2) to obtain one.\n\n2. **Create a session:** Initiate the process by making a call to the Picker\n API to [create a new\n session](/photos/picker/reference/rest/v1/sessions/create). This call will\n return a unique `pickerUri`.\n\n3. **Direct users to the Google Photos app:** Provide the [`pickerUri`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.picker_uri)\n to your users (either as a clickable link or a QR code). This URL will\n securely open their Google Photos app.\n\n4. **User selects media items:** Within the Google Photos app, users can browse\n their library and select the photos and videos they want to share with your\n app. Read an overview of the [user's picking experience](/photos/picker/guides/picking-experience).\n\n5. **Poll the session:** Your app should periodically [poll the session](/photos/picker/reference/rest/v1/sessions/get)\n to check the status. You're looking for the\n [`mediaItemsSet`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.media_items_set)\n property to return true, indicating the user has finished their selection.\n\n | **Note:** Every time you poll a session the response contains [recommended\n | intervals and\n | timeouts](/photos/picker/reference/rest/v1/sessions#PollingConfig) to configure your polling.\n6. **List selected media items:** Once `mediaItemsSet` returns true, you can\n use [the list method](/photos/picker/reference/rest/v1/mediaItems/list) to\n get details about the selected media items.\n\n7. **Retrieve and use media items:** Now you have access to the selected media\n items. You can [fetch their\n content](/photos/picker/guides/media-items#retrieve-picked-media-items)\n using the\n [`baseUrl`](/photos/picker/reference/rest/v1/mediaItems#MediaFile.FIELDS.base_url)\n and utilize them within your application.\n\nNext steps\n----------\n\n- Review the reference docs: Explore the detailed [Picker API reference\n documentation](/photos/picker/reference/rest) to learn about all the available methods and parameters.\n- Try out the samples: Check out our [sample](/photos/picker/samples) to see the Picker API in action and get inspiration for your integration."]]
