REST Resource: accounts.locations.media.customers

Recurso: MediaItem

Um único item de mídia.

Representação 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.
}
Campos
name

string

O nome do recurso para este item de mídia. accounts/{accountId}/locations/{locationId}/media/{mediaKey}

mediaFormat

enum (MediaFormat)

O formato deste item de mídia. Precisa ser definido quando o item de mídia é criado e é somente leitura em todas as outras solicitações. Não foi possível atualizar.

locationAssociation

object (LocationAssociation)

Obrigatório ao chamar CreatePhoto. Descreve como esse item de mídia está conectado ao local dele. Precisa ser uma categoria (por exemplo, EXTERIOR) ou o ID de um item da lista de preços.

Isso é necessário ao adicionar mídia a um local com media.create. Para outros tipos de mídia, como fotos em postagens locais, ele não vai estar presente.

googleUrl

string

Apenas saída. URL hospedado pelo Google para este item de mídia. Esse URL não é estático porque pode mudar com o tempo. Para vídeos, será uma imagem de prévia com um ícone de reprodução sobreposto.

thumbnailUrl

string

Apenas saída. Quando fornecido, o URL de uma imagem em miniatura para esse item de mídia.

createTime

string (Timestamp format)

Apenas saída. Hora de criação desse item de mídia.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

dimensions

object (Dimensions)

Apenas saída. As dimensões (largura e altura) em pixels.

insights

object (MediaInsights)

Apenas saída. Estatísticas para este item de mídia.

attribution

object (Attribution)

Apenas saída. Informações de atribuição para itens de mídia do cliente. Você precisa exibir essa atribuição conforme fornecida aos usuários e não pode excluir ou alterar a atribuição.

description

string

Descrição para este item de mídia. As descrições não podem ser modificadas com a API Google My Business, mas podem ser definidas ao criar um novo item de mídia que não seja uma foto da capa.

Campo de união data. A fonte de dados do item de mídia. Ao criar um novo item de mídia, é necessário fornecer um URL ou uma referência de dados.

Com exceção das categorias PROFILE e COVER, todas as fotos precisam medir pelo menos 250 px na borda curta, com um tamanho de arquivo de pelo menos 10.240 bytes.

Todas as fotos enviadas precisam seguir as diretrizes do Perfil da Empresa para fotos. data pode ser apenas de um dos tipos a seguir:

sourceUrl

string

Um URL acessível publicamente em que o item de mídia pode ser recuperado.

Ao criar um objeto ou dataRef, deve ser definido para especificar a origem do item de mídia.

Se sourceUrl tiver sido usado ao criar um item de mídia, ele será preenchido com esse URL de origem quando o item de mídia for recuperado.

Não é possível atualizar este campo.

dataRef

object (MediaItemDataRef)

Somente entrada. Uma referência aos dados binários do item de mídia, conforme obtido pelo método media.startUpload.

Ao criar um item de mídia,

sourceUrl

ou

dataRef

precisa ser definido.

Métodos

get

Retorna metadados do item de mídia do cliente solicitado.

list

Retorna uma lista de itens de mídia associados a um local que receberam contribuições de clientes.