- Recurso: local
- Representação JSON
- BusinessHours
- TimePeriod
- DayOfWeek
- SpecialHours
- SpecialHourPeriod
- ServiceAreaBusiness
- BusinessType
- PointRadius
- LatLng
- Lugares
- PlaceInfo
- LocationKey
- AdWordsLocationExtensions
- OpenInfo
- OpenForBusiness
- LocationState
- Atributo
- RepeatedEnumAttributeValue
- UrlAttributeValue
- Metadados
- Duplicar
- Acesso
- PriceList
- Rótulo
- Seção
- SectionType
- Item
- Dinheiro
- Perfil
- RelationshipData
- MoreHours
- Métodos
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, "locationName": string, "primaryPhone": string, "additionalPhones": [ string ], "address": { object ( |
Campos | |
---|---|
name |
Identificador do Google para este local no formato: No contexto de correspondências, esse campo não será preenchido. |
languageCode |
O idioma do local. Definido durante a criação e não atualizável. |
storeCode |
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. |
locationName |
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, |
primaryPhone |
Um número de telefone que tenha a conexão mais direta possível com o local individual da sua empresa. Sempre que possível, use um número de telefone local em vez do número de uma central de atendimento. |
additionalPhones[] |
É possível ligar para até dois números de telefone (celular ou fixo, não fax) da sua empresa, além do número de telefone principal. |
address |
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 |
primaryCategory |
A categoria que melhor descreve o negócio principal do local. |
additionalCategories[] |
Categorias adicionais para descrever sua empresa. As categorias ajudam os clientes a encontrar resultados precisos e específicos para os serviços em que têm interesse. Para manter suas informações comerciais corretas e atualizadas, use o menor número possível de categorias para descrever seu negócio principal. Escolher categorias o mais específicas possíveis, mas que representem seu negócio principal. |
websiteUrl |
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 |
Horário de funcionamento da empresa. |
specialHours |
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. |
serviceArea |
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. |
locationKey |
Um conjunto de chaves que vinculam essa empresa a outros Serviços do Google, como uma página do Google+ e locais do Google Maps. |
labels[] |
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. Limitado a 255 caracteres (por etiqueta). |
adWordsLocationExtensions |
Informações adicionais que são exibidas no Google AdWords. |
latlng |
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 |
openInfo |
Uma sinalização que indica se o local está aberto para funcionamento. |
locationState |
Apenas saída. Um conjunto de booleanos que reflete o estado de um local. |
attributes[] |
Atributos desse local. |
metadata |
Somente saída. Outras informações não editáveis pelo usuário. |
priceLists[] |
Obsoleto: informações da tabela de preços para este local. |
profile |
Descreve sua empresa com sua própria voz e compartilha com os usuários a história exclusiva dela e de suas ofertas. |
relationshipData |
Todos os locais e redes relacionados a este. |
moreHours[] |
Mais horários de funcionamento para diferentes departamentos ou clientes específicos de uma empresa. |
BusinessHours
Representa os períodos em que esse local está aberto para negócios. Mantém uma coleção de instâncias TimePeriod
.
Representação JSON | |
---|---|
{
"periods": [
{
object ( |
Campos | |
---|---|
periods[] |
Um conjunto de horários em que o local está aberto para negócios. Cada período representa um intervalo de horários em que o local fica aberto durante a semana. |
TimePeriod
Representa um período em que a empresa fica aberta, começando no dia/horário de abertura especificado e fechando no dia/horário de fechamento especificado. O horário de fechamento precisa ser posterior ao de abertura, por exemplo, mais tarde no mesmo dia ou em um dia subsequente.
Representação JSON | |
---|---|
{ "openDay": enum ( |
Campos | |
---|---|
openDay |
Indica o |
openTime |
Hora no formato estendido de 24h ISO 8601 (hh:mm). Os valores válidos são 00:00-24:00, em que 24:00 representa a meia-noite no fim do campo do dia especificado. |
closeDay |
Indica o |
closeTime |
Hora no formato estendido de 24h ISO 8601 (hh:mm). Os valores válidos são 00:00-24:00, em que 24:00 representa a meia-noite no fim do campo do dia especificado. |
DayOfWeek
Representa um dia da semana.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
O dia da semana não é especificado. |
MONDAY |
Segunda-feira |
TUESDAY |
Terça-feira |
WEDNESDAY |
Quarta-feira |
THURSDAY |
Quinta-feira |
FRIDAY |
Sexta-feira |
SATURDAY |
Sábado |
SUNDAY |
Domingo |
SpecialHours
Representa um conjunto de períodos em que o horário de funcionamento de um local difere do horário de funcionamento normal.
Representação JSON | |
---|---|
{
"specialHourPeriods": [
{
object ( |
Campos | |
---|---|
specialHourPeriods[] |
Uma lista de exceções ao horário de funcionamento da empresa. |
SpecialHourPeriod
Representa um único período em que o horário de funcionamento de um local é diferente do horário de funcionamento normal. Um período de horário de funcionamento especial precisa representar um intervalo inferior a 24 horas. openTime
e startDate
precisam ser anteriores a closeTime
e endDate
. closeTime
e endDate
podem se estender até 23h59 do dia seguinte à startDate
especificada. Por exemplo, as seguintes entradas são válidas:
startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59
As entradas a seguir não são válidas:
startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Representação JSON | |
---|---|
{ "startDate": { object ( |
Campos | |
---|---|
startDate |
A data do calendário em que esse período de horário de funcionamento especial começa. |
openTime |
O tempo decorrido em |
endDate |
A data do calendário em que esse período de horário de funcionamento especial termina. Se o campo |
closeTime |
O tempo decorrido em |
isClosed |
Se verdadeiro, |
ServiceAreaBusiness
Empresas com área de cobertura oferecem seus serviços no local do cliente (por exemplo, um chaveiro ou encanador).
Representação JSON | |
---|---|
{ "businessType": enum ( |
Campos | ||
---|---|---|
businessType |
Indica o |
|
Campo de união coverageArea . Indica a área de cobertura onde a empresa oferece serviço. coverageArea pode ser apenas de um dos tipos a seguir: |
||
radius |
Apenas saída. A área que a empresa atende centrada em torno de um ponto. |
|
places |
A área atendida pela empresa definida por um conjunto de lugares. |
BusinessType
Indica se a empresa oferece serviços apenas no local do cliente (por exemplo, um caminhão de reboque) ou no endereço e no local (por exemplo, uma pizzaria com área de refeições, que também faz entregas aos clientes).
Enums | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Apenas saída. Não especificado. |
CUSTOMER_LOCATION_ONLY |
Oferece serviço apenas nas proximidades (não no endereço comercial). |
CUSTOMER_AND_BUSINESS_LOCATION |
Oferece serviço no endereço comercial e nos arredores. |
PointRadius
Um raio em torno de um ponto específico (latitude/longitude).
Representação JSON | |
---|---|
{
"latlng": {
object ( |
Campos | |
---|---|
latlng |
A latitude/longitude que especifica o centro de uma área definida pelo raio. |
radiusKm |
A distância em quilômetros da área ao redor do ponto. |
LatLng
Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. Salvo indicação em contrário, esse objeto precisa estar em conformidade com o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.
Representação JSON | |
---|---|
{ "latitude": number, "longitude": number } |
Campos | |
---|---|
latitude |
A latitude em graus. Precisa estar no intervalo [-90,0, +90,0]. |
longitude |
A longitude em graus. Precisa estar no intervalo [-180,0, +180,0]. |
Places
Define a união de áreas representadas por um conjunto de lugares.
Representação JSON | |
---|---|
{
"placeInfos": [
{
object ( |
Campos | |
---|---|
placeInfos[] |
As áreas representadas por IDs de lugar. Limitado a um máximo de 20 lugares. |
PlaceInfo
Define uma área representada por um ID de lugar.
Representação JSON | |
---|---|
{ "name": string, "placeId": string } |
Campos | |
---|---|
name |
O nome localizado do lugar. Por exemplo, |
placeId |
ID do local. Precisa corresponder a uma região. |
LocationKey
Referências de chave alternativas/alternativas para um local.
Representação JSON | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
Campos | |
---|---|
plusPageId |
Apenas saída. Se esse local tiver uma Página do Google+ associada a ele, ele será preenchido com o ID da Página do Google+ desse local. |
placeId |
Se o local tiver sido verificado e estiver conectado ou aparecer no Google Maps, esse campo será preenchido com o ID do local. Esse ID pode ser usado em várias APIs Places. Se esse local não for verificado, esse campo poderá ser preenchido se tiver sido associado a um lugar que aparece no Google Maps. Este campo pode ser definido durante a criação de chamadas, mas não para a atualização. O booleano |
explicitNoPlaceId |
Apenas saída. O valor "true" indica que um ID de lugar não definido é deliberado, o que é diferente de nenhuma associação ter sido feita ainda. |
requestId |
Apenas saída. O |
AdWordsLocationExtensions
Informações adicionais que são exibidas no Google AdWords.
Representação JSON | |
---|---|
{ "adPhone": string } |
Campos | |
---|---|
adPhone |
Um número de telefone alternativo a ser exibido nas extensões de local do Google AdWords em vez do número de telefone principal do local. |
OpenInfo
Informações relacionadas ao estado de abertura da empresa.
Representação JSON | |
---|---|
{ "status": enum ( |
Campos | |
---|---|
status |
Indica se o local está aberto. Todos os locais ficam abertos por padrão, a menos que sejam atualizados para estarem fechados. |
canReopen |
Apenas saída. Indica se a empresa está qualificada para reabertura. |
openingDate |
A data em que o local foi aberto pela primeira vez. Se o dia exato não for conhecido, apenas o mês e o ano poderão ser informados. A data precisa estar no passado ou não pode ser superior a um ano no futuro. |
OpenForBusiness
Indica o status de um local.
Enums | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Não especificado. |
OPEN |
Indica que o local está aberto. |
CLOSED_PERMANENTLY |
Indica que o local foi permanentemente fechado. |
CLOSED_TEMPORARILY |
Indica que o local foi temporariamente fechado. Esse valor só pode ser aplicado a locais publicados (ou seja, locationState.is_published = true). Ao atualizar o campo de status para esse valor, os clientes precisam definir updateMask explicitamente como openInfo.status . Nenhuma outra máscara de atualização pode ser definida durante essa chamada de atualização. Essa é uma restrição temporária que será flexibilizada em breve. |
LocationState
Contém um conjunto de booleanos que refletem o estado de um local.
Representação JSON | |
---|---|
{ "isGoogleUpdated": boolean, "isDuplicate": boolean, "isSuspended": boolean, "canUpdate": boolean, "canDelete": boolean, "isVerified": boolean, "needsReverification": boolean, "isPendingReview": boolean, "isDisabled": boolean, "isPublished": boolean, "isDisconnected": boolean, "isLocalPostApiDisabled": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "hasPendingEdits": boolean, "hasPendingVerification": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean } |
Campos | |
---|---|
isGoogleUpdated |
Apenas saída. Indica se o ID de lugar associado a esse local tem atualizações. |
isDuplicate |
Apenas saída. Indica se o local é uma duplicata de outro local. |
isSuspended |
Apenas saída. Indica se o local está suspenso. Os locais suspensos não ficam visíveis para os usuários finais nos produtos do Google. Se você acredita que houve um engano, consulte o artigo da Central de Ajuda. |
canUpdate |
Apenas saída. Indica se o local pode ser atualizado. |
canDelete |
Apenas saída. Indica se o local pode ser excluído usando a API Google My Business. |
isVerified |
Apenas saída. Indica se o local foi verificado. |
needsReverification |
Apenas saída. Indica se o local precisa de uma nova verificação. |
isPendingReview |
Apenas saída. Indica se a revisão do local está pendente. |
isDisabled |
Apenas saída. Indica se o local está desativado. |
isPublished |
Apenas saída. Indica se o local foi publicado. |
isDisconnected |
Apenas saída. Indica se o local está desconectado de um lugar no Google Maps. |
isLocalPostApiDisabled |
Apenas saída. Indica se accounts.locations.localPosts está desativado para esse local. |
canModifyServiceList |
Apenas saída. Indica se a ficha da empresa pode modificar uma ServiceList. |
canHaveFoodMenus |
Apenas saída. Indica se a ficha da empresa está qualificada para o cardápio. |
hasPendingEdits |
Apenas saída. Indica se alguma das propriedades desse local está no estado de edição pendente. |
hasPendingVerification |
Apenas saída. Indica se o local tem solicitações de verificação pendentes. |
canOperateHealthData |
Apenas saída. Indica se o local pode operar com dados de Saúde. |
canOperateLodgingData |
Apenas saída. Indica se o local pode operar com dados de hospedagem. |
Atributo
Um atributo de local. Os atributos fornecem informações adicionais sobre um local. Os atributos que podem ser definidos em um local variam de acordo com as propriedades dele (por exemplo, categoria). Os atributos disponíveis são determinados pelo Google e podem ser adicionados e removidos sem mudanças na API.
Representação JSON | |
---|---|
{ "attributeId": string, "valueType": enum ( |
Campos | |
---|---|
attributeId |
O ID do atributo. Os IDs dos atributos são fornecidos pelo Google. |
valueType |
Apenas saída. O tipo de valor que esse atributo contém. Isso deve ser usado para determinar como interpretar o valor. |
values[] |
Os valores deste atributo. O tipo dos valores fornecidos precisa corresponder ao esperado para o atributo. consulte AttributeValueType. Este é um campo repetido em que diversos valores de atributos podem ser fornecidos. Os tipos de atributo aceitam apenas um valor. |
repeatedEnumValue |
Quando o tipo de valor do atributo é REPEATED_ENUM, ele contém o valor do atributo. Os outros campos de valores precisam estar vazios. |
urlValues[] |
Quando o tipo de valor do atributo é URL, esse campo contém os valores desse atributo, e os outros campos de valores precisam estar vazios. |
RepeatedEnumAttributeValue
Valores de um atributo com valueType
de REPEATED_ENUM. Isso consiste em duas listas de IDs de valor: os que são definidos (verdadeiros) e os que não são definidos (falsos). Os valores ausentes são considerados desconhecidos. É necessário especificar pelo menos um valor.
Representação JSON | |
---|---|
{ "setValues": [ string ], "unsetValues": [ string ] } |
Campos | |
---|---|
setValues[] |
Valores de enumeração que estão definidos. |
unsetValues[] |
Valores de enumeração não definidos. |
UrlAttributeValue
Valores de um atributo com um valueType
de URL.
Representação JSON | |
---|---|
{ "url": string } |
Campos | |
---|---|
url |
O URL. |
Metadados
Outras informações não editáveis pelo usuário sobre o local.
Representação JSON | |
---|---|
{
"duplicate": {
object ( |
Campos | |
---|---|
duplicate |
Informações sobre o local duplicado. Presente apenas quando |
mapsUrl |
Um link para o local no Maps. |
newReviewUrl |
Um link para a página na Pesquisa Google em que um cliente pode deixar uma avaliação sobre o local. |
Duplicar
Informações sobre o local duplicado.
Representação JSON | |
---|---|
{
"locationName": string,
"placeId": string,
"access": enum ( |
Campos | |
---|---|
locationName |
O nome do recurso do local duplicado. Preenchido apenas se o usuário autenticado tiver direitos de acesso a esse local e ele não for excluído. |
placeId |
O ID do local que esta duplica. |
access |
Indica se o usuário tem acesso ao local duplicado. |
Acesso
Nível de acesso do usuário ao local duplicado. Substitui Propriedade e deve ser usado no lugar dele.
Enums | |
---|---|
ACCESS_UNSPECIFIED |
Não especificado. |
ACCESS_UNKNOWN |
Não é possível determinar se o usuário tem acesso ao local duplicado. |
ALLOWED |
O usuário tem acesso ao local duplicado. |
INSUFFICIENT |
O usuário não tem acesso ao local duplicado. |
PriceList
Obsoleto: uma lista de informações sobre o preço do item. As listas de preços são estruturadas com uma ou mais listas de preços, cada uma contendo uma ou mais seções com um ou mais itens. Por exemplo, as listas de preços de alimentos podem representar menus de café da manhã/almoço/jantar, com seções para hambúrgueres/bife/frutos do mar.
Representação JSON | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
Campos | |
---|---|
priceListId |
Obrigatório. ID da lista de preços. Os códigos de lista de preços, seção e item não podem ser duplicados neste local. |
labels[] |
Obrigatório. Rótulos com tags de idioma para a lista de preços. |
sourceUrl |
URL de origem opcional do local de onde a lista de preços foi recuperada. Por exemplo, pode ser o URL da página que foi automaticamente copiado para preencher as informações do menu. |
sections[] |
Obrigatório. Seções para esta lista de preços. Cada lista de preços precisa conter pelo menos uma seção. |
Rótulo
Rótulo a ser usado ao exibir a lista de preços, a seção ou o item.
Representação JSON | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
Campos | |
---|---|
displayName |
Obrigatório. Nome de exibição da lista, seção ou item de preços. |
description |
Opcional. Descrição da lista de preços, seção ou item. |
languageCode |
Opcional. O código de idioma BCP-47 ao qual essas strings se aplicam. Só é possível definir um conjunto de rótulos por idioma. |
Seção
Uma seção da lista de preços que contém um ou mais itens.
Representação JSON | |
---|---|
{ "sectionId": string, "labels": [ { object ( |
Campos | |
---|---|
sectionId |
Obrigatório. da seção. Os códigos de lista de preços, seção e item não podem ser duplicados neste local. |
labels[] |
Obrigatório. Rótulos com tag de idioma para a seção. Recomendamos que os nomes e as descrições das seções tenham até 140 caracteres. É necessário pelo menos um conjunto de rótulos. |
sectionType |
Opcional. Tipo da seção da lista de preços atual. O valor padrão é ALIMENTOS. |
items[] |
Itens que estão contidos nesta seção da lista de preços. |
SectionType
Tipo da seção.
Enums | |
---|---|
SECTION_TYPE_UNSPECIFIED |
Não especificado. |
FOOD |
A seção contém itens que representam alimentos. |
SERVICES |
A seção contém itens que representam serviços. |
Item
Um único item da lista. Cada variação de um item na lista de preços deve ter seu próprio Item com seus próprios dados de preços.
Representação JSON | |
---|---|
{ "itemId": string, "labels": [ { object ( |
Campos | |
---|---|
itemId |
Obrigatório. ID do item. Os códigos de lista de preços, seção e item não podem ser duplicados neste local. |
labels[] |
Obrigatório. Rótulos com tag de idioma para o item. Recomendamos que os nomes dos itens tenham até 140 caracteres e as descrições, no máximo 250. É necessário pelo menos um conjunto de rótulos. |
price |
Opcional. Preço do item. |
Dinheiro
Representa um montante em dinheiro com o respectivo tipo de moeda.
Representação JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campos | |
---|---|
currencyCode |
É o código de moeda de três letras definido no ISO 4217. |
units |
As unidades inteiras do montante. Por exemplo, se |
nanos |
Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se |
Perfil
Todas as informações relacionadas ao perfil do local.
Representação JSON | |
---|---|
{ "description": string } |
Campos | |
---|---|
description |
A descrição do local em sua própria voz, não editável por ninguém. |
RelationshipData
Informações de todos os locais principais e secundários relacionados a este.
Representação JSON | |
---|---|
{ "parentChain": string } |
Campos | |
---|---|
parentChain |
O nome do recurso da rede a que este local pertence. |
MoreHours
Período em que um local fica aberto para determinados tipos de empresa.
Representação JSON | |
---|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Campos | |
---|---|
hoursTypeId |
Obrigatório. Tipo de horário de funcionamento. Os clientes devem chamar {#link businessCategories:BatchGet} para receber os tipos de horário de funcionamento aceitos nas categorias dos locais. |
periods[] |
Obrigatório. Um conjunto de horários em que este local está aberto. Cada período representa um intervalo de horários em que o local fica aberto durante a semana. |
Métodos |
|
---|---|
|
Associa um local a um ID de lugar. |
|
Recebe todos os locais especificados na conta especificada. |
|
Retorna a lista paginada de avaliações de todos os locais especificados. |
|
Limpa uma associação entre um local e seu ID de lugar. |
|
Cria um novo location de propriedade da conta especificada e o retorna. |
|
Exclui um local. |
|
Informa todas as opções de verificação qualificadas para um local em um idioma específico. |
|
Encontra todos os locais possíveis que correspondem ao local especificado. |
|
Recebe o local especificado. |
|
Retorna os cardápios de um local específico. |
|
Recebe a versão atualizada pelo Google do local especificado. |
|
Retorna os atributos do profissional de saúde de um local específico. |
|
Acessa a lista de serviços especificada de um local. |
|
Lista os locais da conta especificada. |
|
Atualiza o local especificado. |
|
Retorna um relatório com insights sobre uma ou mais métricas por local. |
(deprecated) |
Move um local de uma conta que o usuário possui para outra conta administrada pelo mesmo usuário. |
|
Atualiza os cardápios de um local específico. |
|
Atualiza os atributos do profissional de saúde de um local específico. |
|
Atualiza a lista de serviços especificada de um local. |
|
Inicia o processo de verificação de um local. |