Method: sessions.create

יצירת סשן חדש שבו המשתמש יכול לבחור תמונות וסרטונים שיהיו זמינים לצד שלישי.

אם למשתמש אין חשבון Google Photos פעיל, תוחזר הודעת השגיאה FAILED_PRECONDITION.

אם אפליקציית הלקוח יוצרת יותר מדי סשנים לכל משתמש, תוחזר שגיאה מסוג RESOURCE_EXHAUSTED. סביר להניח שלקוחות לא יגיעו למגבלות האלה בתנאים רגילים. עם זאת, עדיין מומלץ ללקוחות לבצע קריאה ל-sessions.delete אחרי כל סשן, כדי להישאר במסגרת מגבלות המשאבים באופן יזום.

אחרי שהמשתמש מקייש על הלחצן סיום כדי לסיים סשן בחירה, ה-pickerUri לא יפעל יותר. יוצרים סשן חדש כדי לאפשר למשתמש לבחור עוד תמונות.

בקשת HTTP

POST https://photospicker.googleapis.com/v1/sessions

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של שאילתה

פרמטרים
requestId

string

זה שינוי אופציונלי. מזהה ייחודי של הבקשה הזו שסופק על ידי הלקוח.

המזהה הזה משמש לאפשרות לבחור בצורה יעילה יותר באפליקציות שמשתמשות בתהליך OAuth 2.0 במכשירים עם יכולות קלט מוגבלות.

המזהה הזה חייב להיות בפורמט של מחרוזת UUID (גרסה 4) ולעמוד בדרישות הבאות:

  • אסור לכלול מידע רגיש ומזהה על המשתמש.
  • חייב להכיל 32 תווים הקסדצימליים שמחולקים לחמש קבוצות מופרדות במקפים, בפורמט 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' (או 8-4-4-4-12).

גוף הבקשה

גוף הבקשה מכיל מופע של PickingSession.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של PickingSession.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly