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"، ولكن لا يمكن تعديله إلا من خلال واجهة برمجة التطبيقات هذه.

يجب أن يتألّف الاسم المعروض الصالح من بين حرف واحد و100 حرف (شاملة).
mediaSources[]

object (AmbientMediaSource)

النتائج فقط. مصادر الوسائط التي تم ضبطها لهذا الجهاز

مصادر الوسائط هي الألبومات أو مجموعات الصور التي يختارها المستخدم لعرضها على جهاز.

يُرجى العِلم أنّ هذا الحقل سيكون فارغًا إذا لم يختار المستخدم أي مصادر وسائط لهذا الجهاز (أي mediaSourcesSet = false).
settingsUri

string

النتائج فقط. معرّف الموارد المنتظم المستخدَم لإعادة توجيه المستخدم إلى إعدادات الجهاز ضمن تطبيق "صور Google"
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

إعدادات طلب البيانات من واجهة برمجة التطبيقات

تمثيل JSON 
{
  "pollInterval": string
}
الحقول
pollInterval

string (Duration format)

النتائج فقط. الوقت المُقترَح بين طلبات الاستطلاع

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

الطُرق

create

 يتم إنشاء جهاز الإضاءة السينمائية في حساب المستخدم على "صور Google".

delete

 تؤدي هذه العملية إلى إزالة الجهاز المحدّد من حساب المستخدم على "صور Google".

get

 تُستخدَم لاسترداد معلومات عن الجهاز المحدّد.

patch

 تعديل المعلومات عن الجهاز المحدّد