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 desse 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 este item de mídia está conectado ao local dele. Precisa ser uma categoria (por exemplo, EXTERIOR) ou o código de um item da lista de preços.

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

googleUrl

string

Apenas saída. É o 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, esta será uma imagem de visualização 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 da criação desse item de mídia.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 excluí-la ou alterá-la.

description

string

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

Campo de união data. É a fonte de dados do item de mídia. Ao criar um novo item de mídia, é preciso fornecer um URL ou uma referência de dados.

Com exceção das categorias PROFILE e COVER, todas as fotos precisam medir no mínimo 250 px na borda curta, com 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 de onde o item de mídia pode ser recuperado.

Ao criar um parâmetro ou dataRef deve ser definido para especificar a origem do item de mídia.

Se sourceUrl foi 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)

Apenas 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 para o item de mídia do cliente solicitado.

list

Retorna uma lista de itens de mídia associados a um local que foram enviados por clientes.