お客様の組織の連絡先情報。
| JSON 表現 |
|---|
{ "address": { object ( |
| フィールド | |
|---|---|
address |
必須。組織の住所。 |
email |
省略可。組織のメールアドレス。 |
phone |
省略可。組織の電話番号。 |
contacts[] |
必須。この拠点の組織内の個々の連絡先。 |
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 |
新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。 |
regionCode |
必須。住所の国 / 地域に対応する CLDR 地域コード。これは推測されず、値が正しいことを確認するのはユーザー次第です。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。 |
languageCode |
省略可。この住所の内容の BCP-47 言語コード(分かっている場合)。これは、入力フォームの UI 言語であることが多く、住所の国/リージョンで使用されている言語のいずれか、またはそれらの文字変換された同等語と一致することが期待されます。これは、特定の国の書式設定に影響する可能性がありますが、データの正確性には重要ではなく、検証やその他の書式設定関連でない操作にはに影響しません。 この値が不明な場合は、省略してください(正しくない可能性のあるデフォルトを指定するのではなく)。 例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。 |
postalCode |
省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります(例: 米国での州 / 郵便番号の確認)。 |
sortingCode |
省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」のような文字列で、その後に必要に応じて数字を付けたもの(例: 「CEDEX 7」)や、数字だけのものがあります。たとえば、ジャマイカの「セクターコード」、マラウイの「配達区域インジケータ」、コートジボワールの「郵便局インジケータ」などです。 |
administrativeArea |
省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがあります。具体的には、スペインの場合、これは自治州ではなく、県になります(例:「カタルーニャ」ではなく、「バルセロナ」)。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。 |
locality |
省略可。一般的に住所の市町村部分を指します。たとえば、米国の市、イタリアのコムーネ、英国のポスト町。地域区分が適切に定義されていない地域や、この構造にうまく適合しない世界の地域では、locality を空のままにして addressLines を使用します。 |
sublocality |
省略可。住所の市町村部分の下位の区画。たとえば、町、区、地区などがあります。 |
addressLines[] |
住所の下位部分を記述する非構造化の住所行。 addressLines の値は型情報を持たず、単一の項目に複数の値を含めることがあるため(例: 「Austin, TX」)、行の順序が明確であることが重要です。住所行の順序は、その住所の国 / 地域の「封筒順」であることが必要です。これが一定ではない可能性のある場所(たとえば日本)では、address_language を使用して明示的に指定します(例: 大から小の順序の場合は「ja」、小から大の場合は「ja-Latn」または「en」)。このように、住所の最も詳細な部分の行を言語に基づいて選択できます。 住所の最小許容構造化表現は、addressCode と addressLines に残りのすべての情報が格納されて構成されます。そのような住所を、ジオコーディングなしできわめて正確に近く書式設定することも可能ですが、住所の構成要素についての意味的な推論は、少なくとも部分的に解決されるまでは不可能です。 構造化されていない住所を完全に処理するためには、regionCode と addressLines のみを含むアドレス住所を作成してからジオコーディングを行うことをおすすめします(住所のどの部分が地域区分であるか、行政区域であるかを推測するのではなく)。 |
recipients[] |
省略可。その住所で受け取る人。この項目は、状況によって複数の情報を含むことがあります。たとえば、「様方」情報が含まれる場合があります。 |
organization |
省略可。その住所にある組織の名前。 |