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 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 de 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, é necessário definir 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.

MediaItemDataRef

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

Crie uma referência de dados usando media.startUpload e use-a ao fazer upload de bytes para [media.upload] e, depois, 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 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 MediaItem dataRef.

MediaFormat

Enumeração para o 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 aceitas.
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 localização (por exemplo, fotos de postagens locais) não podem ter nenhuma das duas. location_attachment_type pode ser apenas de um dos tipos a seguir:
category

enum (Category)

A categoria à qual a foto deste local pertence.

priceListItemId

string

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

Categoria

Enumeração para a categoria de item de mídia.

Enums
CATEGORY_UNSPECIFIED Categoria não especificada.
COVER Foto da capa. Cada local tem apenas uma foto de capa.
PROFILE Foto do perfil. Cada local tem apenas uma foto de perfil.
EXTERIOR Mídia externa.
INTERIOR Mídia interna.
PRODUCT Mídia do produto.
AT_WORK "No trabalho" mídia.
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 não categorizada.

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. 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 o item de mídia será atribuído.

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 poderá 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 os metadados do item de mídia especificado.

startUpload

Gera um MediaItemDataRef para upload de item de mídia.