יצירת סשן חדש שבו המשתמש יכול לבחור תמונות וסרטונים שיהיו זמינים לצד שלישי.
אם למשתמש אין חשבון Google Photos פעיל, תוחזר הודעת השגיאה FAILED_PRECONDITION.
אם אפליקציית הלקוח יוצרת יותר מדי סשנים לכל משתמש, תוחזר שגיאה מסוג RESOURCE_EXHAUSTED. סביר להניח שלקוחות לא יגיעו למגבלות האלה בתנאים רגילים. עם זאת, עדיין מומלץ ללקוחות לבצע קריאה ל-sessions.delete אחרי כל סשן, כדי להישאר במסגרת מגבלות המשאבים באופן יזום.
בקשת HTTP
POST https://photospicker.googleapis.com/v1/sessions
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
גוף הבקשה
גוף הבקשה מכיל מופע של PickingSession.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של PickingSession.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly