با Picker API شروع کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Picker API راهی امن برای کاربران شما فراهم می کند تا عکس ها و ویدیوها را از کتابخانه Google Photos خود انتخاب کرده و با برنامه شما به اشتراک بگذارند.
قبل از شروع
جریان Picker API
در اینجا یک نمای کلی از نحوه عملکرد Picker API آورده شده است:
نشانه OAuth را بررسی کنید: قبل از شروع جریان Picker API، یک نشانه دسترسی معتبر OAuth 2.0 برای کاربر بررسی کنید. اگر نشانه ای وجود ندارد، جریان مجوز OAuth 2.0 را برای دریافت آن آغاز کنید .
ایجاد یک جلسه: فرآیند را با برقراری تماس با Picker API برای ایجاد یک جلسه جدید آغاز کنید. این تماس یک pickerUri منحصر به فرد را برمی گرداند.
کاربران را به برنامه Google Photos هدایت کنید: pickerUri را در اختیار کاربران خود قرار دهید (به عنوان یک پیوند قابل کلیک یا یک کد QR). این نشانی وب به‌طور ایمن برنامه Google Photos آنها را باز می‌کند.
کاربر موارد رسانه ای را انتخاب می کند: در برنامه Google Photos، کاربران می توانند کتابخانه خود را مرور کنند و عکس ها و ویدیوهایی را که می خواهند با برنامه شما به اشتراک بگذارند انتخاب کنند. مروری بر تجربه انتخاب کاربر را بخوانید.
نظرسنجی جلسه: برنامه شما باید به صورت دوره ای جلسه را نظرسنجی کند تا وضعیت را بررسی کند. شما به دنبال خاصیت mediaItemsSet هستید تا true را بازگرداند که نشان می دهد کاربر انتخاب خود را به پایان رسانده است.
فهرست موارد رسانه انتخاب شده: هنگامی که mediaItemsSet true را برگرداند، می توانید از روش لیست برای دریافت جزئیات در مورد موارد رسانه انتخاب شده استفاده کنید.
بازیابی و استفاده از آیتم های رسانه: اکنون به آیتم های رسانه انتخاب شده دسترسی دارید. می توانید محتوای آنها را با استفاده از baseUrl دریافت کنید و از آنها در برنامه خود استفاده کنید.
مراحل بعدی
- اسناد مرجع را مرور کنید: مستندات مرجع Picker API را با جزئیات کاوش کنید تا در مورد همه روش‌ها و پارامترهای موجود بیاموزید.
- نمونه ها را امتحان کنید: نمونه ما را بررسی کنید تا Picker API را در عمل ببینید و برای ادغام خود الهام بگیرید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
