REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

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.

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

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

object (Category)

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

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

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

string

Apenas saída. O nome legível da categoria. É definido durante a 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 esta categoria de negócios.

{
  "serviceTypeId": string,
  "displayName": string
}

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 para o tipo de serviço.

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

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

string

Apenas saída. O nome de exibição legível localizado para o tipo de hora.

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

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.

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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 horas em que o local fica aberto durante a semana.

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

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 00h00-24h00, em que 24h00 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 00h00-24h00, em que 24h00 representa a meia-noite no fim do campo do dia especificado.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

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.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

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

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

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

object (TimeOfDay)

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

boolean

Opcional. Se verdadeiro, endDate, openTime e closeTime são ignorados, e a data especificada em startDate é tratada como o local fechado o dia inteiro.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Ano da data. Precisa ser de 1 a 9999 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.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

Obrigatório. Indica o [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] da empresa com área de cobertura.

object (Places)

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

string

Imutável. Código regional do CLDR do país/região em que a empresa que atende no local do cliente está localizada. Para mais detalhes, acesse 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 com CUSTOMER_LOCATION_SOMENTE. Caso contrário, ele é ignorado.

A região especificada aqui pode ser diferente das regiões onde essa empresa atende (por exemplo, empresas que prestam serviços em outras regiões).

Se o local exigir verificação após a criação, o endereço informado para fins de verificação precisa estar nessa região, e o proprietário da empresa ou o representante autorizado precisa estar disponível para receber correspondências no endereço de verificação fornecido.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

As áreas representadas por IDs de lugar. É limitado a 20 lugares.

{
  "placeName": string,
  "placeId": string
}

string

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

string

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

{
  "adPhone": string
}

string

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

{
  "latitude": number,
  "longitude": number
}

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

enum (OpenForBusiness)

Obrigatório. Indica se o local está aberto. Todos os locais ficam abertos por padrão, a menos que sejam atualizados para 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 fornecidos. A data precisa estar no passado ou no máximo um ano no futuro.

{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}

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 procurar 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 listagem pode modificar a lista de serviços.

boolean

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

boolean

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

boolean

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

string

Apenas saída. Se o local aparecer no Google Maps, o 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 Update.

string

Apenas saída. O recurso de local duplicado por este 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 o cliente pode avaliar o local.

boolean

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

boolean

Apenas saída. Indica se a ficha da empresa tem a voz do comerciante. Se esse booleano for falso, chame a API locations.getVoiceOfMerchantState para saber por que a empresa não tem a voz do comerciante.

{
  "description": string
}

string

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

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

O local pai com o qual esse local está relacionado.

object (RelevantLocation)

A lista de locais filhos com que esse local tem relações.

string

O nome do recurso da cadeia de que esse local faz parte. [Como encontrar o ID da rede] [Locations.SearchChains]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

Obrigatório. Especifique o local que está do outro lado da relação pelo placeID.

enum (RelationType)

Obrigatório. O tipo de relacionamento.

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

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.

{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}

object (Money)

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

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

{
  "serviceTypeId": string,
  "description": string
}

string

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

string

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

{
  "category": string,
  "label": {
    object (Label)
  }
}

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 tags de idioma para o item. Recomendamos que os nomes dos itens tenham até 140 caracteres e as descrições até 250 caracteres. Este campo só deverá ser definido se a entrada for um item de serviço personalizado. Os tipos de serviço padronizados precisam ser atualizados por serviceTypeId.

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

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

string

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

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.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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.