REST Resource: locations

Recurso: local

Um local. Consulte o artigo da Central de Ajuda para ver uma descrição detalhada desses campos ou o endpoint da categoria para consultar uma lista de categorias de negócios válidas.

Representação JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Campos
name

string

Identificador do Google para esse local no formato: locations/{locationId}.
languageCode

string

Imutável. O idioma do local. Definido durante a criação e não pode ser atualizado.
storeCode

string

Opcional. Identificador externo desse local, que precisa ser exclusivo em uma determinada conta. Esse é um meio de associar o local aos seus próprios registros.
title

string

Obrigatório. O nome do local deve refletir o nome real da sua empresa, conforme usado de forma consistente na loja, no site e em artigos de papelaria, e como é conhecido pelos clientes. Outras informações, quando relevantes, podem ser incluídas em outros campos do recurso (por exemplo, Address, Categories). Não adicione informações desnecessárias ao nome (por exemplo, prefira "Google" em vez de "Google Inc. — Sede corporativa de Mountain View"). Não inclua slogans de marketing, códigos da loja, caracteres especiais, horário de funcionamento ou status "fechado/aberto", números de telefone, URLs de sites, informações de serviço/produto, local/endereço ou rotas ou informações de contenção (por exemplo, "caixa eletrônico 24 horas no Rio de Janeiro").
phoneNumbers

object (PhoneNumbers)

Opcional. Os diferentes números de telefone que os clientes podem usar para entrar em contato com a empresa.
categories

object (Categories)

Opcional. As diferentes categorias que descrevem a empresa.
storefrontAddress

object (PostalAddress)

Opcional. Um endereço exato e preciso para descrever o local da sua empresa. Caixas postais ou de correspondência localizadas em locais remotos não são aceitas. No momento, você pode especificar no máximo cinco valores addressLines no endereço. Defina esse campo apenas para empresas que têm uma vitrine. Esse campo não deve ser definido para locais do tipo CUSTOMER_LOCATION_ONLY. Se definido, qualquer valor fornecido será descartado.
websiteUri

string

Opcional. Um URL para esta empresa. Se possível, use um URL que represente o local específico da empresa em vez de um site/URL genérico que representa todos os locais ou a marca.
regularHours

object (BusinessHours)

Opcional. Horário de funcionamento da empresa.
specialHours

object (SpecialHours)

Opcional. Horário de funcionamento especial da empresa. Isso normalmente inclui o horário de funcionamento em feriados e outros horários fora do normal. Eles substituem o horário de funcionamento normal. Este campo não pode ser definido sem o horário de funcionamento normal.
serviceArea

object (ServiceAreaBusiness)

Opcional. Empresas com área de cobertura oferecem o atendimento no local do cliente. Se a empresa for de serviço local, este campo vai descrever as áreas atendidas pela empresa.
labels[]

string

Opcional. É uma coleção de strings de formato livre para incluir tags na sua empresa. Esses marcadores NÃO são voltados para o usuário, somente você pode vê-los. Precisa ter entre 1 e 255 caracteres por rótulo.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcional. Informações adicionais exibidas no Google AdWords.
latlng

object (LatLng)

Opcional. Latitude e longitude fornecidas pelo usuário. Ao criar um local, este campo será ignorado se o endereço fornecido for geocodificado corretamente. Esse campo só vai ser retornado em solicitações get se o valor latlng fornecido pelo usuário tiver sido aceito durante a criação ou se o valor latlng tiver sido atualizado no site do Perfil da Empresa no Google. Esse campo só pode ser atualizado por clientes aprovados.
openInfo

object (OpenInfo)

Opcional. Uma sinalização que indica se o local está aberto no momento.
metadata

object (Metadata)

Apenas saída. Outras informações não editáveis pelo usuário.
profile

object (Profile)

Opcional. Descreve sua empresa com sua voz e compartilha com os usuários a história da sua empresa e das suas ofertas.

Este campo é obrigatório para todas as categorias, exceto as categorias de hospedagem (por exemplo, hotéis, hotéis de estrada, pousadas).
relationshipData

object (RelationshipData)

Opcional. Todos os locais e redes relacionados a este.
moreHours[]

object (MoreHours)

Opcional. Mais horários de funcionamento para diferentes departamentos ou clientes específicos de uma empresa.
serviceItems[]

object (ServiceItem)

Opcional. Lista de serviços aceitos pelos comerciantes. Os serviços podem ser cortar o cabelo, instalar um aquecedor de água etc. Os itens duplicados são removidos automaticamente.

Métodos

delete

 Exclui um local.

get

 Retorna o local especificado.

getAttributes

 Procura todos os atributos definidos para um determinado local.

getGoogleUpdated

 Recebe a versão atualizada pelo Google do local especificado.

patch

 Atualiza o local especificado.

updateAttributes

 Atualize os atributos de um determinado local.