REST Resource: people.connections

资源：人

从各种数据源合并的有关用户的信息，例如经过身份验证的用户的联系人和个人资料数据。

大多数字段都可以包含多个项。字段中的项没有保证顺序，但每个非空字段保证只有一个字段，并且 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.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 个。如果一个 Person 有多个电话号码，则可通过调用 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

 提供经过身份验证的用户的联系人列表。