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 رقم کسری استفاده می کند. افست های غیر از "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" .

روش ها

create

 یک دستگاه محیطی در حساب Google Photos کاربر ایجاد می کند.

delete

 دستگاه مشخص شده را از حساب Google Photos کاربر حذف می کند.

get

 اطلاعات مربوط به دستگاه مشخص شده را بازیابی می کند.

patch

 اطلاعات مربوط به دستگاه مشخص شده را به روز می کند.