REST Resource: people.connections

    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: