REST Resource: accounts.locations.media.customers

资源：MediaItem

单个媒体项。

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 时必需。说明此媒体项与其营业地点的关联方式。必须是类别（例如，EXTERIOR）或价格列表项的 ID。

使用 media.create 向营业地点添加新媒体时，必须填写此字段。对于其他类型的媒体（例如本地帖子上的照片），此字段将不会显示。
googleUrl

string

仅供输出。此媒体项的 Google 托管网址。此网址不是静态的，因为它可能会随着时间而改变。对于视频广告，此图片将是一张带有叠加播放图标的预览图片。
thumbnailUrl

string

仅供输出。此媒体项的缩略图网址（如果提供）。
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。媒体项的数据源。创建新的媒体项时，必须提供网址或数据引用。

除 PROFILE 和 COVER 类别之外，所有照片的短边尺寸必须至少为 250 像素，文件大小至少为 10240 字节。

上传的所有照片均应遵守商家资料照片准则。data 只能是下列其中一项：
sourceUrl

string

可从中检索媒体项的可公开访问网址。

创建某个网址或 dataRef 时，必须设置此字段以指定媒体项的来源。

如果在创建媒体项时使用 sourceUrl，则在检索媒体项时，系统将使用该来源网址填充该项。

此字段无法更新。
dataRef

object (MediaItemDataRef)

仅限输入。对通过 media.startUpload 方法获取的媒体内容二进制数据的引用。

创建媒体项时，

sourceUrl

或

dataRef

。

方法

get

 返回所请求客户媒体项的元数据。

list

 返回与由客户提供的营业地点相关联的媒体项列表。