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 Фото, но редактировать можно будет только через этот 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

Только вывод. Если установлено, то источники мультимедиа настроены для этого устройства, и клиенты должны иметь возможность запрашивать список элементов мультимедиа для этого устройства.

Источник AmbientMedia

Представляет собой источник мультимедиа, выбранный пользователем для окружающего устройства.

JSON-представление 
{
  "id": string,
  "displayName": string
}
Поля
id

string

Только вывод. Идентификатор источника окружающего медиа.

displayName

string

Только вывод. Отображаемое имя для этого источника медиа.

ОпросКонфигурация

Конфигурация для опроса API.

JSON-представление 
{
  "pollInterval": string
}
Поля
pollInterval

string ( Duration format)

Только вывод. Рекомендуемое время между запросами опроса.

Длительность в секундах с дробной частью до девяти цифр, заканчивающаяся на ' s '. Пример: "3.5s" .

Методы

create

 Создает окружающее устройство в аккаунте Google Фото пользователя.

delete

 Удаляет указанное устройство из аккаунта Google Фото пользователя.

get

 Извлекает информацию об указанном устройстве.

patch

 Обновляет информацию об указанном устройстве.