REST Resource: devices

משאב: AmbientDevice

ייצוג של מכשיר עם תצוגה רגישה לסביבה.

ייצוג ב-JSON 
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
שדות
id

string

פלט בלבד. המזהה הייחודי של המכשיר הזה.
displayName

string

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

המידע הזה יוצג למשתמשים בהגדרות של אפליקציית Google Photos, אבל ניתן יהיה לערוך אותו רק דרך ה-API הזה.

שמות מוצגים תקינים חייבים להכיל בין 1 ל-100 תווים (כולל).
mediaSources[]

object (AmbientMediaSource)

פלט בלבד. מקורות המדיה שהוגדרו למכשיר הזה.

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

הערה: השדה הזה יהיה ריק אם המשתמש לא בחר מקורות מדיה למכשיר הזה (כלומר mediaSourcesSet = false).
settingsUri

string

פלט בלבד. ה-URI שמשמש להפניית המשתמש להגדרות המכשיר באפליקציית Google Photos.
createTime

string (Timestamp format)

פלט בלבד. השעה שבה המכשיר נוצר.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
pollingConfig

object (PollingConfig)

פלט בלבד. ההגדרה המומלצת שבה צריכות להשתמש אפליקציות במהלך הסקרים של devices.get.
mediaSourcesSet

boolean

פלט בלבד. אם ההגדרה הזו מוגדרת, מקורות המדיה מוגדרים למכשיר הזה וללקוחות אמורה להיות אפשרות לבקש רשימה של פריטי מדיה למכשיר הזה.

AmbientMediaSource

מייצג מקור מדיה שהמשתמש בחר במכשיר עם מצב אווירה.

ייצוג ב-JSON 
{
  "id": string,
  "displayName": string
}
שדות
id

string

פלט בלבד. המזהה של מקור המדיה במצב אווירה.
displayName

string

פלט בלבד. השם המוצג של מקור המדיה הזה.

PollingConfig

הגדרה של דגימת ה-API.

ייצוג ב-JSON 
{
  "pollInterval": string
}
שדות
pollInterval

string (Duration format)

פלט בלבד. משך הזמן המומלץ בין בקשות לסקרים.

משך זמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

Methods

create

 יוצר מכשיר אווירה בחשבון Google Photos של המשתמש.

delete

 הסרת המכשיר שצוין מחשבון Google Photos של המשתמש.

get

 אחזור מידע על המכשיר שצוין.

patch

 עדכון המידע על המכשיר שצוין.