本頁面由 Cloud Translation API 翻譯而成。

REST Resource: people
透過集合功能整理內容你可以依據偏好儲存及分類內容。

資源：Person
方法

資源：Person

合併使用者的資訊。這些資料來自各種資料來源，例如已驗證使用者的聯絡人和設定檔資料。

大多數欄位都可以包含多個項目。欄位中的項目沒有保證順序，但每個非空白欄位一定會有 metadata.primary 設為 true 的欄位。

JSON 表示法

JSON 表示法
{ "resourceName": string, "etag": string, "metadata": { object (`PersonMetadata`) }, "addresses": [ { object (`Address`) } ], "ageRange": enum (`AgeRange`), "ageRanges": [ { object (`AgeRangeType`) } ], "biographies": [ { object (`Biography`) } ], "birthdays": [ { object (`Birthday`) } ], "braggingRights": [ { object (`BraggingRights`) } ], "calendarUrls": [ { object (`CalendarUrl`) } ], "clientData": [ { object (`ClientData`) } ], "coverPhotos": [ { object (`CoverPhoto`) } ], "emailAddresses": [ { object (`EmailAddress`) } ], "events": [ { object (`Event`) } ], "externalIds": [ { object (`ExternalId`) } ], "fileAses": [ { object (`FileAs`) } ], "genders": [ { object (`Gender`) } ], "imClients": [ { object (`ImClient`) } ], "interests": [ { object (`Interest`) } ], "locales": [ { object (`Locale`) } ], "locations": [ { object (`Location`) } ], "memberships": [ { object (`Membership`) } ], "miscKeywords": [ { object (`MiscKeyword`) } ], "names": [ { object (`Name`) } ], "nicknames": [ { object (`Nickname`) } ], "occupations": [ { object (`Occupation`) } ], "organizations": [ { object (`Organization`) } ], "phoneNumbers": [ { object (`PhoneNumber`) } ], "photos": [ { object (`Photo`) } ], "relations": [ { object (`Relation`) } ], "relationshipInterests": [ { object (`RelationshipInterest`) } ], "relationshipStatuses": [ { object (`RelationshipStatus`) } ], "residences": [ { object (`Residence`) } ], "sipAddresses": [ { object (`SipAddress`) } ], "skills": [ { object (`Skill`) } ], "taglines": [ { object (`Tagline`) } ], "urls": [ { object (`Url`) } ], "userDefined": [ { object (`UserDefined`) } ] }

{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (PersonMetadata)
  },
  "addresses": [
    {
      object (Address)
    }
  ],
  "ageRange": enum (AgeRange),
  "ageRanges": [
    {
      object (AgeRangeType)
    }
  ],
  "biographies": [
    {
      object (Biography)
    }
  ],
  "birthdays": [
    {
      object (Birthday)
    }
  ],
  "braggingRights": [
    {
      object (BraggingRights)
    }
  ],
  "calendarUrls": [
    {
      object (CalendarUrl)
    }
  ],
  "clientData": [
    {
      object (ClientData)
    }
  ],
  "coverPhotos": [
    {
      object (CoverPhoto)
    }
  ],
  "emailAddresses": [
    {
      object (EmailAddress)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "externalIds": [
    {
      object (ExternalId)
    }
  ],
  "fileAses": [
    {
      object (FileAs)
    }
  ],
  "genders": [
    {
      object (Gender)
    }
  ],
  "imClients": [
    {
      object (ImClient)
    }
  ],
  "interests": [
    {
      object (Interest)
    }
  ],
  "locales": [
    {
      object (Locale)
    }
  ],
  "locations": [
    {
      object (Location)
    }
  ],
  "memberships": [
    {
      object (Membership)
    }
  ],
  "miscKeywords": [
    {
      object (MiscKeyword)
    }
  ],
  "names": [
    {
      object (Name)
    }
  ],
  "nicknames": [
    {
      object (Nickname)
    }
  ],
  "occupations": [
    {
      object (Occupation)
    }
  ],
  "organizations": [
    {
      object (Organization)
    }
  ],
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "relations": [
    {
      object (Relation)
    }
  ],
  "relationshipInterests": [
    {
      object (RelationshipInterest)
    }
  ],
  "relationshipStatuses": [
    {
      object (RelationshipStatus)
    }
  ],
  "residences": [
    {
      object (Residence)
    }
  ],
  "sipAddresses": [
    {
      object (SipAddress)
    }
  ],
  "skills": [
    {
      object (Skill)
    }
  ],
  "taglines": [
    {
      object (Tagline)
    }
  ],
  "urls": [
    {
      object (Url)
    }
  ],
  "userDefined": [
    {
      object (UserDefined)
    }
  ]
}

欄位
`resourceName`	`string` 伺服器指派的個人資源名稱。`people/{person_id}` 形式的 ASCII 字串。
`etag`	`string` 資源的 HTTP 實體標記。用於網頁快取驗證。
`metadata`	`object (PersonMetadata)` 僅供輸出。使用者的相關中繼資料。
`addresses[]`	`object (Address)` 對方的街道地址。
`ageRange (deprecated)`	`enum (AgeRange)` 這個項目已遭淘汰！僅供輸出。已淘汰 (請改用 `person.ageRanges`) 對象的年齡層。
`ageRanges[]`	`object (AgeRangeType)` 僅供輸出。對象的年齡層。
`biographies[]`	`object (Biography)` 對方的簡介。這個欄位是聯絡人來源的單例模式。
`birthdays[]`	`object (Birthday)` 對方的生日。這個欄位是聯絡人來源的單例模式。
`braggingRights[] (deprecated)`	`object (BraggingRights)` 這個項目已遭淘汰！已不適用：系統不會傳回任何資料。
`calendarUrls[]`	`object (CalendarUrl)` 該使用者的日曆網址。
`clientData[]`	`object (ClientData)` 使用者的客戶資料。
`coverPhotos[]`	`object (CoverPhoto)` 僅供輸出。使用者的封面相片。
`emailAddresses[]`	`object (EmailAddress)` 使用者的電子郵件地址。`people.connections.list` 和 `otherContacts.list` 的電子郵件地址數量上限為 100 個。如果 Person 擁有更多電子郵件地址，可透過呼叫 `people.getBatchGet` 取得整組電子郵件地址。
`events[]`	`object (Event)` 這位使用者的活動。
`externalIds[]`	`object (ExternalId)` 使用者的外部 ID。
`fileAses[]`	`object (FileAs)` 該使用者的檔案。
`genders[]`	`object (Gender)` 使用者的性別。這個欄位是聯絡人來源的單例模式。
`imClients[]`	`object (ImClient)` 使用者的即時通訊用戶端。
`interests[]`	`object (Interest)` 使用者的興趣。
`locales[]`	`object (Locale)` 使用者的語言代碼偏好設定。
`locations[]`	`object (Location)` 使用者所在地點。
`memberships[]`	`object (Membership)` 該使用者的群組成員資格。
`miscKeywords[]`	`object (MiscKeyword)` 使用者的其他關鍵字。
`names[]`	`object (Name)` 對方的姓名。這個欄位是聯絡人來源的單例模式。
`nicknames[]`	`object (Nickname)` 聯絡人的暱稱。
`occupations[]`	`object (Occupation)` 使用者的職業。
`organizations[]`	`object (Organization)` 使用者過去或目前的機構。
`phoneNumbers[]`	`object (PhoneNumber)` 聯絡人的電話號碼。`people.connections.list` 和 `otherContacts.list` 的電話號碼最多只能包含 100 組電話號碼。如果人物擁有更多電話號碼，只要呼叫 `people.getBatchGet` 即可取得整組電話號碼。
`photos[]`	`object (Photo)` 僅供輸出。對方的相片。
`relations[]`	`object (Relation)` 人關係。
`relationshipInterests[] (deprecated)`	`object (RelationshipInterest)` 這個項目已遭淘汰！僅供輸出。已淘汰：系統不會傳回使用者的關係興趣。
`relationshipStatuses[] (deprecated)`	`object (RelationshipStatus)` 這個項目已遭淘汰！僅供輸出。已淘汰：系統不會傳回該使用者的關係狀態。
`residences[] (deprecated)`	`object (Residence)` 這個項目已遭淘汰！已淘汰：(請改用 `person.locations`) 對方的居住地。
`sipAddresses[]`	`object (SipAddress)` 該使用者的 SIP 位址。
`skills[]`	`object (Skill)` 這個人的技能。
`taglines[] (deprecated)`	`object (Tagline)` 這個項目已遭淘汰！僅供輸出。已淘汰：系統不會傳回該使用者的標語。
`urls[]`	`object (Url)` 該使用者的關聯網址。
`userDefined[]`	`object (UserDefined)` 使用者的使用者定義資料。

PersonMetadata

個人的相關中繼資料。

JSON 表示法
{ "sources": [ { object (`Source`) } ], "previousResourceNames": [ string ], "linkedPeopleResourceNames": [ string ], "deleted": boolean, "objectType": enum (`ObjectType`) }

欄位
`sources[]`	`object (Source)` 使用者的資料來源。
`previousResourceNames[]`	`string` 僅供輸出。這位使用者曾用過的任何資源名稱。系統只會針對包含同步權杖的 `people.connections.list` 要求填入資料。當你新增或移除會連結聯絡人和個人資料的欄位 (例如已驗證的電子郵件、已驗證的電話號碼或個人資料網址)，資源名稱可能會有所變動。
`linkedPeopleResourceNames[]`	`string` 僅供輸出。連結至這項資源的使用者資源名稱。
`deleted`	`boolean` 僅供輸出。如果刪除使用者資源，則為「是」。只會針對 `people.connections.list` 和 `otherContacts.list` 同步處理要求填入資料。
`objectType (deprecated)`	`enum (ObjectType)` 這個項目已遭淘汰！僅供輸出。已淘汰 (請改用 `person.metadata.sources.profileMetadata.objectType`) 人員物件的類型。

來源

欄位來源。

JSON 表示法

JSON 表示法
{ "type": enum (`SourceType`), "id": string, "etag": string, "updateTime": string, // Union field `metadata` can be only one of the following: "profileMetadata": { object (`ProfileMetadata`) } // End of list of possible types for union field `metadata`. }

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}

欄位
`type`	`enum (SourceType)` 來源類型。
`id`	`string` 伺服器產生的來源類型中的專屬 ID。
`etag`	`string` 只會在 `person.metadata.sources` 中填入。來源的 HTTP 實體標記。用於網頁快取驗證。
`updateTime`	`string (Timestamp format)` 僅供輸出。只會在 `person.metadata.sources` 中填入。這個來源的上次更新時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。
聯集欄位 `metadata`。只會在 `person.metadata.sources` 中填入。來源的中繼資料。`metadata` 只能採用下列其中一種設定：
`profileMetadata`	`object (ProfileMetadata)` 僅供輸出。只會在 `person.metadata.sources` 中填入。關於「PROFILE」類型來源的中繼資料。

SourceType

來源的類型，

列舉
`SOURCE_TYPE_UNSPECIFIED`	未指明
`ACCOUNT`	Google 帳戶。
`PROFILE`	Google 個人資料：您可以前往 https://profiles.google.com/{id} 查看個人資料，其中 {id} 是來源 ID。
`DOMAIN_PROFILE`	Google Workspace 網域設定檔。
`CONTACT`	Google 聯絡人。如要查看聯絡人，請前往 https://contact.google.com/{id}，其中 {id} 是來源 ID。
`OTHER_CONTACT`	Google「其他聯絡人」：
`DOMAIN_CONTACT`	Google Workspace 網域共用聯絡人。

ProfileMetadata

個人資料的中繼資料。

JSON 表示法
{ "objectType": enum (`ObjectType`), "userTypes": [ enum (`UserType`) ] }

欄位

objectType

enum (ObjectType)

僅供輸出。設定檔物件類型。

userTypes[]

enum (UserType)

僅供輸出。使用者輸入的內容。

ObjectType

人員物件的類型。

列舉
`OBJECT_TYPE_UNSPECIFIED`	未指明
`PERSON`	。
`PAGE`	Currents 頁面。

UserType

使用者的類型。

列舉
`USER_TYPE_UNKNOWN`	使用者類型不明。
`GOOGLE_USER`	這位使用者是 Google 使用者。
`GPLUS_USER`	該使用者是 Currents 使用者。
`GOOGLE_APPS_USER`	該使用者是 Google Workspace 使用者。

地址

個人的實際地址。可能是郵政服務。方塊或街道地址所有欄位均為選填。

JSON 表示法

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "formattedValue": string, "type": string, "formattedType": string, "poBox": string, "streetAddress": string, "extendedAddress": string, "city": string, "region": string, "postalCode": string, "country": string, "countryCode": string }

{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}

欄位
`metadata`	`object (FieldMetadata)` 地址的中繼資料。
`formattedValue`	`string` 地址的非結構化值。如果使用者未設定，系統會自動透過結構化值建構。
`type`	`string` 地址的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `other`
`formattedType`	`string` 僅供輸出。依據檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼所翻譯及設定的地址類型。
`poBox`	`string` 郵政方塊內輸入地址
`streetAddress`	`string` 街道地址。
`extendedAddress`	`string` 地址的延伸地址；例如公寓號碼
`city`	`string` 地址所在的城市。
`region`	`string` 位址所在區域；例如州或省
`postalCode`	`string` 地址的郵遞區號。
`country`	`string` 地址所在國家/地區。
`countryCode`	`string` 地址的 ISO 3166-1 alpha-2 國家/地區代碼。

FieldMetadata

欄位中繼資料。

JSON 表示法
{ "primary": boolean, "sourcePrimary": boolean, "verified": boolean, "source": { object (`Source`) } }

欄位
`primary`	`boolean` 僅供輸出。如果欄位是個人中所有來源的主要欄位，則為「是」。每位使用者最多只能有一個將 `primary` 設為「true」的欄位。
`sourcePrimary`	`boolean` 如果欄位是 `source` 的主要欄位，則為「是」。每個來源最多只能有一個欄位，其中 `sourcePrimary` 設為 true。
`verified`	`boolean` 僅供輸出。如果欄位已通過驗證，則為「是」；如果欄位未驗證，則為 false。已驗證的欄位通常包括名稱、電子郵件地址、電話號碼或網站，且經確認為本人所有。
`source`	`object (Source)` 欄位來源。

年齡層

已淘汰 (請改用 person.ageRanges)

個人的年齡層，

列舉
`AGE_RANGE_UNSPECIFIED`	未指明
`LESS_THAN_EIGHTEEN`	未滿 18 歲。
`EIGHTEEN_TO_TWENTY`	介於十八到二十間。
`TWENTY_ONE_OR_OLDER`	21 歲以上。

AgeRangeType

個人的年齡層。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "ageRange": enum (`AgeRange`) }

欄位

欄位
`metadata`	`object (FieldMetadata)` 年齡層的中繼資料。
`ageRange`	`enum (AgeRange)` 年齡層。

metadata

object (FieldMetadata)

年齡層的中繼資料。

ageRange

enum (AgeRange)

年齡層。

傳記片

某人的簡短自傳。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "contentType": enum (`ContentType`) }

欄位

欄位
`metadata`	`object (FieldMetadata)` 簡介的中繼資料。
`value`	`string` 個人簡介。
`contentType`	`enum (ContentType)` 簡介的內容類型，

metadata

object (FieldMetadata)

簡介的中繼資料。

value

string

個人簡介。

contentType

enum (ContentType)

簡介的內容類型，

ContentType

內容的類型。

列舉
`CONTENT_TYPE_UNSPECIFIED`	未指明
`TEXT_PLAIN`	純文字。
`TEXT_HTML`	HTML 文字。

生日

某人的生日。至少指定了 date 和 text 欄位的其中之一。date 和 text 欄位通常顯示相同的日期，但不保證會如此。變更生日時，用戶端應一律設定 date 欄位。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "date": { object (`Date`) }, "text": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 生日相關中繼資料。
`date`	`object (Date)` 結構化的生日日期。
`text (deprecated)`	`string` 這個項目已遭淘汰！如果已設定，建議使用 `date` 欄位。代表使用者的生日的任意格式字串。這個值未經驗證。

metadata

object (FieldMetadata)

生日相關中繼資料。

date

object (Date)

結構化的生日日期。

text
(deprecated)

string

如果已設定，建議使用 date 欄位。

代表使用者的生日的任意格式字串。這個值未經驗證。

日期

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

完整日期，具有非零的年、月和日值。
日期為 0 的月份和日期，例如週年紀念日。
有 1 年，第 0 個月卻為 0 天。
年和月，但數字為零 (例如信用卡到期日)。

相關類型：

google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp

JSON 表示法
{ "year": integer, "month": integer, "day": integer }

欄位

欄位
`year`	`integer` 日期的年份。這個值必須介於 1 至 9999，或 0 之間可指定不含年份的日期。
`month`	`integer` 一年中的月份。必須介於 1 到 12 之間，或 0 可以指定不含月份和日期的年份。
`day`	`integer` 一個月中的第幾天。這個值必須介於 1 至 31 之間，且有效的年份和月份；或 0 可讓您指定本身或年份和月份，但這些日期不明顯。

year

integer

日期的年份。這個值必須介於 1 至 9999，或 0 之間可指定不含年份的日期。

month

integer

一年中的月份。必須介於 1 到 12 之間，或 0 可以指定不含月份和日期的年份。

day

integer

一個月中的第幾天。這個值必須介於 1 至 31 之間，且有效的年份和月份；或 0 可讓您指定本身或年份和月份，但這些日期不明顯。

BraggingRights

已淘汰：系統不會傳回某位使用者的輝煌事蹟。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 輝煌事權的中繼資料。
`value`	`string` 輝煌事蹟；例如 `climbed mount everest`。

metadata

object (FieldMetadata)

輝煌事權的中繼資料。

value

string

輝煌事蹟；例如 climbed mount everest。

CalendarUrl

某人的日曆網址。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "url": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 日曆網址的中繼資料。
`url`	`string` 日曆網址。
`type`	`string` 日曆網址的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `freeBusy` `work`
`formattedType`	`string` 僅供輸出。日曆網址的類型，按照檢視者的帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼進行翻譯。

ClientData

用戶端填入的任意客戶資料。可輸入重複的鍵和值，

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "key": string, "value": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 客戶資料的中繼資料。
`key`	`string` 用戶端指定的客戶資料金鑰。
`value`	`string` 用戶端指定客戶資料的值。

metadata

object (FieldMetadata)

客戶資料的中繼資料。

key

string

用戶端指定的客戶資料金鑰。

value

string

用戶端指定客戶資料的值。

CoverPhoto

某人的封面相片。顯示在使用者個人資料頁面上的大型圖片，代表他們的身分或關注。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "url": string, "default": boolean }

欄位

欄位
`metadata`	`object (FieldMetadata)` 封面相片的中繼資料。
`url`	`string` 封面相片的網址。
`default`	`boolean` 如果封面相片是預設的封面相片，則為「是」；如果封面相片是使用者提供的封面相片，則為「false」。

metadata

object (FieldMetadata)

封面相片的中繼資料。

url

string

封面相片的網址。

default

boolean

如果封面相片是預設的封面相片，則為「是」；如果封面相片是使用者提供的封面相片，則為「false」。

電子郵件地址

使用者的電子郵件地址。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": string, "formattedType": string, "displayName": string }

欄位
`metadata`	`object (FieldMetadata)` 電子郵件地址的中繼資料。
`value`	`string` 電子郵件地址。
`type`	`string` 電子郵件地址的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `other`
`formattedType`	`string` 僅供輸出。根據檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼，翻譯及設定的電子郵件地址類型。
`displayName`	`string` 電子郵件的顯示名稱。

活動

與使用者相關的事件。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "date": { object (`Date`) }, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 事件的中繼資料。
`date`	`object (Date)` 事件的日期。
`type`	`string` 事件的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `anniversary` `other`
`formattedType`	`string` 僅供輸出。事件類型，採用檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼，且已翻譯及設定格式。

外部 ID

與使用者相關的外部實體 ID。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 外部 ID 的相關中繼資料。
`value`	`string` 外部 ID 的值。
`type`	`string` 外部 ID 的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `account` `customer` `loginId` `network` `organization`
`formattedType`	`string` 僅供輸出。事件類型，採用檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼，且已翻譯及設定格式。

FileAs

清單中的使用者排序時應使用的名稱。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 關於檔案的中繼資料。
`value`	`string` 檔案做為值

metadata

object (FieldMetadata)

關於檔案的中繼資料。

value

string

檔案做為值

性別

個人的性別。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "formattedValue": string, "addressMeAs": string }

欄位
`metadata`	`object (FieldMetadata)` 性別中繼資料。
`value`	`string` 聯絡人的性別。性別可以是自訂或下列其中一個預先定義的值： `male` `female` `unspecified`
`formattedValue`	`string` 僅供輸出。依據觀眾帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼中，翻譯及格式化的性別值。未指定或自訂的值不會本地化。
`addressMeAs`	`string` 任意形式的代名詞文字欄位，用來稱呼對方。常見的值如下： `he`/`him` `she`/`her` `they`/`them`

ImClient

某人的即時通訊用戶端。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "username": string, "type": string, "formattedType": string, "protocol": string, "formattedProtocol": string }

欄位
`metadata`	`object (FieldMetadata)` 即時訊息用戶端的中繼資料。
`username`	`string` 即時通訊用戶端中使用的使用者名稱。
`type`	`string` 即時訊息用戶端的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `other`
`formattedType`	`string` 僅供輸出。根據檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼，翻譯及設定格式的即時訊息用戶端類型。
`protocol`	`string` IM 用戶端的通訊協定。通訊協定可以是自訂值，或下列其中一個預先定義的值： `aim` `msn` `yahoo` `skype` `qq` `googleTalk` `icq` `jabber` `netMeeting`
`formattedProtocol`	`string` 僅供輸出。採用觀眾帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼中的 IM 用戶端通訊協定。

興趣

其中一個興趣。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 興趣的相關中繼資料。
`value`	`string` 利益；例如 `stargazing`。

metadata

object (FieldMetadata)

興趣的相關中繼資料。

value

string

利益；例如 stargazing。

語言代碼

個人的語言代碼偏好設定。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

欄位
`metadata`	`object (FieldMetadata)` 語言代碼的相關中繼資料。
`value`	`string` 格式正確的 IETF BCP 47 語言標記，代表語言代碼。

metadata

object (FieldMetadata)

語言代碼的相關中繼資料。

value

string

格式正確的 IETF BCP 47 語言標記，代表語言代碼。

位置

使用者的所在位置。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": string, "current": boolean, "buildingId": string, "floor": string, "floorSection": string, "deskCode": string }

欄位
`metadata`	`object (FieldMetadata)` 位置的相關中繼資料。
`value`	`string` 地點的任意形式值。
`type`	`string` 地點的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `desk` `grewUp`
`current`	`boolean` 指出位置是否為目前所在位置。
`buildingId`	`string` 建築物 ID。
`floor`	`string` 樓層名稱或號碼。
`floorSection`	`string` 「`floor_name`」的樓層。
`deskCode`	`string` 個別桌面位置。

成員資格

群組成員。只能修改聯絡人群組成員。

JSON 表示法

{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}

欄位
`metadata`	`object (FieldMetadata)` 成員資格的中繼資料。
聯集欄位 `membership`。會員資格。`membership` 只能是下列其中一項：
`contactGroupMembership`	`object (ContactGroupMembership)` 聯絡人群組成員。
`domainMembership`	`object (DomainMembership)` 僅供輸出。網域成員資格。

ContactGroupMembership

Google 聯絡人群組成員。

JSON 表示法
{ "contactGroupId": string, "contactGroupResourceName": string }

欄位

contactGroupId
(deprecated)

string

僅供輸出。聯絡人群組成員的聯絡人群組 ID。

contactGroupResourceName

string

伺服器指派的聯絡人群組的資源名稱。ASCII 字串，格式為 contactGroups/{contactGroupId}。只有 contactGroupResourceName 可用於修改成員資格。聯絡人群組的所有成員資格都可以移除，但只能移除使用者群組或「myContacts」或「已加星號」可以新增系統群組成員資格一位聯絡人必須至少具備一個聯絡人群組成員。

DomainMembership

具備 Google Workspace 網域成員資格。

JSON 表示法
{ "inViewerDomain": boolean }

欄位

inViewerDomain

boolean

如果使用者是檢視者的 Google Workspace 網域，則為「是」。

MiscKeyword

某人的其他關鍵字。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": enum (`KeywordType`), "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 其他關鍵字的相關中繼資料。
`value`	`string` 其他關鍵字的值。
`type`	`enum (KeywordType)` 其他關鍵字類型。
`formattedType`	`string` 僅供輸出。其他經翻譯及格式化的關鍵字類型，採用檢視者的帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼。

KeywordType

其他關鍵字的類型。

列舉
`TYPE_UNSPECIFIED`	未指明
`OUTLOOK_BILLING_INFORMATION`	帳單資訊的 Outlook 欄位。
`OUTLOOK_DIRECTORY_SERVER`	目錄伺服器的 Outlook 欄位。
`OUTLOOK_KEYWORD`	關鍵字的 Outlook 欄位。
`OUTLOOK_MILEAGE`	里程數的 Outlook 欄位。
`OUTLOOK_PRIORITY`	優先順序的 Outlook 欄位。
`OUTLOOK_SENSITIVITY`	機密程度的 Outlook 欄位。
`OUTLOOK_SUBJECT`	主旨的 Outlook 欄位。
`OUTLOOK_USER`	使用者的 Outlook 欄位。
`HOME`	。
`WORK`	Work.
`OTHER`	其他。

名稱

個人姓名。如果名稱是別名，則系列名稱為空白。

JSON 表示法

{
  "metadata": {
    object (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}

欄位
`metadata`	`object (FieldMetadata)` 名稱的相關中繼資料。
`displayName`	`string` 僅供輸出。根據觀眾帳戶或 `Accept-Language` HTTP 標頭指定的語言代碼設定顯示名稱。
`displayNameLastFirst`	`string` 僅供輸出。顯示姓氏的名字 (根據觀眾帳戶或 `Accept-Language` HTTP 標頭指定的語言代碼)。
`unstructuredName`	`string` 任意形式的名稱值。
`familyName`	`string` 姓氏。
`givenName`	`string` 指定名稱。
`middleName`	`string` 中間名。
`honorificPrefix`	`string` 熱門前置字元，例如 `Mrs.` 或 `Dr.`
`honorificSuffix`	`string` 榮譽字尾，例如 `Jr.`
`phoneticFullName`	`string` 全名拼出完整姓名。
`phoneticFamilyName`	`string` 姓氏的拼音。
`phoneticGivenName`	`string` 名字拼出這個名字。
`phoneticMiddleName`	`string` 中間名的拼音。
`phoneticHonorificPrefix`	`string` 以原音拼出的名詞首字母拼出。
`phoneticHonorificSuffix`	`string` 這句話是出自於發音的榮耀。

暱稱

個人暱稱。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": enum (`NicknameType`) }

欄位

metadata

object (FieldMetadata)

暱稱的中繼資料。

value

string

暱稱。

type

enum (NicknameType)

暱稱的類型。

NicknameType

暱稱的類型。

列舉
`DEFAULT`	一般暱稱。
`MAIDEN_NAME`	本姓或出生的姓氏。用於因婚姻而改變的姓氏。這個項目已遭淘汰！
`INITIALS`	縮寫。這個項目已遭淘汰！
`GPLUS`	Google+ 個人資料暱稱。這個項目已遭淘汰！
`OTHER_NAME`	專業聯盟或其他名稱；例如：`Dr. Smith.` 這個項目已遭淘汰！
`ALTERNATE_NAME`	已有其他名稱的使用者。
`SHORT_NAME`	使用簡稱。這個項目已遭淘汰！

職業

使用者的職業。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

metadata

object (FieldMetadata)

職業的中繼資料。

value

string

職業；例如 carpenter。

機構

使用者過去或目前的機構。日期範圍可以重疊。

JSON 表示法

{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}

欄位
`metadata`	`object (FieldMetadata)` 機構的相關中繼資料。
`type`	`string` 機構類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `work` `school`
`formattedType`	`string` 僅供輸出。採用檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼的翻譯及格式機構類型。
`startDate`	`object (Date)` 人員加入機構的開始日期。
`endDate`	`object (Date)` 使用者離職時的結束日期。
`current`	`boolean` 如果機構是使用者目前的機構，則為「是」；如果機構是過去的機構，則為 false。
`name`	`string` 機構名稱。
`phoneticName`	`string` 機構拼音名稱。
`department`	`string` 機構中人員的部門。
`title`	`string` 使用者在機構中的職稱。
`jobDescription`	`string` 人員在機構的職務說明。
`symbol`	`string` 與機構相關的符號；例如股票代號、縮寫或首字母縮寫
`domain`	`string` 與機構相關聯的網域名稱；例如 `google.com`。
`location`	`string` 聯絡人在機構辦公室的所在位置。
`costCenter`	`string` 機構員工的成本中心。
`fullTimeEquivalentMillipercent`	`integer` 機構內該名員工的全職同等毫秒數 (100000 = 100%)。

PhoneNumber

使用者的電話號碼。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "canonicalForm": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 電話號碼相關中繼資料。
`value`	`string` 電話號碼。
`canonicalForm`	`string` 僅供輸出。電話號碼的標準 ITU-T E.164 格式。
`type`	`string` 電話號碼的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `mobile` `homeFax` `workFax` `otherFax` `pager` `workMobile` `workPager` `main` `googleVoice` `other`
`formattedType`	`string` 僅供輸出。按照觀眾帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼中，翻譯及設定的電話號碼類型。

相片

某人的相片。個人資料相片會顯示在該使用者名稱旁邊，方便其他人辨識。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "url": string, "default": boolean }

欄位

metadata

object (FieldMetadata)

相片的中繼資料。

url

string

相片的網址。如要變更所需大小，請在網址結尾附加查詢參數 sz={size}，其中 {size} 代表大小 (以像素為單位)。範例：https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

default

boolean

如果相片是預設相片，則為「是」；如果相片是使用者提供的相片，則為「false」。

關係

某人與他人的關係。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "person": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 關於關係的中繼資料。
`person`	`string` 這個關係所指的他人姓名。
`type`	`string` 對方之間的關係。類型可以是自訂值，也可以是下列其中一個預先定義的值： `spouse` `child` `mother` `father` `parent` `brother` `sister` `friend` `relative` `domesticPartner` `manager` `assistant` `referredBy` `partner`
`formattedType`	`string` 僅供輸出。依據觀眾帳戶語言代碼或 Accept-Language HTTP 標頭中指定的語言代碼，翻譯及設定格式的關係類型。

RelationshipInterest

已不適用：系統不會傳回任何個人的關係利益。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "formattedValue": string }

欄位

metadata

object (FieldMetadata)

關於關係興趣的中繼資料。

value

string

對方正在尋找的關係類型。自訂值可以是自訂值，也可以輸入下列其中一個預先定義的值：

friend
date
relationship
networking

formattedValue

string

僅供輸出。以觀眾帳戶語言代碼或 Accept-Language HTTP 標頭中指定的語言代碼，翻譯及設定關係興趣的值。

RelationshipStatus

已淘汰：系統不會傳回使用者的關係狀態。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "formattedValue": string }

欄位

metadata

object (FieldMetadata)

關係狀態的中繼資料。

value

string

關係狀態。自訂值可以是自訂值，也可以輸入下列其中一個預先定義的值：

single
inARelationship
engaged
married
itsComplicated
openRelationship
widowed
inDomesticPartnership
inCivilUnion

formattedValue

string

僅供輸出。透過檢視者帳戶語言代碼或 Accept-Language HTTP 標頭語言代碼，翻譯及設定關係狀態的值。

住宅

已淘汰：請改用 person.locations。某人過去或目前居住的居住地。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "current": boolean }

欄位

metadata

object (FieldMetadata)

住家的中繼資料。

value

string

居住地址。

current

boolean

如果居住地為對方目前的居住地，則為 True；如果居留為之前的居住地，則為 false。

SipAddress

個人的 SIP 位址。系統會使用工作階段初始通訊協定地址，透過 IP 網路語音傳遞技術通訊，透過網際網路進行語音或視訊通話。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` SIP 位址的相關中繼資料。
`value`	`string` RFC 3261 19.1 SIP URI 格式的 SIP 位址。
`type`	`string` SIP 位址的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `mobile` `other`
`formattedType`	`string` 僅供輸出。依據檢視者帳戶語言代碼或「`Accept-Language`」HTTP 標頭語言代碼翻譯及格式化的 SIP 位址類型。

Skill

對方具備的技能。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

metadata

object (FieldMetadata)

技能的中繼資料。

value

string

技能；例如 underwater basket weaving。

標語

已淘汰：系統不會傳回任何資料的簡短一行說明。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string }

欄位

metadata

object (FieldMetadata)

標語的中繼資料。

value

string

標語。

網址

個人相關聯的網址。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "value": string, "type": string, "formattedType": string }

欄位
`metadata`	`object (FieldMetadata)` 網址的中繼資料。
`value`	`string` 網址。
`type`	`string` 網址的類型。類型可以是自訂值，也可以是下列其中一個預先定義的值： `home` `work` `blog` `profile` `homePage` `ftp` `reservations` `appInstallPage`：Currents 應用程式的網站。 `other`
`formattedType`	`string` 僅供輸出。採用檢視者帳戶語言代碼或 `Accept-Language` HTTP 標頭語言代碼的翻譯及格式網址類型。

UserDefined

由使用者填入的任意使用者資料。

JSON 表示法
{ "metadata": { object (`FieldMetadata`) }, "key": string, "value": string }

欄位

metadata

object (FieldMetadata)

使用者定義資料的相關中繼資料。

key

string

使用者指定的使用者定義資料鍵。

value

string

使用者定義資料的使用者指定值。

方法
`batchCreateContacts`	建立一批新聯絡人，並傳回新聯絡人的 PersonResponses 請依序傳送對同一位使用者的變動要求，以免增加延遲時間和失敗。
`batchDeleteContacts`	刪除大量聯絡人。
`batchUpdateContacts`	更新一批聯絡人，並將資源名稱對應傳回給已更新聯絡人的 PersonResponses。
`createContact`	建立新的聯絡人，並傳回該聯絡人的使用者資源。
`deleteContact`	刪除聯絡人。
`deleteContactPhoto`	刪除聯絡人的相片。
`get`	透過指定資源名稱，提供個人相關資訊。
`getBatchGet`	指定要求的資源名稱清單，提供特定使用者清單的相關資訊。
`listDirectoryPeople`	提供已驗證使用者網域目錄中的網域設定檔和網域聯絡人清單。
`searchContacts`	提供已驗證使用者已分組聯絡人中與搜尋查詢相符的聯絡人清單。
`searchDirectoryPeople`	提供已驗證使用者網域目錄中符合搜尋查詢的網域設定檔及網域聯絡人清單。
`updateContact`	更新現有聯絡人的聯絡人資料。
`updateContactPhoto`	更新聯絡人的相片。

REST Resource: people 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

資源：Person

PersonMetadata

來源

SourceType

ProfileMetadata

ObjectType

UserType

地址

FieldMetadata

年齡層

AgeRangeType

傳記片

ContentType

生日

日期

BraggingRights

CalendarUrl

ClientData

CoverPhoto

電子郵件地址

活動

外部 ID

FileAs

性別

ImClient

興趣

語言代碼

位置

成員資格

ContactGroupMembership

DomainMembership

MiscKeyword

KeywordType

名稱

暱稱

NicknameType

職業

機構

PhoneNumber

相片

關係

RelationshipInterest

RelationshipStatus

住宅

SipAddress

Skill

標語

網址

UserDefined

方法

REST Resource: people
透過集合功能整理內容你可以依據偏好儲存及分類內容。