תחילת השימוש ב-Picker API

Picker API מספק למשתמשים דרך מאובטחת לבחור תמונות וסרטונים מהספרייה שלהם ב-Google Photos ולשתף אותם עם האפליקציה שלכם.

לפני שמתחילים

התהליך של Picker API

סקירה כללית לגבי אופן הפעולה של Picker API:

  1. בדיקת אסימון OAuth: לפני שמתחילים את התהליך של Picker API, צריך לבדוק אם למשתמש יש אסימון גישה תקף מסוג OAuth 2.0. אם אין טוקן, מפעילים את תהליך ההרשאה של OAuth 2.0 כדי לקבל טוקן.

  2. יצירת סשן: מתחילים את התהליך באמצעות שליחת קריאה ל- Picker API כדי ליצור סשן חדש. הקריאה הזו תחזיר ערך pickerUri ייחודי.

  3. הפניית המשתמשים לאפליקציית Google Photos: מספקים את pickerUri למשתמשים (כקישור שניתן ללחוץ עליו או כקוד QR). כתובת ה-URL הזו תפתח באופן מאובטח את אפליקציית Google Photos.

  4. המשתמש בוחר קובצי מדיה: באפליקציית Google Photos המשתמשים יכולים לעיין בספרייה שלהם ולבחור את התמונות והסרטונים שרוצים לשתף עם האפליקציה. תוכלו לקרוא סקירה כללית על חוויית הבחירה של המשתמש.

  5. בדיקת הסשן: האפליקציה צריכה לבדוק את הסשן מדי פעם כדי לבדוק את הסטטוס. אתם מחפשים שהמאפיין mediaItemsSet יחזיר את הערך true, כדי לציין שהמשתמש סיים את הבחירה.

  6. הצגת רשימה של פריטי המדיה שנבחרו: אחרי שהפונקציה mediaItemsSet מחזירה את הערך true, אפשר להשתמש בשיטת הרשימה כדי לקבל פרטים על פריטי המדיה שנבחרו.

  7. אחזור של פריטים של מדיה ושימוש בהם: עכשיו יש לכם גישה לפריטי המדיה שנבחרו. אפשר לאחזר את התוכן שלהם באמצעות baseUrl ולהשתמש בו באפליקציה.

השלבים הבאים

  • עיון במסמכי העזר: כדאי לעיין במסמכי העזר המפורטים של Picker API כדי ללמוד על כל השיטות והפרמטרים הזמינים.
  • כדאי לנסות את הדוגמאות: צפו בדוגמה שלנו כדי לראות את Picker API בפעולה ולקבל השראה לשילוב שלכם.