תחילת השימוש ב-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. באפליקציות מבוססות-אינטרנט, אפשר להוסיף את המחרוזת /autoclose ל-URI הזה כדי לסגור אוטומטית את חלון Google Photos אחרי שהמשתמש יסיים לבחור.

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

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

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

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

השלבים הבאים

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