REST Resource: accounts.locations

string

Obrigatório. 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.

string

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

object (Category)

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

object (Category)

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

string

Obrigatório. Um ID estável (fornecido pelo Google) para esta categoria. O valor precisa ser especificado ao modificar a categoria (ao criar ou atualizar um local).

string

Apenas saída. O nome legível da categoria. Ele é definido na leitura do local. Ao modificar o local, category_id precisa ser definido.

object (ServiceType)

Apenas saída. Uma lista de todos os tipos de serviço disponíveis para essa categoria de negócios.

object (MoreHoursType)

Apenas saída. Mais tipos de horário de funcionamento disponíveis para essa categoria de negócios.

string

Apenas saída. Um ID estável (fornecido pelo Google) para esse tipo de serviço.

string

Apenas saída. O nome de exibição legível por humanos para o tipo de serviço.

string

Apenas saída. Um ID estável fornecido pelo Google para esse tipo de horário de funcionamento.

string

Apenas saída. O nome de exibição legível em inglês para o tipo de horário.

string

Apenas saída. O nome de exibição localizado legível para o tipo de horário de funcionamento.

integer

A revisão de esquema do PostalAddress. Precisa ser definido como 0, que é a revisão mais recente.

Todas as novas revisões precisam ser compatíveis com versões anteriores.

string

Obrigatório. Código de região CLDR do país/região do endereço. Nunca é inferido e cabe ao usuário garantir que o valor esteja correto. Para mais detalhes, consulte https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para Suíça.

string

Opcional. Código de idioma BCP-47 do conteúdo deste endereço (se conhecido). Costuma ser o idioma da IU do formulário de entrada ou espera-se que corresponda a um dos idiomas usados no país/região do endereço ou nos equivalentes transliterados dele. Pode afetar a formatação em determinados países, mas não é fundamental para a exatidão dos dados e nunca afetará a validação ou outras operações relacionadas à não formatação.

Se você não conhece o valor, omita-o (em vez de especificar um padrão possivelmente incorreto).

Exemplos: "zh-Hant", "ja", "ja-latn", "pt".

string

Opcional. Código postal do endereço. Nem todos os países usam ou exigem códigos postais, mas nos locais onde são usados, eles podem desencadear uma validação adicional com outras partes do endereço (por exemplo, validação de estado/CEP nos EUA).

string

Opcional. Código de classificação adicional específico de país. Não é usado na maioria das regiões. Nos locais em que é usado, o valor é uma string como “CEDEX”, que pode ser seguida por um número (por exemplo, “CEDEX 7”), ou apenas um número sozinho, representando o “código do setor” (Jamaica), o “indicador de área de entrega” (Malawi) ou o “indicador de agência de correio” (por exemplo, Costa do Marfim).

string

Opcional. A maior subdivisão administrativa que é usada para endereços postais de um país ou uma região. Por exemplo, pode ser um estado, uma província, uma zona ou uma prefeitura. Especificamente na Espanha, é a província, e não a comunidade autônoma (por exemplo, “Barcelona”, não “Catalunha”). Muitos países não usam área administrativa em endereços postais. Por exemplo, na Suíça, isso deve ser deixado em branco.

string

Opcional. Geralmente se refere à parte do endereço relativa a cidade/município. Exemplos: cidade nos EUA, comunidade na Itália, distrito postal no Reino Unido. Em regiões onde as localidades não são claramente definidas ou não se encaixam bem nessa estrutura, deixe a localidade em branco e use addressLines.

string

Opcional. Sublocalidade do endereço. Por exemplo, pode ser bairro ou distrito.

string

Linhas de endereço não estruturadas que descrevem os níveis mais detalhados de um endereço.

Como os valores em addressLines não têm informações de tipo e podem conter diversos valores em um único campo (por exemplo, “Austin, TX”), é importante que a ordem da linha seja clara. Ela precisa estar em “ordem de envelope” em país ou região do endereço. Em locais em que isso pode variar (por exemplo, Japão), address_language é usado para explicitar (por exemplo, "ja" para ordem do maior para o menor e "ja-Latn" ou "pt" para ordem do menor para o maior). Desta forma, a linha mais específica de um endereço pode ser selecionada com base no idioma.

A representação estrutural mínima permitida de um endereço consiste em um regionCode com todas as informações restantes colocadas em addressLines. Seria possível formatar esse endereço sem geocodificação, mas nenhum raciocínio semântico poderia ser feito sobre qualquer um dos componentes do endereço até que ele fosse pelo menos parcialmente resolvido.

Criar um endereço que apresente apenas um regionCode e addressLines e depois geocodificar é a maneira recomendada de lidar com endereços completamente não estruturados (em vez de adivinhar quais partes do endereço devem ser localidades ou áreas administrativas).

string

Opcional. O destinatário no endereço. Sob certas circunstâncias, este campo pode conter informações em várias linhas. Por exemplo, informações sobre cuidados.

string

Opcional. O nome da organização no endereço.

object (TimePeriod)

Obrigatório. 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.

enum (DayOfWeek)

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

object (TimeOfDay)

Obrigatório. 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.

enum (DayOfWeek)

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

object (TimeOfDay)

Obrigatório. 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.

integer

Horas do dia no formato de 24 horas. Precisa ser de 0 a 23. Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.

integer

Minutos da hora do dia. Precisa ser de 0 a 59.

integer

Segundos do minutos do horário. Normalmente precisa ser de 0 a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.

integer

Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999.

object (SpecialHourPeriod)

Obrigatório. Uma lista de exceções ao horário de funcionamento da empresa.

object (Date)

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

object (TimeOfDay)

Opcional. 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 closed for falso.

object (Date)

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

object (TimeOfDay)

Opcional. Os valores válidos são 00:00-24:00, onde 24:00 representa a meia-noite no fim do campo do dia especificado. Precisa ser especificado se closed for falso.

boolean

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

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

enum (BusinessType)

Obrigatório. Indica o [tipo] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] da empresa que atende no local do cliente.

object (Places)

A área atendida pela empresa definida por um conjunto de lugares.

string

Imutável. Código regional CLDR do país ou da região em que essa empresa de área de cobertura está localizada. Para mais detalhes, consulte http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para Suíça.

Este campo é obrigatório para empresas CUSTOMER_LOCATION_ONLY. Caso contrário, é ignorado.

A região especificada aqui pode ser diferente das regiões das áreas em que a empresa atua (por exemplo, empresas que prestam serviços em regiões diferentes daquela em que estão sediadas).

Se for necessário confirmar o local após a criação, o endereço fornecido para fins de verificação precisa estar localizado nessa região, e o proprietário da empresa ou o representante autorizado dele precisa receber correspondências no endereço de verificação fornecido.

object (PlaceInfo)

As áreas representadas por IDs de lugar. Limitado a um máximo de 20 lugares.

string

Obrigatório. O nome localizado do lugar. Por exemplo, Scottsdale, AZ.

string

Obrigatório. ID do local. Precisa corresponder a uma região. (https://developers.google.com/places/web-service/supported_types#table3)

string

Obrigatório. 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.

number

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

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

boolean

Apenas saída. Indica se o ID de lugar associado a esse local tem atualizações que precisam ser atualizadas ou rejeitadas pelo cliente. Se esse booleano estiver definido, chame o método getGoogleUpdated para buscar as informações que precisam ser verificadas.

boolean

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

boolean

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

boolean

Apenas saída. Indica se a ficha da empresa pode gerenciar postagens locais.

boolean

Apenas saída. Indica se a ficha da empresa pode modificar a lista de serviços.

boolean

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

boolean

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

boolean

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

string

Apenas saída. Se esse local aparecer no Google Maps, esse campo será preenchido com o ID do local. Esse ID pode ser usado em várias APIs Places.

Este campo pode ser definido durante a criação de chamadas, mas não para a atualização.

string

Apenas saída. O recurso de local duplicado por esse local.

string

Apenas saída. Um link para o local no Maps.

string

Apenas saída. Um link para a página na Pesquisa Google em que um cliente pode deixar uma avaliação sobre o local.

boolean

Apenas saída. Indica se a ficha da empresa está qualificada para ligações comerciais.

boolean

Apenas saída. Indica se a ficha da empresa tem a voz do comerciante. Se o booleano for "false", chame a API locations.getVoiceOfMerchantState para saber detalhes sobre o motivo da ausência do Voice of Merchant.

string

Obrigatório. A descrição do local em sua própria voz, não editável por ninguém.

object (RelevantLocation)

O local pai com o qual esse local tem relações.

object (RelevantLocation)

A lista de locais filhos relacionados ao local.

string

O nome do recurso da rede a que este local pertence. [Como encontrar o ID da rede] [Locations.SearchChains]

string

Obrigatório. Especifique o local que está do outro lado da relação com o ID de lugar.

enum (RelationType)

Obrigatório. O tipo da relação.

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.

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.

object (Money)

Opcional. Representa o preço monetário do item de serviço. Recomendamos que o currencyCode e as unidades sejam definidos ao incluir um preço. Esse valor será tratado como um preço fixo do item de serviço.

object (StructuredServiceItem)

Opcional. Este campo será definido como o caso dos dados de serviços estruturados.

object (FreeFormServiceItem)

Opcional. Este campo será definido como o caso dos dados de serviços de formato livre.

string

Obrigatório. O campo serviceTypeId é um ID exclusivo fornecido pelo Google e que pode ser encontrado em ServiceType. Essa informação é fornecida pelo serviço de RPC categories.batchGet.

string

Opcional. Descrição do item de serviço estruturado. O limite de caracteres é de 300.

string

Obrigatório. Esse campo representa o nome da categoria (ou seja, o ID estável da categoria). category e serviceTypeId precisam corresponder às possíveis combinações fornecidas na mensagem Category.

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. Esse campo só deverá ser definido se a entrada for um item de serviço personalizado. Os tipos de serviço padronizados precisam ser atualizados com serviceTypeId.

string

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

string

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

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.

string

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

string (int64 format)

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

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.