# REST Resource: people.connections

- [Resource: Person](https://developers.google.com/people/api/rest/v1/people.connections#Person)
  - [JSON representation](https://developers.google.com/people/api/rest/v1/people.connections#Person.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/people/api/rest/v1/people.connections#METHODS_SUMMARY)

## 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 (`https://developers.google.com/people/api/rest/v1/people#Person.PersonMetadata`) }, "addresses": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Address`) } ], "ageRange": enum (`https://developers.google.com/people/api/rest/v1/people#Person.AgeRange`), "ageRanges": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.AgeRangeType`) } ], "biographies": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Biography`) } ], "birthdays": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Birthday`) } ], "braggingRights": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.BraggingRights`) } ], "calendarUrls": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.CalendarUrl`) } ], "clientData": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.ClientData`) } ], "coverPhotos": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.CoverPhoto`) } ], "emailAddresses": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.EmailAddress`) } ], "events": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Event`) } ], "externalIds": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.ExternalId`) } ], "fileAses": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.FileAs`) } ], "genders": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Gender`) } ], "imClients": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.ImClient`) } ], "interests": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Interest`) } ], "locales": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Locale`) } ], "locations": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Location`) } ], "memberships": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Membership`) } ], "miscKeywords": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.MiscKeyword`) } ], "names": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Name`) } ], "nicknames": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Nickname`) } ], "occupations": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Occupation`) } ], "organizations": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Organization`) } ], "phoneNumbers": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.PhoneNumber`) } ], "photos": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Photo`) } ], "relations": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Relation`) } ], "relationshipInterests": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.RelationshipInterest`) } ], "relationshipStatuses": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.RelationshipStatus`) } ], "residences": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Residence`) } ], "sipAddresses": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.SipAddress`) } ], "skills": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Skill`) } ], "taglines": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Tagline`) } ], "urls": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.Url`) } ], "userDefined": [ { object (`https://developers.google.com/people/api/rest/v1/people#Person.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](https://en.wikipedia.org/wiki/HTTP_ETag) of the resource. Used for web cache validation. |
| `metadata` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.PersonMetadata`)`` Output only. Metadata about the person. |
| `addresses[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Address`)`` The person's street addresses. |
| `ageRange (deprecated)` | ``enum (`https://developers.google.com/people/api/rest/v1/people#Person.AgeRange`)`` > [!WARNING] > This item is deprecated! Output only. **DEPRECATED** (Please use `person.ageRanges` instead) The person's age range. |
| `ageRanges[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.AgeRangeType`)`` Output only. The person's age ranges. |
| `biographies[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Biography`)`` The person's biographies. This field is a singleton for contact sources. |
| `birthdays[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Birthday`)`` The person's birthdays. This field is a singleton for contact sources. |
| `braggingRights[] (deprecated)` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.BraggingRights`)`` > [!WARNING] > This item is deprecated! **DEPRECATED**: No data will be returned The person's bragging rights. |
| `calendarUrls[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.CalendarUrl`)`` The person's calendar URLs. |
| `clientData[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.ClientData`)`` The person's client data. |
| `coverPhotos[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.CoverPhoto`)`` Output only. The person's cover photos. |
| `emailAddresses[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.EmailAddress`)`` The person's email addresses. For `https://developers.google.com/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections` and `https://developers.google.com/people/api/rest/v1/otherContacts/list#google.people.v1.PeopleService.ListOtherContacts` the number of email addresses is limited to 100. If a Person has more email addresses the entire set can be obtained by calling `https://developers.google.com/people/api/rest/v1/people/getBatchGet#google.people.v1.PeopleService.GetPeople`. |
| `events[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Event`)`` The person's events. |
| `externalIds[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.ExternalId`)`` The person's external IDs. |
| `fileAses[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.FileAs`)`` The person's file-ases. |
| `genders[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Gender`)`` The person's genders. This field is a singleton for contact sources. |
| `imClients[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.ImClient`)`` The person's instant messaging clients. |
| `interests[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Interest`)`` The person's interests. |
| `locales[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Locale`)`` The person's locale preferences. |
| `locations[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Location`)`` The person's locations. |
| `memberships[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Membership`)`` The person's group memberships. |
| `miscKeywords[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.MiscKeyword`)`` The person's miscellaneous keywords. |
| `names[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Name`)`` The person's names. This field is a singleton for contact sources. |
| `nicknames[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Nickname`)`` The person's nicknames. |
| `occupations[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Occupation`)`` The person's occupations. |
| `organizations[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Organization`)`` The person's past or current organizations. |
| `phoneNumbers[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.PhoneNumber`)`` The person's phone numbers. For `https://developers.google.com/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections` and `https://developers.google.com/people/api/rest/v1/otherContacts/list#google.people.v1.PeopleService.ListOtherContacts` the number of phone numbers is limited to 100. If a Person has more phone numbers the entire set can be obtained by calling `https://developers.google.com/people/api/rest/v1/people/getBatchGet#google.people.v1.PeopleService.GetPeople`. |
| `photos[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Photo`)`` Output only. The person's photos. |
| `relations[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Relation`)`` The person's relations. |
| `relationshipInterests[] (deprecated)` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.RelationshipInterest`)`` > [!WARNING] > This item is deprecated! Output only. **DEPRECATED**: No data will be returned The person's relationship interests. |
| `relationshipStatuses[] (deprecated)` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.RelationshipStatus`)`` > [!WARNING] > This item is deprecated! Output only. **DEPRECATED**: No data will be returned The person's relationship statuses. |
| `residences[] (deprecated)` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Residence`)`` > [!WARNING] > This item is deprecated! **DEPRECATED** : (Please use `person.locations` instead) The person's residences. |
| `sipAddresses[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.SipAddress`)`` The person's SIP addresses. |
| `skills[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Skill`)`` The person's skills. |
| `taglines[] (deprecated)` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Tagline`)`` > [!WARNING] > This item is deprecated! Output only. **DEPRECATED**: No data will be returned The person's taglines. |
| `urls[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.Url`)`` The person's associated URLs. |
| `userDefined[]` | ``object (`https://developers.google.com/people/api/rest/v1/people#Person.UserDefined`)`` The person's user defined data. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/people/api/rest/v1/people.connections/list` | Provides a list of the authenticated user's contacts. |