OrganizationContact

Dados de contato da organização do cliente.

Representação JSON 
{
  "address": {
    object (PostalAddress)
  },
  "email": string,
  "phone": string,
  "contacts": [
    {
      object (Contact)
    }
  ]
}
Campos
address

object (PostalAddress)

Obrigatório. O endereço da organização.
email

string

Opcional. O e-mail da organização.
phone

string

Opcional. O número de telefone da organização.
contacts[]

object (Contact)

Obrigatório. Os pontos de contato individuais na organização nesse local. Dependente da ordem: o primeiro contato na lista é o principal, o segundo é o secundário etc.

PostalAddress

Representa um endereço postal, como para entrega postal ou endereços de pagamento. Com um endereço postal, um serviço postal pode entregar itens em um local, caixa postal ou similar. Um endereço postal não se destina a modelar localizações geográficas, como estradas, cidades ou montanhas.

No uso típico, um endereço é criado pela entrada do usuário ou pela importação de dados, dependendo do tipo de processo.

Conselhos sobre como inserir ou editar endereços:

  • Use um widget de endereço pronto para internacionalização, como https://github.com/google/libaddressinput.
  • Os usuários não devem ver elementos da UI para entrada ou edição de campos fora dos países em que esse campo é usado.

Para mais orientações sobre como usar esse esquema, consulte: https://support.google.com/business/answer/6397478.

Representação JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campos
revision

integer

A revisão do esquema de 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.
regionCode

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. Consulte https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html para mais detalhes. Exemplo: "CH" para Suíça.
languageCode

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

string

Opcional. Código postal do endereço. Nem todos os países usam ou exigem códigos postais, mas, quando usados, eles podem acionar uma validação adicional com outras partes do endereço (por exemplo, validação de estado ou CEP nos Estados Unidos).
sortingCode

string

Opcional. Código de classificação adicional específico de país. Não é usado na maioria das regiões. Quando usado, o valor é uma string como "CEDEX", opcionalmente seguida por um número (por exemplo, "CEDEX 7"), ou apenas um número, que representa o "código do setor" (Jamaica), o "indicador de área de entrega" (Malawi) ou o "indicador de agência postal" (Costa do Marfim).
administrativeArea

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. Para a Espanha, é a província, e não a comunidade autônoma (por exemplo, "Barcelona", e não "Catalunha"). Muitos países não usam área administrativa em endereços postais. Por exemplo, na Suíça, esse campo deve ser deixado em branco.
locality

string

Opcional. Geralmente se refere à cidade do endereço. Exemplos: cidade nos EUA, comunidade na Itália, distrito postal no Reino Unido. Em regiões do mundo com localizações que não são bem definidas ou que não se encaixam nessa estrutura, deixe locality vazio e use addressLines.
sublocality

string

Opcional. Sublocalidade do endereço. Por exemplo, pode ser um bairro, município ou distrito.
addressLines[]

string

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

Como os valores em addressLines não têm informações de tipo e, às vezes, podem conter vários valores em um único campo (por exemplo, "Austin, TX"), é importante que a ordem das linhas seja clara. A ordem das linhas de endereço precisa ser a "ordem do envelope" para o país ou região do endereço. Em lugares onde isso pode variar (por exemplo, no Japão), address_language é usado para deixar isso explícito (por exemplo, "ja" para ordenação do maior para o menor e "ja-Latn" ou "en" para ordenação do menor para o maior). Dessa 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 no 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 contenha apenas 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 político-administrativas).
recipients[]

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

string

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