REST Resource: accounts.locations.media.customers

Ресурс: Медиаитем

Один медиа-объект.

JSON-представление
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
Поля
name

string

Имя ресурса для этого элемента мультимедиа. accounts/{accountId}/locations/{locationId}/media/{mediaKey}

mediaFormat

enum ( MediaFormat )

Формат этого медиа-элемента. Должен быть установлен при создании элемента мультимедиа и доступен только для чтения для всех остальных запросов. Невозможно обновить.

locationAssociation

object ( LocationAssociation )

Требуется при вызове CreatePhoto . Описывает, как этот медиа-элемент связан с его местоположением. Должна быть либо категория (например, ЭКСТЕРЬЕР), либо идентификатор позиции прайс-листа.

Это необходимо при добавлении нового мультимедиа в местоположение с помощью media.create . Для других типов носителей, например фотографий в локальных постах, этого не будет.

googleUrl

string

Только вывод. URL-адрес этого медиафайла, размещенный в Google. Этот URL-адрес не является статическим, поскольку со временем он может меняться. Для видео это будет изображение предварительного просмотра с наложенным значком воспроизведения.

thumbnailUrl

string

Только вывод. Если указано, URL-адрес миниатюры этого медиа-элемента.

createTime

string ( Timestamp format)

Только вывод. Время создания этого медиа-элемента.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

dimensions

object ( Dimensions )

Только вывод. Размеры (ширина и высота) в пикселях.

insights

object ( MediaInsights )

Только вывод. Статистика по этому медиа-элементу.

attribution

object ( Attribution )

Только вывод. Информация об атрибуции медиа-элементов клиента. Вы должны отображать эту атрибуцию так, как она предоставлена ​​вашим пользователям, и не должны удалять или изменять ее.

description

string

Описание этого медиа-элемента. Описания нельзя изменить через Google My Business API, но их можно установить при создании нового медиа-элемента, который не является обложкой.

data поля объединения. Источник данных элемента мультимедиа. При создании нового элемента мультимедиа необходимо указать URL-адрес или ссылку на данные.

За исключением категорий PROFILE и COVER , все фотографии должны иметь размер не менее 250 пикселей по короткому краю и размер файла не менее 10 240 байт.

Все загружаемые фотографии должны соответствовать рекомендациям для фотографий в профиле компании . data могут быть только одним из следующих:

sourceUrl

string

Общедоступный URL-адрес, по которому можно получить элемент мультимедиа.

При создании одного из них или dataRef необходимо указать источник медиа-элемента.

Если sourceUrl использовался при создании элемента мультимедиа, он будет заполнен этим исходным URL-адресом при получении элемента мультимедиа.

Это поле не может быть обновлено.

dataRef

object ( MediaItemDataRef )

Только ввод. Ссылка на двоичные данные элемента мультимедиа, полученные методом media.startUpload .

При создании медиа-элемента либо

sourceUrl

или

dataRef

должен быть установлен.

Методы

get

Возвращает метаданные для запрошенного клиентского медиа-элемента.

list

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