OrganizationContact

客戶組織的聯絡資訊。

JSON 表示法 
{
  "address": {
    object (PostalAddress)
  },
  "email": string,
  "phone": string,
  "contacts": [
    {
      object (Contact)
    }
  ]
}
欄位
address

object (PostalAddress)

這是必要旗標，機構地址。
email

string

選用。機構的電子郵件。
phone

string

選用。機構的電話號碼。
contacts[]

object (Contact)

這是必要旗標，這個地點的機構聯絡窗口。依順序而定：清單中的第一個聯絡人是主要聯絡人，第二個是次要聯絡人，依此類推。

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

選用。最高行政區，用於國家/地區的郵遞地址。例如，此值可以是州、省或縣。如果是西班牙，請填寫省份而非自治區 (例如「Barcelona」而非「Catalonia」)。許多國家/地區的郵寄地址並沒有使用行政區。舉例來說，在瑞士，這個欄位應留空。
locality

string

選用。通常是指地址中的城市或鄉鎮部分。例如：美國城市、義大利市鎮、英國郵鎮。如果世界上的某些地區未明確定義或不適用於此結構，請將 locality 留空並使用 addressLines。
sublocality

string

選用。地址的縣市以下行政區，例如鄰里、自治區或行政區。
addressLines[]

string

非結構化的地址行，說明地址的低層級項目。

由於 addressLines 中的值不含類型資訊，且有時單一欄位可能包含多個值 (例如「Austin, TX」)，因此請務必清楚排列行順序。地址行的順序應符合地址所在國家/地區的「信封順序」。在可能有所不同的地方 (例如日本)，address_language 可用來明確指定 (例如「ja」表示由大到小的順序，「ja-Latn」或「en」表示由小到大)。這樣一來，系統就能根據語言選取最明確的地址行。

地址的最小結構化表示法包含 regionCode，其餘資訊則全部放在 addressLines。您可以在幾乎不使用地理定位的情况下，設定這類地址的格式，但至少在地址局部解析完畢之前，您無法對地址的任何組成部分進行語意推論。

如要處理完全非結構化的地址，建議您建立只包含 regionCode 和 addressLines 的地址，然後進行地理編碼 (而不是猜測地址的哪些部分應為地區或行政區)。
recipients[]

string

選用。地址的收件人。在某些情況下，這個欄位可能會包含多行資訊。舉例來說，此欄位可能包含「代收者」資訊。
organization

string

選用。地址中的機構名稱。