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 é possível atualizá-lo.
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 nova mídia a um local com media.create. Para outros tipos de mídia, como fotos em postagens locais, ele não 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 esse item de mídia.
attribution

object (Attribution)

Apenas saída. Informações de atribuição para itens de mídia de clientes. Você precisa mostrar essa atribuição aos usuários conforme fornecida e não pode excluir ou alterar o crédito.
description

string

Descrição para esse item de mídia. As descrições não podem ser modificadas pela 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 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 mínimo de 10.240 bytes.

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

string

Um URL de acesso público, de onde o item de mídia pode ser recuperado.

Ao criar um, dataRef precisa 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.

MediaItemDataRef

Referência aos dados binários de fotos de um MediaItem enviado usando a 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 depois chamar media.create.

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

string

O ID exclusivo para os 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 com esses 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 isso como o MediaItem dataRef.

MediaFormat

Enumeração do formato de mídia.

Tipos enumerados
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 dele.

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 a que a foto deste lugar pertence.
priceListItemId

string

O ID de um item da lista de preços ao qual esta foto do local está associada.

Categoria

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

Tipos enumerados
CATEGORY_UNSPECIFIED Categoria não especificada.
COVER Foto de 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 produtos.
AT_WORK Mídia "no trabalho".
FOOD_AND_DRINK Mídia de alimentos e bebidas.
MENU Mídia de cardápio.
COMMON_AREA Mídia de área comum.
ROOMS Mídia de 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. O número de visualizações do item de mídia.

Atribuição

Informações de atribuição para itens de mídia padrão, 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 pode ser denunciado, caso seja inapropriado.
profileUrl

string

O URL da página do 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 do 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 o upload de itens de mídia.