OrganizationContact

お客様の組織の連絡先情報。

JSON 表現 
{
  "address": {
    object (PostalAddress)
  },
  "email": string,
  "phone": string,
  "contacts": [
    {
      object (Contact)
    }
  ]
}
フィールド
address

object (PostalAddress)

必須。組織の住所。
email

string

省略可。組織のメールアドレス。
phone

string

省略可。組織の電話番号。
contacts[]

object (Contact)

必須。この場所にある組織の個々の連絡先。順序依存: リストの最初の連絡先が連絡先担当者、2 番目が副連絡先など。

PostalAddress

郵便物の配達先住所や支払い先住所などの住所を表します。郵便サービスは、郵便住所を使用して、敷地や私書箱などに郵便物を配達できます。郵送先住所は、道路、町、山などの地理的位置をモデル化することを目的としていません。

一般的な使用法では、住所を作成するにはユーザー入力や既存データのインポートなどの方法がプロセスに応じて使用されます。

住所の入力または編集に関するアドバイス:

  • 国際化対応の住所ウィジェット（https://github.com/google/libaddressinput など）を使用してください。
  • フィールドの入力または編集に使用する UI 要素は、そのフィールドが使用されない国ではユーザーに表示しないでください。

このスキーマの使用方法の詳細については、https://support.google.com/business/answer/6397478 をご覧ください。

JSON 表現 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
フィールド
revision

integer

PostalAddress のスキーマ リビジョン。これは、最新のリビジョンである 0 に設定する必要があります。

新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。
regionCode

string

必須。住所の国 / 地域に対応する CLDR 地域コード。これは推測されず、値が正しいことを確認するのはユーザー次第です。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。
languageCode

string

省略可。この住所の内容の BCP-47 言語コード（分かっている場合）。これは、入力フォームの UI 言語であることが多く、住所の国/リージョンで使用されている言語のいずれか、またはそれらの文字変換された同等語と一致することが期待されます。これは、特定の国の書式設定に影響する可能性がありますが、データの正確性には重要ではなく、検証やその他の書式設定関連でない操作にはに影響しません。

この値が不明な場合は、省略してください（正しくない可能性のあるデフォルトを指定するのではなく）。

例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。
postalCode

string

省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります（例: 米国での州 / 郵便番号の確認）。
sortingCode

string

省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」などの文字列（必要に応じて「CEDEX 7」などの数字が続く）か、数字のみで、「セクターコード」（ジャマイカ）、「配達エリア インジケーター」（マラウイ）、「郵便局インジケーター」（コートジボワール）を表します。
administrativeArea

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがあります。スペインの場合、これは自治州ではなく県です（例: 「Catalonia」ではなく「Barcelona」）。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。
locality

string

省略可。一般的に住所の市町村部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町です。国 / 地域によっては、これに相当する地域区分が明確に定義されていない場合や、この構造にうまく適合しない場合がありますが、その場合は locality を空のままにして addressLines を使用します。
sublocality

string

省略可。住所の市町村部分の下位の区画。たとえば、近隣地域、区、地区などです。
addressLines[]

string

住所の下位部分を記述する非構造化の住所行。

addressLines の値には型情報がなく、1 つのフィールドに複数の値が含まれることがあるため（例: 「Austin, TX」）、行の順序を明確にすることが重要です。住所行の順序は、住所の国または地域の「封筒の順序」にする必要があります。この順序が異なる地域（日本など）では、address_language を使用して明示的に指定します（たとえば、大きい単位から小さい単位の順序の場合は「ja」、小さい単位から大きい単位の順序の場合は「ja-Latn」または「en」）。このようにして、言語に基づいて住所の最も具体的な行を選択できます。

住所の構造表現の最小要件は、regionCode と、残りのすべての情報を含む addressLines です。そのような住所を、ジオコーディングなしできわめて正確に近く書式設定することも可能ですが、住所の構成要素についての意味的な推論は、少なくとも部分的に解決されるまでは不可能です。

まったく構造化されていない住所を扱うときは、regionCode と addressLines だけで構成される住所を作成してからジオコーディングすることが、おすすめの方法です（住所のどの部分が地域区分で、どれが行政区域かを推測するのではなく）。
recipients[]

string

省略可。その住所で受け取る人。この項目は、状況によって複数の情報を含むことがあります。たとえば、「様方」情報が含まれる場合があります。
organization

string

省略可。その住所にある組織の名前。