Method: mediaItems.list

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

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

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

Клиентские приложения ограничены 240 запросами на устройство в день.

Ошибка FAILED_PRECONDITION возникает, если пользователь не настроил ни одного источника мультимедиа.

HTTP-запрос

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

URL-адрес использует синтаксис gRPC Transcoding .

Параметры запроса

Параметры
deviceId

string

Обязательно. Уникальный идентификатор этого устройства.

mediaSourceId

string

Необязательно. Для Ambient experience пропустите это поле. Это вернет курируемый набор элементов мультимедиа из всех настроенных источников. Количество возвращаемых элементов будет соответствовать вашему запросу pageSize , максимум до 100 элементов. Если указано, будут возвращены только элементы из указанного источника мультимедиа.

id должен соответствовать источнику, выбранному пользователем для указанного устройства (т.е. одному из AmbientDevice.media_sources.id ).

Обратите внимание, highlights не поддерживается, даже если это выбранный пользователем источник для этого устройства. Установка этого поля в highlights вернет ошибку INVALID_ARGUMENT .

pageSize

integer

Необязательно. Максимальное количество возвращаемых медиа-элементов.

Служба выполнит ваш запрос pageSize , хотя может вернуть меньше элементов, чем указано (включая нулевые результаты).

Если pageSize не указан или установлен на 0, будет возвращено не более 50 элементов мультимедиа. Значения больше 100 будут принудительно уменьшены до максимально допустимого значения 100. Предоставление отрицательного значения приведет к ошибке INVALID_ARGUMENT .

pageToken

string

Необязательно. Токен страницы, полученный из предыдущего вызова mediaItems.list . Укажите это для получения последующей страницы.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на метод mediaItems.list .

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "mediaItems": [
    {
      object (AmbientMediaItem)
    }
  ],
  "nextPageToken": string
}
Поля
mediaItems[]

object ( AmbientMediaItem )

Страница элементов окружающего мультимедиа, которые устройство будет отображать.

nextPageToken

string

Если задано, это поле можно использовать как pageToken в последующем вызове mediaItems.list для получения следующей страницы элементов.

Если это поле пропущено, это не обязательно означает, что больше нет доступного для извлечения контента, а скорее означает, что последующая страница контента может содержать элементы мультимедиа, которые уже были возвращены на предыдущих страницах.

Области действия авторизации

Требуется следующая область действия OAuth:

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