REST Resource: people.connections

資源:Person

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

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

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

伺服器指派的個人資源名稱。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.listotherContacts.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.listotherContacts.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)

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

方法

list

提供已驗證使用者的聯絡人清單。