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 conferir 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

O 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 atualizável.

storeCode

string

Opcional. O 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 precisa refletir o nome real da sua empresa, conforme utilizado de maneira 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 seu nome (por exemplo, dê preferência a "Google" em vez de "Google LLC – Sede corporativa em Mountain View"). Não inclua slogans de marketing, códigos das lojas, caracteres especiais, horário de funcionamento ou status de fechamento/aberto, números de telefone, URLs de sites, informações sobre serviços/produtos, local/endereço ou rotas ou informações sobre contenção (por exemplo, "Caixa eletrônico Itaú da Ria de Vigo").

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 preciso e correto para descrever o local da sua empresa. Caixas postais ou de correspondência localizadas em locais remotos não são aceitas. No momento, é possível especificar no máximo cinco valores 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, mas se definido, qualquer valor fornecido será descartado.

websiteUri

string

Opcional. Um URL para esta empresa. Se possível, use um URL que represente esse local da empresa específico, em vez de um site/URL genérico que represente 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 geralmente inclui o horário de funcionamento em feriados e outros horários fora do normal. Eles substituem o horário de funcionamento normal. Não é possível definir este campo sem o horário de funcionamento normal.

serviceArea

object (ServiceAreaBusiness)

Opcional. Empresas com área de cobertura fornecem seus serviços no local do cliente. Se a empresa for de serviço local, esse campo descreverá as áreas atendidas por ela.

labels[]

string

Opcional. Uma coleção de strings de formato livre para que você inclua tags na sua empresa. Esses marcadores NÃO são voltados para o usuário. que só você pode ver. Precisa ter entre 1 e 255 caracteres por rótulo.

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcional. Informações adicionais que são exibidas no Google AdWords.

latlng

object (LatLng)

Opcional. Latitude e longitude fornecidas pelo usuário. Durante a criação de um local, este campo será ignorado se o endereço fornecido for geocodificado corretamente. Esse campo só será retornado em solicitações "get" se o valor de latlng fornecido pelo usuário tiver sido aceito durante a criação ou se o valor de latlng tiver sido atualizado no 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 com sua própria voz e compartilha com os usuários a história exclusiva dela e de suas ofertas.

Este campo é obrigatório para todas as categorias, exceto as 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. Um serviço pode ser cortar cabelo, instalar 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.

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

Atualizar atributos para um determinado local.