# Person

- [JSON representation](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#SCHEMA_REPRESENTATION)
- [Name](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Name)
  - [JSON representation](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Name.SCHEMA_REPRESENTATION)
- [EmailAddress](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress)
  - [JSON representation](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress.SCHEMA_REPRESENTATION)
- [PhoneNumber](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber)
  - [JSON representation](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.SCHEMA_REPRESENTATION)
- [PhoneNumber.PhoneNumberType](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.PhoneNumberType)
- [Photo](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Photo)
  - [JSON representation](https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Photo.SCHEMA_REPRESENTATION)

Object to represent a person.

| JSON representation |
|---|
| ``` { "name": string, "obfuscatedId": string, "personNames": [ { object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Name`) } ], "emailAddresses": [ { object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress`) } ], "phoneNumbers": [ { object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber`) } ], "photos": [ { object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Photo`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the person to provide information about. See [`People.get`](https://developers.google.com/people/api/rest/v1/people/get) from the Google People API. |
| `obfuscatedId` | `string` Obfuscated id of a person. |
| `personNames[]` | ``object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Name`)`` The person's name |
| `emailAddresses[]` | ``object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#EmailAddress`)`` The person's email addresses |
| `phoneNumbers[]` | ``object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber`)`` The person's phone numbers |
| `photos[]` | ``object (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#Photo`)`` A person's read-only photo. A picture shown next to the person's name to help others recognize the person in search results. |

## Name

A person's name.

| JSON representation |
|---|
| ``` { "displayName": string } ``` |

| Fields ||
|---|---|
| `displayName` | `string` The read-only display name formatted according to the locale specified by the viewer's account or the `Accept-Language` HTTP header. |

## EmailAddress

A person's email address.

| JSON representation |
|---|
| ``` { "emailAddress": string, "primary": boolean, "type": string, "customType": string, "emailUrl": string } ``` |

| Fields ||
|---|---|
| `emailAddress` | `string` The email address. |
| `primary` | `boolean` Indicates if this is the user's primary email. Only one entry can be marked as primary. |
| `type` | `string` The type of the email account. Acceptable values are: "custom", "home", "other", "work". |
| `customType` | `string` If the value of type is custom, this property contains the custom type string. |
| `emailUrl` | `string` The URL to send email. |

## PhoneNumber

A person's Phone Number

| JSON representation |
|---|
| ``` { "phoneNumber": string, "type": enum (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.PhoneNumberType`) } ``` |

| Fields ||
|---|---|
| `phoneNumber` | `string` The phone number of the person. |
| `type` | ``enum (`https://developers.google.com/workspace/cloud-search/docs/reference/rest/v1/Person#PhoneNumber.PhoneNumberType`)`` |

## PhoneNumber.PhoneNumberType

Phone number type enum.

| Enums ||
|---|---|
| `OTHER` |   |
| `MOBILE` |   |
| `OFFICE` |   |

## Photo

A person's photo.

| JSON representation |
|---|
| ``` { "url": string } ``` |

| Fields ||
|---|---|
| `url` | `string` The URL of the photo. |