REST Resource: locations

Recurso: local

Um local. Consulte o artigo da Central de Ajuda para uma descrição detalhada desses campos ou o endpoint de categoria para 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. O identificador do Google para este local no formato: locations/{locationId}.
languageCode

string

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

string

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

string

Obrigatório. O nome do local precisa refletir o nome real da empresa usado de forma consistente na vitrine, no site e em itens de papelaria, e que os clientes conhecem. Qualquer informação adicional, quando relevante, pode ser incluída 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. - Mountain View Corporate Headquarters"). Não inclua slogans de marketing, códigos de loja, caracteres especiais, horário de funcionamento ou status de fechado/aberto, números de telefone, URLs de sites, informações de serviços/produtos, local/endereço ou rotas, nem informações de contenção (por exemplo, "Caixa eletrônico do Chase no Duane Reade").
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. Use um endereço exato e preciso para descrever o local da sua empresa. Caixas postais ou de correspondência localizadas em lugares remotos não são aceitáveis. No momento, você pode especificar no máximo cinco valores de addressLines no endereço. Esse campo só deve ser definido para empresas que têm uma loja física. Esse campo não deve ser definido para locais do tipo CUSTOMER_LOCATION_ONLY. Se for definido, qualquer valor fornecido será descartado.
websiteUri

string

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

object (BusinessHours)

Opcional. Horário de funcionamento da empresa.
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

Opcional. As empresas de serviço local atuam no local do cliente. Se a empresa for de serviço local, este campo descreverá as áreas atendidas por ela.
labels[]

string

Opcional. Uma coleção de strings de formato livre para que você adicione tags à sua empresa. Essas etiquetas NÃO são voltadas para o usuário e só podem ser vistas por você. 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 informado for geocodificado com sucesso. Este campo só será retornado em solicitações GET se o valor latlng informado pelo usuário for aceito durante a criação ou se o valor latlng tiver sido atualizado pelo site do Perfil da Empresa no Google. Este campo só pode ser atualizado por clientes aprovados.
openInfo

object (OpenInfo)

Opcional. Uma sinalização que indica se o local está aberto para funcionamento.
metadata

object (Metadata)

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

object (Profile)

Opcional. Descreve sua empresa e compartilha com os usuários o diferencial do seu negócio e das suas ofertas.

Esse campo é obrigatório para todas as categorias, exceto as de hospedagem (por exemplo, hotéis, motéis, 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. Um serviço pode ser corte de cabelo, instalação de aquecedor de água etc. Os itens de serviço duplicados serão removidos automaticamente.

Métodos

delete

 Exclui um local.

get

 Retorna o local especificado conforme definido pelo comerciante.

getAttributes

 Recupera os atributos de um local conforme definido pela última vez pelo comerciante.

getGoogleUpdated

 Retorna o local especificado como ele aparece no Google Maps e na Pesquisa.

patch

 Atualiza o local especificado.

updateAttributes

 Atualiza os atributos de um determinado local.