Learn about the new Picker API and important Library API changes.
Details here.
תחילת השימוש ב-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). כתובת ה-URL הזו תפתח באופן מאובטח את אפליקציית Google Photos.
המשתמש בוחר קובצי מדיה: באפליקציית Google Photos המשתמשים יכולים לעיין בספרייה שלהם ולבחור את התמונות והסרטונים שרוצים לשתף עם האפליקציה. תוכלו לקרוא סקירה כללית על חוויית הבחירה של המשתמש.
בדיקת הסשן: האפליקציה צריכה לבדוק את הסשן מדי פעם כדי לבדוק את הסטטוס. אתם מחפשים שהמאפיין mediaItemsSet יחזיר את הערך true, כדי לציין שהמשתמש סיים את הבחירה.
הצגת רשימה של פריטי המדיה שנבחרו: אחרי שהפונקציה mediaItemsSet מחזירה את הערך true, אפשר להשתמש בשיטת הרשימה כדי לקבל פרטים על פריטי המדיה שנבחרו.
אחזור של פריטים של מדיה ושימוש בהם: עכשיו יש לכם גישה לפריטי המדיה שנבחרו. אפשר לאחזר את התוכן שלהם באמצעות baseUrl ולהשתמש בו באפליקציה.
השלבים הבאים
- עיון במסמכי העזר: כדאי לעיין במסמכי העזר המפורטים של Picker API כדי ללמוד על כל השיטות והפרמטרים הזמינים.
- כדאי לנסות את הדוגמאות: צפו בדוגמה שלנו כדי לראות את Picker API בפעולה ולקבל השראה לשילוב שלכם.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-08 (שעון 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"]],["עדכון אחרון: 2024-11-08 (שעון UTC)."],[[["The Picker API lets users securely select photos and videos from their Google Photos library and share them with your application."],["Before 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."],["The 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."],["Developers should check the provided resources like reference documentation and samples for detailed information and implementation examples."]]],["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"]]
