Method: devices.list

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

בקשת HTTP

GET https://photosambient.googleapis.com/v1/devices

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של מכשירים שצריך להחזיר.

השירות עשוי להחזיר פחות מהערך הזה (כולל אפס תוצאות). אם לא צוין 0 או לא מוגדר, יוחזרו 50 מכשירים לכל היותר. הערך המקסימלי הוא 100; ערכים מעל 100 יקובצו ל-100. ערכים שליליים יגרמו לשגיאה INVALID_ARGUMENT.
pageToken

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-devices.list. צריך לספק את הכתובת הזו כדי לאחזר את הדף הבא.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תשובה ל-RPC devices.list.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
שדות
devices[]

object (AmbientDevice)

דף של מכשירי אווירה שמחוברים לחשבון Google Photos של המשתמש.
nextPageToken

string

אסימון, שניתן לשלוח בתור pageToken כדי לאחזר את הדף הבא בבקשת devices.list.

אם השדה הזה יושמט, אין דפים נוספים.

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/photosambient.mediaitems