REST Resource: people.connections

  • The Person resource aggregates information about individuals from various sources, including contacts and profile data.

  • Most fields in the Person resource can contain multiple entries, with one designated as primary using the metadata.primary flag.

  • A comprehensive JSON representation is provided, detailing the structure and data types of the Person resource.

  • The Person resource offers various fields such as addresses, age ranges, biographies, and contact information like email addresses and phone numbers.

  • Methods are available for interactions with the Person resource, such as listing the authenticated user's contacts.

Resource: Person

Information about a person merged from various data sources such as the authenticated user's contacts and profile data.

Most fields can have multiple items. The items in a field have no guaranteed order, but each non-empty field is guaranteed to have exactly one field with metadata.primary set to true.

JSON representation 
{
  "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)
    }
  ]
}
Fields
resourceName

string

The resource name for the person, assigned by the server. An ASCII string in the form of people/{person_id}.
etag

string

The HTTP entity tag of the resource. Used for web cache validation.
metadata

object (PersonMetadata)

Output only. Metadata about the person.
addresses[]

object (Address)

The person's street addresses.
ageRange
(deprecated)

enum (AgeRange)

Output only. DEPRECATED (Please use person.ageRanges instead)

The person's age range.
ageRanges[]

object (AgeRangeType)

Output only. The person's age ranges.
biographies[]

object (Biography)

The person's biographies. This field is a singleton for contact sources.
birthdays[]

object (Birthday)

The person's birthdays. This field is a singleton for contact sources.
braggingRights[]
(deprecated)

object (BraggingRights)

DEPRECATED: No data will be returned The person's bragging rights.
calendarUrls[]

object (CalendarUrl)

The person's calendar URLs.
clientData[]

object (ClientData)

The person's client data.
coverPhotos[]

object (CoverPhoto)

Output only. The person's cover photos.
emailAddresses[]

object (EmailAddress)

The person's email addresses. For people.connections.list and otherContacts.list the number of email addresses is limited to 100. If a Person has more email addresses the entire set can be obtained by calling people.getBatchGet.
events[]

object (Event)

The person's events.
externalIds[]

object (ExternalId)

The person's external IDs.
fileAses[]

object (FileAs)

The person's file-ases.
genders[]

object (Gender)

The person's genders. This field is a singleton for contact sources.
imClients[]

object (ImClient)

The person's instant messaging clients.
interests[]

object (Interest)

The person's interests.
locales[]

object (Locale)

The person's locale preferences.
locations[]

object (Location)

The person's locations.
memberships[]

object (Membership)

The person's group memberships.
miscKeywords[]

object (MiscKeyword)

The person's miscellaneous keywords.
names[]

object (Name)

The person's names. This field is a singleton for contact sources.
nicknames[]

object (Nickname)

The person's nicknames.
occupations[]

object (Occupation)

The person's occupations.
organizations[]

object (Organization)

The person's past or current organizations.
phoneNumbers[]

object (PhoneNumber)

The person's phone numbers. For people.connections.list and otherContacts.list the number of phone numbers is limited to 100. If a Person has more phone numbers the entire set can be obtained by calling people.getBatchGet.
photos[]

object (Photo)

Output only. The person's photos.
relations[]

object (Relation)

The person's relations.
relationshipInterests[]
(deprecated)

object (RelationshipInterest)

Output only. DEPRECATED: No data will be returned The person's relationship interests.
relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

Output only. DEPRECATED: No data will be returned The person's relationship statuses.
residences[]
(deprecated)

object (Residence)

DEPRECATED: (Please use person.locations instead) The person's residences.
sipAddresses[]

object (SipAddress)

The person's SIP addresses.
skills[]

object (Skill)

The person's skills.
taglines[]
(deprecated)

object (Tagline)

Output only. DEPRECATED: No data will be returned The person's taglines.
urls[]

object (Url)

The person's associated URLs.
userDefined[]

object (UserDefined)

The person's user defined data.

Methods

list

 Provides a list of the authenticated user's contacts.