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。如果某位使用者擁有更多電子郵件地址,您可以呼叫 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

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