REST Resource: accounts.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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Campos
name

string

Identificador do Google para este local no formato: accounts/{accountId}/locations/{locationId}

No contexto de correspondências, esse campo não será preenchido.

languageCode

string

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

storeCode

string

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

string

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").

primaryPhone

string

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[]

string

É 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

object (PostalAddress)

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.

primaryCategory

object (Category)

A categoria que melhor descreve o negócio principal do local.

additionalCategories[]

object (Category)

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

string

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)

Horário de funcionamento da empresa.

specialHours

object (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

object (ServiceAreaBusiness)

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

object (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[]

string

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

object (AdWordsLocationExtensions)

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

latlng

object (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 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. Não é possível atualizar este campo.

openInfo

object (OpenInfo)

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

locationState

object (LocationState)

Apenas saída. Um conjunto de booleanos que reflete o estado de um local.

attributes[]

object (Attribute)

Atributos desse local.

metadata

object (Metadata)

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

priceLists[]
(deprecated)

object (PriceList)

Obsoleto: informações da tabela de preços para este local.

profile

object (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

object (RelationshipData)

Todos os locais e redes relacionados a este.

moreHours[]

object (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 (TimePeriod)
    }
  ]
}
Campos
periods[]

object (TimePeriod)

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 (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
Campos
openDay

enum (DayOfWeek)

Indica o day of the week em que o período começa.

openTime

string

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

enum (DayOfWeek)

Indica o day of the week em que o período termina.

closeTime

string

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 (SpecialHourPeriod)
    }
  ]
}
Campos
specialHourPeriods[]

object (SpecialHourPeriod)

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 (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Campos
startDate

object (Date)

A data do calendário em que esse período de horário de funcionamento especial começa.

openTime

string

O tempo decorrido em startDate quando um local abre, expresso no formato estendido de 24 horas 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. Precisa ser especificado se isClosed for falso.

endDate

object (Date)

A data do calendário em que esse período de horário de funcionamento especial termina. Se o campo endDate não estiver definido, o padrão será a data especificada em startDate. Se definido, esse campo precisa ser igual ou no máximo um dia após startDate.

closeTime

string

O tempo decorrido em endDate quando um local fecha, expresso 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. Precisa ser especificado se isClosed for falso.

isClosed

boolean

Se verdadeiro, endDate, openTime e closeTime serão ignorados, e a data especificada na startDate será tratada como o local que ficará fechado o dia inteiro.

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 (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Campos
businessType

enum (BusinessType)

Indica o type da empresa que atende no local do cliente.

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

object (PointRadius)

Apenas saída. A área que a empresa atende centrada em torno de um ponto.

places

object (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 (LatLng)
  },
  "radiusKm": number
}
Campos
latlng

object (LatLng)

A latitude/longitude que especifica o centro de uma área definida pelo raio.

radiusKm

number

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

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].

longitude

number

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 (PlaceInfo)
    }
  ]
}
Campos
placeInfos[]

object (PlaceInfo)

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

string

O nome localizado do lugar. Por exemplo, Scottsdale, AZ.

placeId

string

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

string

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

string

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 adicional qualifica se um ID de lugar não definido é deliberado ou não.

explicitNoPlaceId

boolean

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

string

Apenas saída. O requestId usado para criar este local. Poderá estar vazio se esse local tiver sido criado fora da API Google My Business ou dos locais do Perfil da Empresa.

AdWordsLocationExtensions

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

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

string

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 (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Campos
status

enum (OpenForBusiness)

Indica se o local está aberto. Todos os locais ficam abertos por padrão, a menos que sejam atualizados para estarem fechados.

canReopen

boolean

Apenas saída. Indica se a empresa está qualificada para reabertura.

openingDate

object (Date)

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

boolean

Apenas saída. Indica se o ID de lugar associado a esse local tem atualizações.

isDuplicate

boolean

Apenas saída. Indica se o local é uma duplicata de outro local.

isSuspended

boolean

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

boolean

Apenas saída. Indica se o local pode ser atualizado.

canDelete

boolean

Apenas saída. Indica se o local pode ser excluído usando a API Google My Business.

isVerified

boolean

Apenas saída. Indica se o local foi verificado.

needsReverification

boolean

Apenas saída. Indica se o local precisa de uma nova verificação.

isPendingReview

boolean

Apenas saída. Indica se a revisão do local está pendente.

isDisabled

boolean

Apenas saída. Indica se o local está desativado.

isPublished

boolean

Apenas saída. Indica se o local foi publicado.

isDisconnected

boolean

Apenas saída. Indica se o local está desconectado de um lugar no Google Maps.

isLocalPostApiDisabled

boolean

Apenas saída. Indica se accounts.locations.localPosts está desativado para esse local.

canModifyServiceList

boolean

Apenas saída. Indica se a ficha da empresa pode modificar uma ServiceList.

canHaveFoodMenus

boolean

Apenas saída. Indica se a ficha da empresa está qualificada para o cardápio.

hasPendingEdits

boolean

Apenas saída. Indica se alguma das propriedades desse local está no estado de edição pendente.

hasPendingVerification

boolean

Apenas saída. Indica se o local tem solicitações de verificação pendentes.

canOperateHealthData

boolean

Apenas saída. Indica se o local pode operar com dados de Saúde.

canOperateLodgingData

boolean

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 (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Campos
attributeId

string

O ID do atributo. Os IDs dos atributos são fornecidos pelo Google.

valueType

enum (AttributeValueType)

Apenas saída. O tipo de valor que esse atributo contém. Isso deve ser usado para determinar como interpretar o valor.

values[]

value (Value format)

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

object (RepeatedEnumAttributeValue)

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[]

object (UrlAttributeValue)

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[]

string

Valores de enumeração que estão definidos.

unsetValues[]

string

Valores de enumeração não definidos.

UrlAttributeValue

Valores de um atributo com um valueType de URL.

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

string

O URL.

Metadados

Outras informações não editáveis pelo usuário sobre o local.

Representação JSON
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Campos
duplicate
(deprecated)

object (Duplicate)

Informações sobre o local duplicado. Presente apenas quando locationState.is_duplicate é verdadeiro. Obsoleto: não oferecemos mais suporte a informações detalhadas para duplicatas.

mapsUrl

string

Um link para o local no Maps.

newReviewUrl

string

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 (Access)
}
Campos
locationName

string

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

string

O ID do local que esta duplica.

access

enum (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 (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Campos
priceListId

string

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[]

object (Label)

Obrigatório. Rótulos com tags de idioma para a lista de preços.

sourceUrl

string

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[]

object (Section)

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

string

Obrigatório. Nome de exibição da lista, seção ou item de preços.

description

string

Opcional. Descrição da lista de preços, seção ou item.

languageCode

string

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 (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Campos
sectionId

string

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[]

object (Label)

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

enum (SectionType)

Opcional. Tipo da seção da lista de preços atual. O valor padrão é ALIMENTOS.

items[]

object (Item)

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 (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Campos
itemId

string

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[]

object (Label)

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

object (Money)

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

string

É o código de moeda de três letras definido no ISO 4217.

units

string (int64 format)

As unidades inteiras do montante. Por exemplo, se currencyCode for "USD", 1 unidade equivalerá a um dólar americano.

nanos

integer

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 units for positivo, nanos precisará ser positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos precisará ser negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

Perfil

Todas as informações relacionadas ao perfil do local.

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

string

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

string

O nome do recurso da rede a que este local pertence. How to find Chain ID

MoreHours

Período em que um local fica aberto para determinados tipos de empresa.

Representação JSON
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Campos
hoursTypeId

string

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[]

object (TimePeriod)

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

associate

Associa um local a um ID de lugar.

batchGet

Recebe todos os locais especificados na conta especificada.

batchGetReviews

Retorna a lista paginada de avaliações de todos os locais especificados.

clearAssociation

Limpa uma associação entre um local e seu ID de lugar.

create

Cria um novo location de propriedade da conta especificada e o retorna.

delete

Exclui um local.

fetchVerificationOptions

Informa todas as opções de verificação qualificadas para um local em um idioma específico.

findMatches

Encontra todos os locais possíveis que correspondem ao local especificado.

get

Recebe o local especificado.

getFoodMenus

Retorna os cardápios de um local específico.

getGoogleUpdated

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

getHealthProviderAttributes

Retorna os atributos do profissional de saúde de um local específico.

getServiceList

Acessa a lista de serviços especificada de um local.

list

Lista os locais da conta especificada.

patch

Atualiza o local especificado.

reportInsights

Retorna um relatório com insights sobre uma ou mais métricas por local.

transfer
(deprecated)

Move um local de uma conta que o usuário possui para outra conta administrada pelo mesmo usuário.

updateFoodMenus

Atualiza os cardápios de um local específico.

updateHealthProviderAttributes

Atualiza os atributos do profissional de saúde de um local específico.

updateServiceList

Atualiza a lista de serviços especificada de um local.

verify

Inicia o processo de verificação de um local.