---
title: "POST /v1/people:createContact"
method: POST
path: "/v1/people:createContact"
tags: ["people"]
---

# POST /v1/people:createContact

`POST /v1/people:createContact`

Create a new contact and return the person resource for that contact. The request returns a 400 error if more than one field is specified on a field that is a singleton for contact sources: * biographies * birthdays * genders * names Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.

## Query parameters

- `personFields` string
- `sources` string[]

## Request body

- 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.
  - `ageRange` 'AGE_RANGE_UNSPECIFIED' | 'LESS_THAN_EIGHTEEN' | 'EIGHTEEN_TO_TWENTY' | 'TWENTY_ONE_OR_OLDER' — Output only. **DEPRECATED** (Please use `person.ageRanges` instead) The person's age range.
  - `names` Name[] — The person's names. This field is a singleton for contact sources.
    - `displayName` string — Output only. The display name formatted according to the locale specified by the viewer's account or the `Accept-Language` HTTP header.
    - `unstructuredName` string — The free form name value.
    - `displayNameLastFirst` string — Output only. The display name with the last name first formatted according to the locale specified by the viewer's account or the `Accept-Language` HTTP header.
    - `givenName` string — The given name.
    - `honorificSuffix` string — The honorific suffixes, such as `Jr.`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `middleName` string — The middle name(s).
    - `phoneticFamilyName` string — The family name spelled as it sounds.
    - `phoneticHonorificSuffix` string — The honorific suffixes spelled as they sound.
    - `phoneticGivenName` string — The given name spelled as it sounds.
    - `familyName` string — The family name.
    - `phoneticHonorificPrefix` string — The honorific prefixes spelled as they sound.
    - `phoneticMiddleName` string — The middle name(s) spelled as they sound.
    - `phoneticFullName` string — The full name spelled as it sounds.
    - `honorificPrefix` string — The honorific prefixes, such as `Mrs.` or `Dr.`
  - `userDefined` UserDefined[] — The person's user defined data.
    - `key` string — The end user specified key of the user defined data.
    - `value` string — The end user specified value of the user defined data.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `skills` Skill[] — The person's skills.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The skill; for example, `underwater basket weaving`.
  - `photos` Photo[] — Output only. The person's photos.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `url` string — The URL of the photo. You can change the desired size by appending a query parameter `sz={size}` at the end of the url, where {size} is the size in pixels. Example: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
    - `default` boolean — True if the photo is a default photo; false if the photo is a user-provided photo.
  - `urls` Url[] — The person's associated URLs.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedType` string — Output only. The type of the URL translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `value` string — The URL.
    - `type` string — The type of the URL. The type can be custom or one of these predefined values: * `home` * `work` * `blog` * `profile` * `homePage` * `ftp` * `reservations` * `appInstallPage`: website for a Currents application. * `other`
  - `coverPhotos` CoverPhoto[] — Output only. The person's cover photos.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `url` string — The URL of the cover photo.
    - `default` boolean — True if the cover photo is the default cover photo; false if the cover photo is a user-provided cover photo.
  - `taglines` Tagline[] — Output only. **DEPRECATED**: No data will be returned The person's taglines.
    - `value` string — The tagline.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `locations` Location[] — The person's locations.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `floor` string — The floor name or number.
    - `deskCode` string — The individual desk location.
    - `value` string — The free-form value of the location.
    - `type` string — The type of the location. The type can be custom or one of these predefined values: * `desk` * `grewUp`
    - `buildingId` string — The building identifier.
    - `floorSection` string — The floor section in `floor_name`.
    - `current` boolean — Whether the location is the current location.
  - `occupations` Occupation[] — The person's occupations.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The occupation; for example, `carpenter`.
  - `residences` Residence[] — **DEPRECATED**: (Please use `person.locations` instead) The person's residences.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The address of the residence.
    - `current` boolean — True if the residence is the person's current residence; false if the residence is a past residence.
  - `relations` Relation[] — The person's relations.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedType` string — Output only. The type of the relation translated and formatted in the viewer's account locale or the locale specified in the Accept-Language HTTP header.
    - `type` string — The person's relation to the other person. The type can be custom or one of these predefined values: * `spouse` * `child` * `mother` * `father` * `parent` * `brother` * `sister` * `friend` * `relative` * `domesticPartner` * `manager` * `assistant` * `referredBy` * `partner`
    - `person` string — The name of the other person this relation refers to.
  - `calendarUrls` CalendarUrl[] — The person's calendar URLs.
    - `type` string — The type of the calendar URL. The type can be custom or one of these predefined values: * `home` * `freeBusy` * `work`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `url` string — The calendar URL.
    - `formattedType` string — Output only. The type of the calendar URL translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `miscKeywords` MiscKeyword[] — The person's miscellaneous keywords.
    - `value` string — The value of the miscellaneous keyword.
    - `type` 'TYPE_UNSPECIFIED' | 'OUTLOOK_BILLING_INFORMATION' | 'OUTLOOK_DIRECTORY_SERVER' | 'OUTLOOK_KEYWORD' | 'OUTLOOK_MILEAGE' | 'OUTLOOK_PRIORITY' | 'OUTLOOK_SENSITIVITY' | 'OUTLOOK_SUBJECT' | 'OUTLOOK_USER' | 'HOME' | 'WORK' | 'OTHER' — The miscellaneous keyword type.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedType` string — Output only. The type of the miscellaneous keyword translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `imClients` ImClient[] — The person's instant messaging clients.
    - `username` string — The user name used in the IM client.
    - `formattedProtocol` string — Output only. The protocol of the IM client formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `type` string — The type of the IM client. The type can be custom or one of these predefined values: * `home` * `work` * `other`
    - `formattedType` string — Output only. The type of the IM client translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `protocol` string — The protocol of the IM client. The protocol can be custom or one of these predefined values: * `aim` * `msn` * `yahoo` * `skype` * `qq` * `googleTalk` * `icq` * `jabber` * `netMeeting`
  - `locales` Locale[] — The person's locale preferences.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47) language tag representing the locale.
  - `interests` Interest[] — The person's interests.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The interest; for example, `stargazing`.
  - `phoneNumbers` 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 GetPeople.
    - `formattedType` string — Output only. The type of the phone number translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `value` string — The phone number.
    - `type` string — The type of the phone number. The type can be custom or one of these predefined values: * `home` * `work` * `mobile` * `homeFax` * `workFax` * `otherFax` * `pager` * `workMobile` * `workPager` * `main` * `googleVoice` * `other`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `canonicalForm` string — Output only. The canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf) form of the phone number.
  - `ageRanges` AgeRangeType[] — Output only. The person's age ranges.
    - `ageRange` 'AGE_RANGE_UNSPECIFIED' | 'LESS_THAN_EIGHTEEN' | 'EIGHTEEN_TO_TWENTY' | 'TWENTY_ONE_OR_OLDER' — The age range.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `events` Event[] — The person's events.
    - `type` string — The type of the event. The type can be custom or one of these predefined values: * `anniversary` * `other`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `date` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
    - `formattedType` string — Output only. The type of the event translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `organizations` Organization[] — The person's past or current organizations.
    - `formattedType` string — Output only. The type of the organization translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `symbol` string — The symbol associated with the organization; for example, a stock ticker symbol, abbreviation, or acronym.
    - `type` string — The type of the organization. The type can be custom or one of these predefined values: * `work` * `school`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `phoneticName` string — The phonetic name of the organization.
    - `title` string — The person's job title at the organization.
    - `current` boolean — True if the organization is the person's current organization; false if the organization is a past organization.
    - `jobDescription` string — The person's job description at the organization.
    - `domain` string — The domain name associated with the organization; for example, `google.com`.
    - `location` string — The location of the organization office the person works at.
    - `department` string — The person's department at the organization.
    - `endDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
    - `fullTimeEquivalentMillipercent` integer — The person's full-time equivalent millipercent within the organization (100000 = 100%).
    - `startDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
    - `name` string — The name of the organization.
    - `costCenter` string — The person's cost center at the organization.
  - `etag` string — The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the resource. Used for web cache validation.
  - `metadata` PersonMetadata — The metadata about a person.
    - `linkedPeopleResourceNames` string[] — Output only. Resource names of people linked to this resource.
    - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. **DEPRECATED** (Please use `person.metadata.sources.profileMetadata.objectType` instead) The type of the person object.
    - `previousResourceNames` string[] — Output only. Any former resource names this person has had. Populated only for `people.connections.list` requests that include a sync token. The resource name may change when adding or removing fields that link a contact and profile such as a verified email, verified phone number, or profile URL.
    - `deleted` boolean — Output only. True if the person resource has been deleted. Populated only for `people.connections.list` and `otherContacts.list` sync requests.
    - `sources` Source[] — The sources of data for the person.
      - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
      - `id` string — The unique identifier within the source type generated by the server.
      - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
      - `profileMetadata` ProfileMetadata — The metadata about a profile.
        - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
        - `userTypes` string[] — Output only. The user types.
      - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `genders` Gender[] — The person's genders. This field is a singleton for contact sources.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The gender for the person. The gender can be custom or one of these predefined values: * `male` * `female` * `unspecified`
    - `addressMeAs` string — Free form text field for pronouns that should be used to address the person. Common values are: * `he`/`him` * `she`/`her` * `they`/`them`
    - `formattedValue` string — Output only. The value of the gender translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale. Unspecified or custom value are not localized.
  - `resourceName` string — The resource name for the person, assigned by the server. An ASCII string in the form of `people/{person_id}`.
  - `emailAddresses` 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 GetPeople.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `displayName` string — The display name of the email.
    - `value` string — The email address.
    - `type` string — The type of the email address. The type can be custom or one of these predefined values: * `home` * `work` * `other`
    - `formattedType` string — Output only. The type of the email address translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `fileAses` FileAs[] — The person's file-ases.
    - `value` string — The file-as value
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `biographies` Biography[] — The person's biographies. This field is a singleton for contact sources.
    - `contentType` 'CONTENT_TYPE_UNSPECIFIED' | 'TEXT_PLAIN' | 'TEXT_HTML' — The content type of the biography.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The short biography.
  - `braggingRights` BraggingRights[] — **DEPRECATED**: No data will be returned The person's bragging rights.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `value` string — The bragging rights; for example, `climbed mount everest`.
  - `memberships` Membership[] — The person's group memberships.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `contactGroupMembership` ContactGroupMembership — A Google contact group membership.
      - `contactGroupId` string — Output only. The contact group ID for the contact group membership.
      - `contactGroupResourceName` string — The resource name for the contact group, assigned by the server. An ASCII string, in the form of `contactGroups/{contact_group_id}`. Only contact_group_resource_name can be used for modifying memberships. Any contact group membership can be removed, but only user group or "myContacts" or "starred" system groups memberships can be added. A contact must always have at least one contact group membership.
    - `domainMembership` DomainMembership — A Google Workspace Domain membership.
      - `inViewerDomain` boolean — True if the person is in the viewer's Google Workspace domain.
  - `relationshipInterests` RelationshipInterest[] — Output only. **DEPRECATED**: No data will be returned The person's relationship interests.
    - `value` string — The kind of relationship the person is looking for. The value can be custom or one of these predefined values: * `friend` * `date` * `relationship` * `networking`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedValue` string — Output only. The value of the relationship interest translated and formatted in the viewer's account locale or the locale specified in the Accept-Language HTTP header.
  - `relationshipStatuses` RelationshipStatus[] — Output only. **DEPRECATED**: No data will be returned The person's relationship statuses.
    - `value` string — The relationship status. The value can be custom or one of these predefined values: * `single` * `inARelationship` * `engaged` * `married` * `itsComplicated` * `openRelationship` * `widowed` * `inDomesticPartnership` * `inCivilUnion`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedValue` string — Output only. The value of the relationship status translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `clientData` ClientData[] — The person's client data.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `key` string — The client specified key of the client data.
    - `value` string — The client specified value of the client data.
  - `sipAddresses` SipAddress[] — The person's SIP addresses.
    - `value` string — The SIP address in the [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI format.
    - `type` string — The type of the SIP address. The type can be custom or or one of these predefined values: * `home` * `work` * `mobile` * `other`
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedType` string — Output only. The type of the SIP address translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
  - `externalIds` ExternalId[] — The person's external IDs.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `formattedType` string — Output only. The type of the event translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `value` string — The value of the external ID.
    - `type` string — The type of the external ID. The type can be custom or one of these predefined values: * `account` * `customer` * `loginId` * `network` * `organization`
  - `nicknames` Nickname[] — The person's nicknames.
    - `value` string — The nickname.
    - `type` 'DEFAULT' | 'MAIDEN_NAME' | 'INITIALS' | 'GPLUS' | 'OTHER_NAME' | 'ALTERNATE_NAME' | 'SHORT_NAME' — The type of the nickname.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
  - `addresses` Address[] — The person's street addresses.
    - `formattedType` string — Output only. The type of the address translated and formatted in the viewer's account locale or the `Accept-Language` HTTP header locale.
    - `type` string — The type of the address. The type can be custom or one of these predefined values: * `home` * `work` * `other`
    - `postalCode` string — The postal code of the address.
    - `streetAddress` string — The street address.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `poBox` string — The P.O. box of the address.
    - `region` string — The region of the address; for example, the state or province.
    - `extendedAddress` string — The extended address of the address; for example, the apartment number.
    - `countryCode` string — The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country code of the address.
    - `city` string — The city of the address.
    - `country` string — The country of the address.
    - `formattedValue` string — The unstructured value of the address. If this is not set by the user it will be automatically constructed from structured values.
  - `birthdays` Birthday[] — The person's birthdays. This field is a singleton for contact sources.
    - `metadata` FieldMetadata — Metadata about a field.
      - `primary` boolean — Output only. True if the field is the primary field for all sources in the person. Each person will have at most one field with `primary` set to true.
      - `verified` boolean — Output only. True if the field is verified; false if the field is unverified. A verified field is typically a name, email address, phone number, or website that has been confirmed to be owned by the person.
      - `sourcePrimary` boolean — True if the field is the primary field for the source. Each source must have at most one field with `source_primary` set to true.
      - `source` Source — The source of a field.
        - `etag` string — **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
        - `id` string — The unique identifier within the source type generated by the server.
        - `type` 'SOURCE_TYPE_UNSPECIFIED' | 'ACCOUNT' | 'PROFILE' | 'DOMAIN_PROFILE' | 'CONTACT' | 'OTHER_CONTACT' | 'DOMAIN_CONTACT' — The source type.
        - `profileMetadata` ProfileMetadata — The metadata about a profile.
          - `objectType` 'OBJECT_TYPE_UNSPECIFIED' | 'PERSON' | 'PAGE' — Output only. The profile object type.
          - `userTypes` string[] — Output only. The user types.
        - `updateTime` string, google-datetime — Output only. **Only populated in `person.metadata.sources`.** Last update timestamp of this source.
    - `date` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
    - `text` string — Prefer to use the `date` field if set. A free-form string representing the user's birthday. This value is not validated.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/people.md) · [All operations](https://skmtc.net/google/apis/people/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/people/revisions/92b2f44f6227/schema)