REST Resource: accounts.locations.media

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.

MediaItemDataRef

Referência aos dados binários de fotos de um MediaItem enviado pela API Google My Business.

Crie uma referência de dados usando media.startUpload e use essa referência ao fazer upload de bytes para [media.upload] e, em seguida, chamar media.create.

Representação JSON 
{
  "resourceName": string
}
Campos
resourceName

string

O ID exclusivo dos dados binários deste item de mídia. Usado para fazer upload dos dados da foto com [media.upload] e ao criar um novo item de mídia a partir desses bytes com media.create.

Exemplo de upload de bytes: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

Para chamadas media.create, defina como o MediaItem dataRef.

MediaFormat

Enumeração do formato de mídia.

Enums
MEDIA_FORMAT_UNSPECIFIED Formato não especificado.
PHOTO O item de mídia é uma foto. Nesta versão, apenas fotos são compatíveis.
VIDEO O item de mídia é um vídeo.

LocationAssociation

Como o item de mídia está associado ao local.

Representação JSON 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
Campos
Campo de união location_attachment_type. A mídia do local precisa ter uma categoria ou o ID de um item da lista de preços a que está associada. Mídias que não sejam de local (por exemplo, fotos de postagens locais) não podem ter nenhum dos dois. location_attachment_type pode ser apenas de um dos tipos a seguir:
category

enum (Category)

A categoria à qual a foto do local pertence.
priceListItemId

string

O ID de um item da lista de preços a que esta foto de local está associada.

Categoria

Enumeração da categoria de item de mídia.

Enums
CATEGORY_UNSPECIFIED Categoria não especificada.
COVER Foto da capa. Um local tem apenas uma foto de capa.
PROFILE Foto do perfil. Um local tem apenas uma foto do perfil.
EXTERIOR Mídia externa.
INTERIOR Mídia interna.
PRODUCT Mídia de produto.
AT_WORK Mídia no trabalho.
FOOD_AND_DRINK Mídia de alimentos e bebidas.
MENU Mídia do menu.
COMMON_AREA Mídia de área comum.
ROOMS Mídia das salas.
TEAMS Mídia de equipes.
ADDITIONAL Mídia adicional sem classificação.

Dimensões

Dimensões do item de mídia.

Representação JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Campos
widthPixels

integer

Largura do item de mídia, em pixels.
heightPixels

integer

Altura do item de mídia, em pixels.

MediaInsights

Insights e estatísticas para o item de mídia.

Representação JSON 
{
  "viewCount": string
}
Campos
viewCount

string (int64 format)

Apenas saída. O número de vezes que o item de mídia foi visualizado.

Atribuição

Informações de atribuição para itens de mídia do cliente, como o nome e a foto do perfil do colaborador.

Representação JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Campos
profileName

string

O nome de usuário ao qual atribuir o item de mídia.
profilePhotoUrl

string

URL da miniatura da foto do perfil do usuário atribuído.
takedownUrl

string

O URL da página de remoção, em que o item de mídia pode ser denunciado, se for inadequado.
profileUrl

string

É o URL da página de perfil do Google Maps do usuário atribuído.

Métodos

create

 Cria um novo item de mídia para o local.

delete

 Exclui o item de mídia especificado.

get

 Retorna metadados para o item de mídia solicitado.

list

 Retorna uma lista de itens de mídia associados a um local.

patch

 Atualiza metadados do item de mídia especificado.

startUpload

 Gera um MediaItemDataRef para o upload de itens de mídia.