בחירת תמונות: מה המשתמשים רואים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
המדריך הזה יעזור לכם להבין את חוויית המשתמשים בבחירת פריטים של מדיה.
בהתאם לתהליך הרגיל של Picker API, בוחרים ישויות אחרי שהאפליקציה מציגה את pickerUri, בזמן שהאפליקציה מבצעת סקרים כדי ש-mediaItemsSet יחזיר את הערך true.
כדי לראות את השלבים האלה במכשיר שלכם, תוכלו להיעזר באפליקציית הדוגמה שלנו.
התחלת סשן הבחירה
אחרי יצירת סשן, האפליקציה אמורה להציג את pickerUri למשתמשים.
- הצגת
pickerUri גם כקוד QR וגם ככתובת URL.
- מומלץ להוסיף טקסט מועיל לצד
pickerUri. לדוגמה, "צריך לסרוק את הקוד הזה כדי לפתוח את Google Photos ולבחור את הפריטים הרצויים".
- במכשירים עם יכולות קלט מוגבלות (למשל, קיוסקים, טאבלטים, טלוויזיות חכמות), כדאי לבדוק את ההמלצות של יצרן החומרה לגבי גודל הטקסט ורוחבו של קוד ה-QR.
חיפוש ובחירה של תמונות
כשמשתמש נכנס ל-pickerUri, הוא מועבר לדף בחירת תמונות באפליקציית Google Photos.
בדף הזה תמיד יוצגו התמונות האחרונות מספריית Google Photos של המשתמש. האלבומים, התמונות המועדפות וקטגוריות נפוצות אחרות של תמונות לא מוצגות ישירות. המשתמשים יכולים לחפש תמונות לפי קריטריונים שונים, כמו מילות מפתח, תאריכים, מיקומים ושמות של אלבומים.
אם האפליקציה שלכם משתמשת באלבומים, בתאריכים או בקטגוריות נפוצות אחרות של תמונות, כדאי לבקש מהמשתמשים לבצע חיפוש ברגע שהם נכנסים לאפליקציית Google Photos.
לדוגמה, אם אתם מבקשים מהמשתמשים לשתף אלבום ספציפי, תוכלו לכלול את הטקסט הבא באותו דף שבו המשתמשים מתחברים ל-Google Photos: "מתחברים ל-Google Photos ומחפשים את האלבום שרוצים לשתף".
אחרי החיפוש, המשתמש יכול לבחור פריט אחד או יותר מהתוצאות.
מסך הסיום
אחרי שהמשתמש מקשיק על הלחצן 'סיום' ומסיים את תהליך האיסוף, הוא רואה את המסך 'סיום'. הפעולה הזו תסתיים את סשן הבחירה ו-pickerUri הנוכחי לא יפעל יותר.
כדי לתת למשתמשים אפשרות לבחור עוד תמונות, צריך ליצור סשן בחירה חדש ולהציג שוב את pickerUri באפליקציה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-29 (שעון UTC)."],[[["\u003cp\u003eThis guide explains the user experience within the Google Photos app when selecting media items using the Picker API.\u003c/p\u003e\n"],["\u003cp\u003eUsers initiate the process by accessing the \u003ccode\u003epickerUri\u003c/code\u003e displayed in your app, which opens a photo selection page within Google Photos.\u003c/p\u003e\n"],["\u003cp\u003eUsers can search and select photos from their Google Photos library using various criteria before confirming their choices.\u003c/p\u003e\n"],["\u003cp\u003eAfter selection, users are presented with a "Done" screen, and your app can re-display the \u003ccode\u003epickerUri\u003c/code\u003e to allow for further selections in a new session.\u003c/p\u003e\n"]]],["The core process involves displaying a `pickerUri` (QR code and URL) to users, prompting them to access it. This takes them to Google Photos for photo selection. Users can search using keywords, dates, or locations to find specific photos. Upon selection and pressing \"Done,\" the process ends. Apps can offer to display the `pickerUri` again to initiate a new picking session, to select more items. While the app is polling for the media selection the process has begun.\n"],null,["# Photo picking: what users see\n\nThis guide helps you understand your user's experience when picking media items.\n\nFollowing the [standard Picker API flow](/photos/picker/guides/get-started-picker#the_picker_api_flow),\npicking beings after your app displays the [`pickerUri`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.picker_uri),\nand while your app is polling for [`mediaItemsSet`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.media_items_set) to return true.\n\nTo view any of these steps on your own device, check out our [sample app](/photos/picker/samples).\n\nStart the picking session\n-------------------------\n\nAfter successfully creating a session your app should display the `pickerUri` to\nyour users.\n\n- Display the `pickerUri` as both a QR code and a URL.\n- Provide helpful text alongside the `pickerUri`. For example, \"Scan this code to open Google Photos and select your items.\".\n- For devices with limited input capabilities (e.g., kiosks, tablets, smart TVs), check your hardware manufacture's recommendations on text size and QR code width.\n\nSearch and select photos\n------------------------\n\nWhen a user accesses the `pickerUri`, they are taken to a photo selection page\nwithin the Google Photos app.\n\nThis page will always display the most recent photos from your user's Google\nPhotos library. Albums, favorites, and other common photos categories are not\nshow directly. Users can search for photos using various criteria,\nsuch as keywords, dates, locations, and album titles.\n\nIf your app utilizes albums, dates, or other common photos categories, help your\nusers by prompting them to search once they enter the Google Photos app.\n\nFor example, if your asking your users to share a specific album, you could\ninclude the following text on the same page your users connect to Google Photos:\n\"Connect to Google Photos, then search for the album you want to share.\"\n\nAfter searching, the user can select one or more items from the results.\n\nDone screen\n-----------\n\nOnce the user taps the \"Done\" button and completes picking, they will see\nthe \"Done\" screen. This ends the picking session and the current `pickerUri`\nwill no longer work.\n\nTo provide your users the option to select more photos, create a new picking\nsession and display the `pickerUri` again in your app."]]
