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 consultar 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, este campo não será preenchido.

languageCode

string

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

storeCode

string

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

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

primaryCategory

object (Category)

A categoria que melhor descreve a área de atuação principal do local.

additionalCategories[]

object (Category)

Categorias adicionais para descrever sua empresa. As categorias ajudam seus clientes a encontrar resultados precisos e específicos para os serviços em que têm interesse. Para manter suas informações comerciais precisas 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 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)

Horário de funcionamento da empresa.

specialHours

object (SpecialHours)

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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Um conjunto de chaves que vinculam esta empresa a outros Serviços do Google, como uma página do Google+ e lugares do Google Maps.

labels[]

string

É 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. Limitado a 255 caracteres (por rótulo).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Informações adicionais exibidas no Google AdWords.

latlng

object (LatLng)

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

openInfo

object (OpenInfo)

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

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 lista de preços para este local.

profile

object (Profile)

Descreve sua empresa com sua voz e compartilha com os usuários a história da sua empresa e das 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 este 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 horas em que o local fica aberto durante a semana.

TimePeriod

Representa um período em que a empresa está 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 horário 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 00h00-24h00, em que 24h00 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 00h00-24h00, em que 24h00 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 é diferente do horário comercial normal.

Representação JSON
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Campos
specialHourPeriods[]

object (SpecialHourPeriod)

Uma lista de exceções para o 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 comercial normal. Um período de horário de funcionamento especial precisa representar um intervalo de menos de 24 horas. A openTime e a startDate precisam anteceder a closeTime e a endDate. closeTime e endDate podem ser estendidos para 23h59 do dia seguinte ao startDate especificado. Por exemplo, as entradas a seguir 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 00h00-24h00, em que 24h00 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 for definido, o padrão será a data especificada em startDate. Se definido, esse campo precisa ser igual a ou no máximo 1 dia após startDate.

closeTime

string

O tempo decorrido em endDate quando um local fecha, expresso no formato estendido de 24 horas ISO 8601. (hh:mm) Os valores válidos são 00h00-24h00, em que 24h00 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 são ignorados, e a data especificada em startDate é tratada como o local fechado o dia inteiro.

ServiceAreaBusiness

Empresas de serviço local prestam serviços no local do cliente (por exemplo, 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 de serviço local.

Campo de união coverageArea. Indica a área de cobertura em que a empresa oferece serviços. coverageArea pode ser apenas de um dos tipos a seguir:
radius

object (PointRadius)

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

places

object (Places)

A área que essa empresa atende, definida por um conjunto de lugares.

BusinessType

Indica se a empresa só oferece serviços no local no local do cliente (por exemplo, um caminhão) ou no local e no local (por exemplo, uma pizzaria com área de refeições que também faz entregas).

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. A menos que especificado de outra forma, 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 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

O ID do local. Precisa corresponder a uma region.

LocationKey

Referências de chave alternativas para um local.

Representação JSON
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Campos
plusPageId

string

Apenas saída. Se esse local estiver associado a uma página do Google+, ele será preenchido com o ID da página do Google+ desse local.

placeId

string

Se o local tiver sido verificado e estiver conectado ao Google Maps ou aparecer nele, esse campo será preenchido com o ID do local. Esse ID pode ser usado em várias APIs Places.

Se esse local não tiver sido verificado, esse campo poderá ser preenchido se o local 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 Update.

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 esse 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 exibidas no Google AdWords.

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

string

Um número de telefone alternativo que 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 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 fornecidos. A data precisa estar no passado ou no máximo 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_publication = 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 esta 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 associado a esse local tem atualizações.

isDuplicate

boolean

Apenas saída. Indica se o local é uma cópia de outro.

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 isso foi um erro, 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 requer 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 listagem pode modificar uma ServiceList.

canHaveFoodMenus

boolean

Apenas saída. Indica se o anúncio está qualificado para um cardápio de refeições.

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 em dados de Saúde.

canOperateLodgingData

boolean

Apenas saída. Indica se o local pode operar em 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 podem variar 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

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

valueType

enum (AttributeValueType)

Apenas saída. O tipo de valor que este atributo contém. É usado para determinar como interpretar o valor.

values[]

value (Value format)

Os valores para este atributo. O tipo dos valores fornecidos precisa corresponder ao esperado para esse atributo. Consulte AttributeValueType. Esse é um campo repetido em que vários valores de atributo 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, e 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 um valueType de REPEATED_ENUM. Isso consiste em duas listas de IDs de valor: aquelas definidas (true) e aquelas que não estão definidas (false). 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 são definidos.

unsetValues[]

string

Valores de enumeração que não sã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. Descontinuado: não há mais suporte para informações detalhadas de duplicatas.

mapsUrl

string

Um link para o local no Maps.

newReviewUrl

string

Um link para a página na Pesquisa Google em que o cliente pode avaliar 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 ao local e ele não tiver sido excluído.

placeId

string

O ID do local duplicado.

access

enum (Access)

Indica se o usuário tem acesso ao local duplicado.

Acesso

Nível de acesso do usuário ao local duplicado. Isso substitui a propriedade "Propriedade" e deve ser usado.

Enums
ACCESS_UNSPECIFIED Não especificado.
ACCESS_UNKNOWN Não foi 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 preços de itens. As listas de preços são estruturadas como 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 podem representar menus de café da manhã/almoço/jantar, com seções de hambúrgueres/filés/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. A lista de preços, a seção e os códigos do 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 de onde a lista de preços foi extraída. Por exemplo, pode ser o URL da página que foi copiada automaticamente para preencher as informações do menu.

sections[]

object (Section)

Obrigatório. Seções desta lista de preços. Cada lista de preços precisa conter pelo menos uma seção.

Rótulo

Rótulo 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 de preços, seção ou item.

description

string

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

languageCode

string

Opcional. O código de idioma BCP-47 a que essas strings se aplicam. Somente um conjunto de marcadores pode ser definido por idioma.

Seção

Uma seção da lista de preços com um ou mais itens.

Representação JSON
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Campos
sectionId

string

Obrigatório. ID da seção. A lista de preços, a seção e os códigos do item não podem ser duplicados neste local.

labels[]

object (Label)

Obrigatório. Rótulos com tags de idioma para a seção. Recomendamos que os nomes e descrições das seções tenham 140 caracteres ou menos. É necessário pelo menos um conjunto de rótulos.

sectionType

enum (SectionType)

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

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 de lista. Cada variação de um item na lista de preços precisa ter um item próprio com dados de preços próprios.

Representação JSON
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Campos
itemId

string

Obrigatório. ID do item. A lista de preços, a seção e os códigos do item não podem ser duplicados neste local.

labels[]

object (Label)

Obrigatório. Rótulos com tags de idioma para o item. Recomendamos que os nomes dos itens tenham até 140 caracteres e as descrições até 250 caracteres. É 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

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

Descrição do local com sua própria voz, não editável por outras pessoas.

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 de que esse local faz parte. How to find Chain ID

MoreHours

Os períodos 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 saberem os tipos de horário aceitos para as categorias de seus locais.

periods[]

object (TimePeriod)

Obrigatório. Um conjunto de horários em que o local está aberto. Cada período representa um intervalo de horas em que o local fica aberto durante a semana.

Métodos

associate

Associa um local a um ID de lugar.

batchGet

Mostra 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 e retorna um novo location da conta especificada.

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 alimentos de um local específico.

getGoogleUpdated

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

getHealthProviderAttributes

Retorna os atributos do provedor 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 do usuário para outra gerenciada pelo mesmo usuário.

updateFoodMenus

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

updateHealthProviderAttributes

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

updateServiceList

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

verify

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