AppsPeopleOzExternalMergedpeopleapiPerson

See go/relation-vs-relationship for relation vs relationship explanation.

See go/people-api-concepts/photos for usage details

DEPRECATED. Now always returns a default cover photo. See go/sunset-cover-photo.

Other person resources linked indirectly by an edge. The full person or just the IDs may be populated depending on request parameters. We consider linked people distinct people, but they share information. Example: A contact with two outgoing edges. The two edges are considered separate, but linked people.

See go/people-api-howto:names for details about names in PeopleAPI.

SipAddress is currently in use by contacts.

Used only by profile service, deprecated for PeopleAPI and Sharpen. If you aren't sure, contact people-api-users@ and profile-service-eng@.

b/145671020: Deprecated for Profiles, but not for Contacts.

NOTE: this is used by go/starlight, but not actually used or returned in PeopleAPI. See b/27281119 for context. Please reach out to people-api-eng@ if you have questions.

DEPRECATED. Info about plus pages in the person.

MapsProfile, see go/product-profiles-backend-api

Only supported for PLACE container results, no data will be returned for profiles.

DEPRECATED. This field isn't populated in people.list.

DEPRECATED. This feature was stubbed, but never implemented. This field will not be populated with any results.

Reminder to connect with a Contact (part of go/people-prompts). Also contains contact-level prompts settings. Each Contact can have a single connection_reminder (but can have multiple Prompts inside of it). Field is repeated per PeopleAPI data model go/people-api-concepts#repeated. Only supported for CONTACT container.

Settings for the limited profile. See go/limited-profiles-api.

Legacy arbitrary key value fields

Ways to send in-app notifications to this person. See go/reachability. This field is read-only and ignored for mutates.

Data specific to places. Data which also applies to contacts and profiles such as name, phone, photo, etc. are returned in the corresponding Person fields.

DEPRECATED. This field was only for backwards compatibility with legacy GData callers, and should not be used by new clients. Legacy fields used for mobile clients.

Metadata info for a user's name pronunciation audio. See go/name-pronunication-backend.

DEPRECATED. No data is returned for this field anymore.

DEPRECATED. No data is returned for this field anymore. (go/people-api-concepts#repeated): Use person.profile_url_repeated instead. Access to this field is restricted to a set of legacy clients. This is a Google+-only field. See go/fbs-g+-deprecation. NOTE: Person.profile_url is only populated for profile-centric person.

ContactEditContextInfo is a timestamp and additional metadata (e.g. the source of the edit) for the last 'human initiated edit'. See also ContactCreateContextInfo.

DEPRECATED. UNSUPPORTED. This field is never populated.

ContactCreateContextInfo has a timestamp timestamp and additional metadata (e.g. the source of the creation) for when the contact was created. See also ContactEditContextInfo.

In order to request this field, the client must set desired PersonAttributeKey in the dedicated RequestMask field person_attribute. Unlike other person fields, this field cannot be requested in the include_field field mask.

Pronouns are not supported for consumer profiles. See go/pronouns-in-people-system-prd for more details.

Data on the person's age range, adult status, and age of consent. NOTE: Please read go/people-api-howto:age on how to correctly get age data.

DEPRECATED. No data is returned for this field anymore. This is a Google+-only field. See go/fbs-g+-deprecation.

UserDefined is currently in use by contacts.

Event is currently in use by contacts.

Data specific to rosters (such as Google Groups and Chat Rooms). Data which also applies to contacts and profiles such as name, email, and photo, etc are returned in the corresponding Person fields.

Emergency information. See go/emergency-trusted-contacts-papi.

Add annotation_id and metadata (product_source) for visible to guests contacts go/visible-to-guests.

Deprecated. If age is needed use person.age_range_repeated instead. Please see go/people-api-howto:age on how to correctly get age data.

Profile for Janata and Search. go/janata-profile-in-sgbe

Contact state and related metadata. See go/fbs-contacts-trash. If this field was requested but is not set on the Person then the contact is in the DEFAULT contact state. This field is read-only, and should not be set on a mutate (e.g. UpdatePerson) call. Clients must call the explicit APIs (e.g. UntrashPerson) to change contact state.

Data added by extensions that are not specific to a particular field.

The ID of the person. This is determined by the backend, is unstable, and may not be the same as a user_id. Internally referred as 'personKey' to distinguish from the common PersonId pojo. See go/people-api-concepts#person-id

Information about the profiles that are a part of this Person. This is only applicable to PROFILE and DOMAIN_PROFILE containers.

DEPRECATED. No data is returned for this field anymore.

Contact groups that this person is a member of.

Circles that this person is a member of.

Used only by contacts, no data will be returned for profiles.

A fingerprint that can be used to reliably determine if a resource has changed. Externally it is used as part of the etag.

DEPRECATED. Please use circle_membership or contact_group_membership instead. Contact-groups and circles that this person is a member of.