blob: 346cbdbb1c863759656d5999f1c5eb37da713954 [file] [log] [blame]
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070075<h1><a href="people_v1.html">People API</a> . <a href="people_v1.people.html">people</a></h1>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -080076<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="people_v1.people.connections.html">connections()</a></code>
79</p>
80<p class="firstline">Returns the connections Resource.</p>
81
82<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070083 <code><a href="#createContact">createContact(body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070084<p class="firstline">Create a new contact and return the person resource for that contact.</p>
85<p class="toc_element">
86 <code><a href="#deleteContact">deleteContact(resourceName, x__xgafv=None)</a></code></p>
87<p class="firstline">Delete a contact person. Any non-contact data will not be deleted.</p>
88<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070089 <code><a href="#deleteContactPhoto">deleteContactPhoto(resourceName, personFields=None, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -070090<p class="firstline">Delete a contact's photo.</p>
91<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070092 <code><a href="#get">get(resourceName, requestMask_includeField=None, personFields=None, x__xgafv=None)</a></code></p>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040093<p class="firstline">Provides information about a person by specifying a resource name. Use</p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -080094<p class="toc_element">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070095 <code><a href="#getBatchGet">getBatchGet(personFields=None, requestMask_includeField=None, resourceNames=None, x__xgafv=None)</a></code></p>
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -040096<p class="firstline">Provides information about a list of specific people by specifying a list</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070097<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070098 <code><a href="#updateContact">updateContact(resourceName, body=None, updatePersonFields=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070099<p class="firstline">Update contact data for an existing contact person. Any non-contact data</p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700100<p class="toc_element">
101 <code><a href="#updateContactPhoto">updateContactPhoto(resourceName, body=None, x__xgafv=None)</a></code></p>
102<p class="firstline">Update a contact's photo.</p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800103<h3>Method Details</h3>
104<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700105 <code class="details" id="createContact">createContact(body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700106 <pre>Create a new contact and return the person resource for that contact.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800107
108Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700109 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700110 The object takes the form of:
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400111
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700112{ # Information about a person merged from various data sources such as the
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700113 # authenticated user&#x27;s contacts and profile data.
114 #
115 # Most fields can have multiple items. The items in a field have no guaranteed
116 # order, but each non-empty field is guaranteed to have exactly one field with
117 # `metadata.primary` set to true.
118 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
119 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
120 # are optional.
121 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
122 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
123 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
124 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
125 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
126 # account locale or the `Accept-Language` HTTP header locale.
127 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
128 # code of the address.
129 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
130 # values:
Bu Sun Kim65020912020-05-20 12:08:20 -0700131 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700132 # * `home`
133 # * `work`
134 # * `other`
135 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
136 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
137 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
138 # verified field is typically a name, email address, phone number, or
139 # website that has been confirmed to be owned by the person.
140 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
141 # field.
142 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -0700143 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
144 #
145 # Metadata about a source of type PROFILE.
146 &quot;userTypes&quot;: [ # Output only. The user types.
147 &quot;A String&quot;,
148 ],
149 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
150 },
151 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700152 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
153 #
154 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -0700155 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
156 #
157 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
158 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700159 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700160 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700161 },
162 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
163 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
164 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
165 # will be automatically constructed from structured values.
Bu Sun Kim65020912020-05-20 12:08:20 -0700166 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700167 ],
168 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
169 #
170 # The person&#x27;s age range.
171 &quot;relations&quot;: [ # The person&#x27;s relations.
172 { # A person&#x27;s relation to another person.
173 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
174 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
175 # account locale or the locale specified in the Accept-Language HTTP header.
176 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
177 # these predefined values:
178 #
179 # * `spouse`
180 # * `child`
181 # * `mother`
182 # * `father`
183 # * `parent`
184 # * `brother`
185 # * `sister`
186 # * `friend`
187 # * `relative`
188 # * `domesticPartner`
189 # * `manager`
190 # * `assistant`
191 # * `referredBy`
192 # * `partner`
193 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
194 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
195 # verified field is typically a name, email address, phone number, or
196 # website that has been confirmed to be owned by the person.
197 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
198 # field.
199 &quot;source&quot;: { # The source of a field. # The source of the field.
200 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
201 #
202 # Metadata about a source of type PROFILE.
203 &quot;userTypes&quot;: [ # Output only. The user types.
204 &quot;A String&quot;,
205 ],
206 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -0700207 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700208 &quot;type&quot;: &quot;A String&quot;, # The source type.
209 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
210 #
211 # Last update timestamp of this source.
212 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
213 #
214 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
215 # source. Used for web cache validation.
216 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700217 },
218 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700219 },
220 ],
221 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
222 { # A person&#x27;s past or current organization. Overlapping date ranges are
223 # permitted.
224 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
225 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
226 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
227 # false if the organization is a past organization.
228 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
229 # symbol, abbreviation, or acronym.
230 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
231 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
232 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
233 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
234 # verified field is typically a name, email address, phone number, or
235 # website that has been confirmed to be owned by the person.
236 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
237 # field.
238 &quot;source&quot;: { # The source of a field. # The source of the field.
239 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
240 #
241 # Metadata about a source of type PROFILE.
242 &quot;userTypes&quot;: [ # Output only. The user types.
243 &quot;A String&quot;,
244 ],
245 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -0700246 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700247 &quot;type&quot;: &quot;A String&quot;, # The source type.
248 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
249 #
250 # Last update timestamp of this source.
251 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
252 #
253 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
254 # source. Used for web cache validation.
255 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700256 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700257 },
258 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
259 # predefined values:
260 #
261 # * `work`
262 # * `school`
263 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
264 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
265 # and time zone are either specified elsewhere or are not significant. The date
266 # is relative to the Proleptic Gregorian Calendar. This can represent:
267 #
268 # * A full date, with non-zero year, month and day values
269 # * A month and day value, with a zero year, e.g. an anniversary
270 # * A year on its own, with zero month and day values
271 # * A year and month value, with a zero day, e.g. a credit card expiration date
272 #
273 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
274 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
275 # if specifying a year by itself or a year and month where the day is not
276 # significant.
277 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
278 # month and day.
279 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
280 # a year.
281 },
282 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
283 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
284 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
285 # `google.com`.
286 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
287 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
288 # and time zone are either specified elsewhere or are not significant. The date
289 # is relative to the Proleptic Gregorian Calendar. This can represent:
290 #
291 # * A full date, with non-zero year, month and day values
292 # * A month and day value, with a zero year, e.g. an anniversary
293 # * A year on its own, with zero month and day values
294 # * A year and month value, with a zero day, e.g. a credit card expiration date
295 #
296 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
297 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
298 # if specifying a year by itself or a year and month where the day is not
299 # significant.
300 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
301 # month and day.
302 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
303 # a year.
304 },
305 },
306 ],
307 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
308 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
309 # profile page that represents who they are or what they care about.
310 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
311 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
312 # verified field is typically a name, email address, phone number, or
313 # website that has been confirmed to be owned by the person.
314 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
315 # field.
316 &quot;source&quot;: { # The source of a field. # The source of the field.
317 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
318 #
319 # Metadata about a source of type PROFILE.
320 &quot;userTypes&quot;: [ # Output only. The user types.
321 &quot;A String&quot;,
322 ],
323 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
324 },
325 &quot;type&quot;: &quot;A String&quot;, # The source type.
326 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
327 #
328 # Last update timestamp of this source.
329 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
330 #
331 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
332 # source. Used for web cache validation.
333 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
334 },
335 },
336 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
337 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
338 # false if the cover photo is a user-provided cover photo.
339 },
340 ],
341 &quot;residences&quot;: [ # The person&#x27;s residences.
342 { # A person&#x27;s past or current residence.
343 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
344 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
345 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
346 # verified field is typically a name, email address, phone number, or
347 # website that has been confirmed to be owned by the person.
348 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
349 # field.
350 &quot;source&quot;: { # The source of a field. # The source of the field.
351 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
352 #
353 # Metadata about a source of type PROFILE.
354 &quot;userTypes&quot;: [ # Output only. The user types.
355 &quot;A String&quot;,
356 ],
357 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
358 },
359 &quot;type&quot;: &quot;A String&quot;, # The source type.
360 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
361 #
362 # Last update timestamp of this source.
363 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
364 #
365 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
366 # source. Used for web cache validation.
367 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
368 },
369 },
370 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
371 # false if the residence is a past residence.
372 },
373 ],
374 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
375 { # A person&#x27;s instant messaging client.
376 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
377 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
378 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
379 # verified field is typically a name, email address, phone number, or
380 # website that has been confirmed to be owned by the person.
381 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
382 # field.
383 &quot;source&quot;: { # The source of a field. # The source of the field.
384 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
385 #
386 # Metadata about a source of type PROFILE.
387 &quot;userTypes&quot;: [ # Output only. The user types.
388 &quot;A String&quot;,
389 ],
390 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
391 },
392 &quot;type&quot;: &quot;A String&quot;, # The source type.
393 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
394 #
395 # Last update timestamp of this source.
396 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
397 #
398 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
399 # source. Used for web cache validation.
400 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
401 },
402 },
403 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
404 # predefined values:
405 #
406 # * `home`
407 # * `work`
408 # * `other`
409 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
410 # predefined values:
411 #
412 # * `aim`
413 # * `msn`
414 # * `yahoo`
415 # * `skype`
416 # * `qq`
417 # * `googleTalk`
418 # * `icq`
419 # * `jabber`
420 # * `netMeeting`
421 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
422 # locale or the `Accept-Language` HTTP header locale.
423 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
424 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
425 },
426 ],
427 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
428 { # Arbitrary user data that is populated by the end users.
429 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
430 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
431 # verified field is typically a name, email address, phone number, or
432 # website that has been confirmed to be owned by the person.
433 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
434 # field.
435 &quot;source&quot;: { # The source of a field. # The source of the field.
436 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
437 #
438 # Metadata about a source of type PROFILE.
439 &quot;userTypes&quot;: [ # Output only. The user types.
440 &quot;A String&quot;,
441 ],
442 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
443 },
444 &quot;type&quot;: &quot;A String&quot;, # The source type.
445 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
446 #
447 # Last update timestamp of this source.
448 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
449 #
450 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
451 # source. Used for web cache validation.
452 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
453 },
454 },
455 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
456 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
457 },
458 ],
459 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
460 # resource. Used for web cache validation.
461 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
462 # The person&#x27;s bragging rights.
463 { # **DEPRECATED**: No data will be returned
464 # A person&#x27;s bragging rights.
465 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
466 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
467 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
468 # verified field is typically a name, email address, phone number, or
469 # website that has been confirmed to be owned by the person.
470 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
471 # field.
472 &quot;source&quot;: { # The source of a field. # The source of the field.
473 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
474 #
475 # Metadata about a source of type PROFILE.
476 &quot;userTypes&quot;: [ # Output only. The user types.
477 &quot;A String&quot;,
478 ],
479 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
480 },
481 &quot;type&quot;: &quot;A String&quot;, # The source type.
482 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
483 #
484 # Last update timestamp of this source.
485 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
486 #
487 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
488 # source. Used for web cache validation.
489 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
490 },
491 },
492 },
493 ],
494 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
495 # The person&#x27;s relationship interests.
496 { # **DEPRECATED**: No data will be returned
497 # A person&#x27;s relationship interest .
498 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
499 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
500 # verified field is typically a name, email address, phone number, or
501 # website that has been confirmed to be owned by the person.
502 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
503 # field.
504 &quot;source&quot;: { # The source of a field. # The source of the field.
505 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
506 #
507 # Metadata about a source of type PROFILE.
508 &quot;userTypes&quot;: [ # Output only. The user types.
509 &quot;A String&quot;,
510 ],
511 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
512 },
513 &quot;type&quot;: &quot;A String&quot;, # The source type.
514 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
515 #
516 # Last update timestamp of this source.
517 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
518 #
519 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
520 # source. Used for web cache validation.
521 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
522 },
523 },
524 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
525 # in the viewer&#x27;s account locale or the locale specified in the
526 # Accept-Language HTTP header.
527 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
528 # or one of these predefined values:
529 #
530 # * `friend`
531 # * `date`
532 # * `relationship`
533 # * `networking`
534 },
535 ],
536 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
537 { # A person&#x27;s age range.
538 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
539 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
540 # verified field is typically a name, email address, phone number, or
541 # website that has been confirmed to be owned by the person.
542 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
543 # field.
544 &quot;source&quot;: { # The source of a field. # The source of the field.
545 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
546 #
547 # Metadata about a source of type PROFILE.
548 &quot;userTypes&quot;: [ # Output only. The user types.
549 &quot;A String&quot;,
550 ],
551 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
552 },
553 &quot;type&quot;: &quot;A String&quot;, # The source type.
554 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
555 #
556 # Last update timestamp of this source.
557 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
558 #
559 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
560 # source. Used for web cache validation.
561 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
562 },
563 },
564 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
565 },
566 ],
567 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
568 { # A person&#x27;s membership in a group. Only contact group memberships can be
569 # modified.
570 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
571 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
572 # verified field is typically a name, email address, phone number, or
573 # website that has been confirmed to be owned by the person.
574 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
575 # field.
576 &quot;source&quot;: { # The source of a field. # The source of the field.
577 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
578 #
579 # Metadata about a source of type PROFILE.
580 &quot;userTypes&quot;: [ # Output only. The user types.
581 &quot;A String&quot;,
582 ],
583 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
584 },
585 &quot;type&quot;: &quot;A String&quot;, # The source type.
586 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
587 #
588 # Last update timestamp of this source.
589 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
590 #
591 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
592 # source. Used for web cache validation.
593 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
594 },
595 },
596 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
597 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
598 # string, in the form of `contactGroups/{contact_group_id}`.
599 # Only contact_group_resource_name can be used for modifying memberships.
600 # Any contact group membership can be removed, but only user group or
601 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
602 # contact must always have at least one contact group membership.
603 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
604 },
605 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
606 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
607 },
608 },
609 ],
610 &quot;occupations&quot;: [ # The person&#x27;s occupations.
611 { # A person&#x27;s occupation.
612 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
613 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
614 # verified field is typically a name, email address, phone number, or
615 # website that has been confirmed to be owned by the person.
616 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
617 # field.
618 &quot;source&quot;: { # The source of a field. # The source of the field.
619 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
620 #
621 # Metadata about a source of type PROFILE.
622 &quot;userTypes&quot;: [ # Output only. The user types.
623 &quot;A String&quot;,
624 ],
625 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
626 },
627 &quot;type&quot;: &quot;A String&quot;, # The source type.
628 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
629 #
630 # Last update timestamp of this source.
631 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
632 #
633 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
634 # source. Used for web cache validation.
635 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
636 },
637 },
638 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
639 },
640 ],
641 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
642 { # A person&#x27;s associated URLs.
643 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
644 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
645 # verified field is typically a name, email address, phone number, or
646 # website that has been confirmed to be owned by the person.
647 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
648 # field.
649 &quot;source&quot;: { # The source of a field. # The source of the field.
650 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
651 #
652 # Metadata about a source of type PROFILE.
653 &quot;userTypes&quot;: [ # Output only. The user types.
654 &quot;A String&quot;,
655 ],
656 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
657 },
658 &quot;type&quot;: &quot;A String&quot;, # The source type.
659 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
660 #
661 # Last update timestamp of this source.
662 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
663 #
664 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
665 # source. Used for web cache validation.
666 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
667 },
668 },
669 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
670 # values:
671 #
672 # * `home`
673 # * `work`
674 # * `blog`
675 # * `profile`
676 # * `homePage`
677 # * `ftp`
678 # * `reservations`
679 # * `appInstallPage`: website for a Google+ application.
680 # * `other`
681 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
682 # account locale or the `Accept-Language` HTTP header locale.
683 &quot;value&quot;: &quot;A String&quot;, # The URL.
684 },
685 ],
686 &quot;skills&quot;: [ # The person&#x27;s skills.
687 { # A skill that the person has.
688 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
689 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
690 # verified field is typically a name, email address, phone number, or
691 # website that has been confirmed to be owned by the person.
692 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
693 # field.
694 &quot;source&quot;: { # The source of a field. # The source of the field.
695 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
696 #
697 # Metadata about a source of type PROFILE.
698 &quot;userTypes&quot;: [ # Output only. The user types.
699 &quot;A String&quot;,
700 ],
701 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
702 },
703 &quot;type&quot;: &quot;A String&quot;, # The source type.
704 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
705 #
706 # Last update timestamp of this source.
707 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
708 #
709 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
710 # source. Used for web cache validation.
711 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
712 },
713 },
714 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
715 },
716 ],
717 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
718 { # A person&#x27;s email address.
719 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
720 # predefined values:
721 #
722 # * `home`
723 # * `work`
724 # * `other`
725 &quot;value&quot;: &quot;A String&quot;, # The email address.
726 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
727 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
728 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
729 # verified field is typically a name, email address, phone number, or
730 # website that has been confirmed to be owned by the person.
731 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
732 # field.
733 &quot;source&quot;: { # The source of a field. # The source of the field.
734 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
735 #
736 # Metadata about a source of type PROFILE.
737 &quot;userTypes&quot;: [ # Output only. The user types.
738 &quot;A String&quot;,
739 ],
740 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
741 },
742 &quot;type&quot;: &quot;A String&quot;, # The source type.
743 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
744 #
745 # Last update timestamp of this source.
746 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
747 #
748 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
749 # source. Used for web cache validation.
750 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
751 },
752 },
753 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
754 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
755 },
756 ],
757 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
758 # The person&#x27;s taglines.
759 { # **DEPRECATED**: No data will be returned
760 # A brief one-line description of the person.
761 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
762 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
763 # verified field is typically a name, email address, phone number, or
764 # website that has been confirmed to be owned by the person.
765 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
766 # field.
767 &quot;source&quot;: { # The source of a field. # The source of the field.
768 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
769 #
770 # Metadata about a source of type PROFILE.
771 &quot;userTypes&quot;: [ # Output only. The user types.
772 &quot;A String&quot;,
773 ],
774 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
775 },
776 &quot;type&quot;: &quot;A String&quot;, # The source type.
777 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
778 #
779 # Last update timestamp of this source.
780 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
781 #
782 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
783 # source. Used for web cache validation.
784 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
785 },
786 },
787 &quot;value&quot;: &quot;A String&quot;, # The tagline.
788 },
789 ],
790 &quot;names&quot;: [ # The person&#x27;s names.
791 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
792 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
793 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
794 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
795 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
796 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
797 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
798 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
799 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
800 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
801 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
802 # the locale specified by the viewer&#x27;s account or the
803 # `Accept-Language` HTTP header.
804 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
805 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
806 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
807 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
808 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
809 # verified field is typically a name, email address, phone number, or
810 # website that has been confirmed to be owned by the person.
811 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
812 # field.
813 &quot;source&quot;: { # The source of a field. # The source of the field.
814 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
815 #
816 # Metadata about a source of type PROFILE.
817 &quot;userTypes&quot;: [ # Output only. The user types.
818 &quot;A String&quot;,
819 ],
820 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
821 },
822 &quot;type&quot;: &quot;A String&quot;, # The source type.
823 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
824 #
825 # Last update timestamp of this source.
826 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
827 #
828 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
829 # source. Used for web cache validation.
830 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
831 },
832 },
833 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
834 },
835 ],
836 &quot;biographies&quot;: [ # The person&#x27;s biographies.
837 { # A person&#x27;s short biography.
838 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
839 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
840 # verified field is typically a name, email address, phone number, or
841 # website that has been confirmed to be owned by the person.
842 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
843 # field.
844 &quot;source&quot;: { # The source of a field. # The source of the field.
845 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
846 #
847 # Metadata about a source of type PROFILE.
848 &quot;userTypes&quot;: [ # Output only. The user types.
849 &quot;A String&quot;,
850 ],
851 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
852 },
853 &quot;type&quot;: &quot;A String&quot;, # The source type.
854 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
855 #
856 # Last update timestamp of this source.
857 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
858 #
859 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
860 # source. Used for web cache validation.
861 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
862 },
863 },
864 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
865 &quot;value&quot;: &quot;A String&quot;, # The short biography.
866 },
867 ],
868 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
869 # with a max length of 27 characters, in the form of
870 # `people/{person_id}`.
871 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
872 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
873 # help others recognize the person.
874 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
875 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
876 # verified field is typically a name, email address, phone number, or
877 # website that has been confirmed to be owned by the person.
878 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
879 # field.
880 &quot;source&quot;: { # The source of a field. # The source of the field.
881 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
882 #
883 # Metadata about a source of type PROFILE.
884 &quot;userTypes&quot;: [ # Output only. The user types.
885 &quot;A String&quot;,
886 ],
887 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
888 },
889 &quot;type&quot;: &quot;A String&quot;, # The source type.
890 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
891 #
892 # Last update timestamp of this source.
893 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
894 #
895 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
896 # source. Used for web cache validation.
897 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
898 },
899 },
900 &quot;default&quot;: True or False, # True if the photo is a default photo;
901 # false if the photo is a user-provided photo.
902 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
903 # parameter `sz={size}` at the end of the url, where {size} is the size in
904 # pixels. Example:
905 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
906 },
907 ],
908 &quot;events&quot;: [ # The person&#x27;s events.
909 { # An event related to the person.
910 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
911 # values:
912 #
913 # * `anniversary`
914 # * `other`
915 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
916 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
917 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
918 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
919 # verified field is typically a name, email address, phone number, or
920 # website that has been confirmed to be owned by the person.
921 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
922 # field.
923 &quot;source&quot;: { # The source of a field. # The source of the field.
924 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
925 #
926 # Metadata about a source of type PROFILE.
927 &quot;userTypes&quot;: [ # Output only. The user types.
928 &quot;A String&quot;,
929 ],
930 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
931 },
932 &quot;type&quot;: &quot;A String&quot;, # The source type.
933 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
934 #
935 # Last update timestamp of this source.
936 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
937 #
938 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
939 # source. Used for web cache validation.
940 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
941 },
942 },
943 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
944 # and time zone are either specified elsewhere or are not significant. The date
945 # is relative to the Proleptic Gregorian Calendar. This can represent:
946 #
947 # * A full date, with non-zero year, month and day values
948 # * A month and day value, with a zero year, e.g. an anniversary
949 # * A year on its own, with zero month and day values
950 # * A year and month value, with a zero day, e.g. a credit card expiration date
951 #
952 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
953 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
954 # if specifying a year by itself or a year and month where the day is not
955 # significant.
956 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
957 # month and day.
958 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
959 # a year.
960 },
961 },
962 ],
963 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
964 { # A person&#x27;s locale preference.
965 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
966 # language tag representing the locale.
967 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
968 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
969 # verified field is typically a name, email address, phone number, or
970 # website that has been confirmed to be owned by the person.
971 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
972 # field.
973 &quot;source&quot;: { # The source of a field. # The source of the field.
974 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
975 #
976 # Metadata about a source of type PROFILE.
977 &quot;userTypes&quot;: [ # Output only. The user types.
978 &quot;A String&quot;,
979 ],
980 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
981 },
982 &quot;type&quot;: &quot;A String&quot;, # The source type.
983 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
984 #
985 # Last update timestamp of this source.
986 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
987 #
988 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
989 # source. Used for web cache validation.
990 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
991 },
992 },
993 },
994 ],
995 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
996 { # A person&#x27;s phone number.
997 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
998 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
999 # form of the phone number.
1000 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
1001 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
1002 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
1003 # predefined values:
1004 #
1005 # * `home`
1006 # * `work`
1007 # * `mobile`
1008 # * `homeFax`
1009 # * `workFax`
1010 # * `otherFax`
1011 # * `pager`
1012 # * `workMobile`
1013 # * `workPager`
1014 # * `main`
1015 # * `googleVoice`
1016 # * `other`
1017 &quot;value&quot;: &quot;A String&quot;, # The phone number.
1018 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
1019 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1020 # verified field is typically a name, email address, phone number, or
1021 # website that has been confirmed to be owned by the person.
1022 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1023 # field.
1024 &quot;source&quot;: { # The source of a field. # The source of the field.
1025 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1026 #
1027 # Metadata about a source of type PROFILE.
1028 &quot;userTypes&quot;: [ # Output only. The user types.
1029 &quot;A String&quot;,
1030 ],
1031 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1032 },
1033 &quot;type&quot;: &quot;A String&quot;, # The source type.
1034 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1035 #
1036 # Last update timestamp of this source.
1037 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1038 #
1039 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1040 # source. Used for web cache validation.
1041 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1042 },
1043 },
1044 },
1045 ],
1046 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
1047 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
1048 # communications to make voice or video calls over the internet.
1049 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
1050 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
1051 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
1052 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
1053 # format.
1054 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
1055 # predefined values:
1056 #
1057 # * `home`
1058 # * `work`
1059 # * `mobile`
1060 # * `other`
1061 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
1062 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1063 # verified field is typically a name, email address, phone number, or
1064 # website that has been confirmed to be owned by the person.
1065 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1066 # field.
1067 &quot;source&quot;: { # The source of a field. # The source of the field.
1068 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1069 #
1070 # Metadata about a source of type PROFILE.
1071 &quot;userTypes&quot;: [ # Output only. The user types.
1072 &quot;A String&quot;,
1073 ],
1074 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1075 },
1076 &quot;type&quot;: &quot;A String&quot;, # The source type.
1077 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1078 #
1079 # Last update timestamp of this source.
1080 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1081 #
1082 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1083 # source. Used for web cache validation.
1084 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1085 },
1086 },
1087 },
1088 ],
1089 &quot;interests&quot;: [ # The person&#x27;s interests.
1090 { # One of the person&#x27;s interests.
1091 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
1092 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1093 # verified field is typically a name, email address, phone number, or
1094 # website that has been confirmed to be owned by the person.
1095 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1096 # field.
1097 &quot;source&quot;: { # The source of a field. # The source of the field.
1098 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1099 #
1100 # Metadata about a source of type PROFILE.
1101 &quot;userTypes&quot;: [ # Output only. The user types.
1102 &quot;A String&quot;,
1103 ],
1104 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1105 },
1106 &quot;type&quot;: &quot;A String&quot;, # The source type.
1107 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1108 #
1109 # Last update timestamp of this source.
1110 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1111 #
1112 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1113 # source. Used for web cache validation.
1114 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1115 },
1116 },
1117 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
1118 },
1119 ],
1120 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
1121 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
1122 # specified. The `date` and `text` fields typically represent the same
1123 # date, but are not guaranteed to.
1124 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
1125 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1126 # verified field is typically a name, email address, phone number, or
1127 # website that has been confirmed to be owned by the person.
1128 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1129 # field.
1130 &quot;source&quot;: { # The source of a field. # The source of the field.
1131 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1132 #
1133 # Metadata about a source of type PROFILE.
1134 &quot;userTypes&quot;: [ # Output only. The user types.
1135 &quot;A String&quot;,
1136 ],
1137 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1138 },
1139 &quot;type&quot;: &quot;A String&quot;, # The source type.
1140 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1141 #
1142 # Last update timestamp of this source.
1143 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1144 #
1145 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1146 # source. Used for web cache validation.
1147 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1148 },
1149 },
1150 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
1151 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
1152 # and time zone are either specified elsewhere or are not significant. The date
1153 # is relative to the Proleptic Gregorian Calendar. This can represent:
1154 #
1155 # * A full date, with non-zero year, month and day values
1156 # * A month and day value, with a zero year, e.g. an anniversary
1157 # * A year on its own, with zero month and day values
1158 # * A year and month value, with a zero day, e.g. a credit card expiration date
1159 #
1160 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
1161 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
1162 # if specifying a year by itself or a year and month where the day is not
1163 # significant.
1164 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1165 # month and day.
1166 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1167 # a year.
1168 },
1169 },
1170 ],
1171 &quot;genders&quot;: [ # The person&#x27;s genders.
1172 { # A person&#x27;s gender.
1173 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
1174 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
1175 # value are not localized.
1176 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
1177 # can be custom or one of these predefined values:
1178 #
1179 # * `male`
1180 # * `female`
1181 # * `other`
1182 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
1183 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1184 # verified field is typically a name, email address, phone number, or
1185 # website that has been confirmed to be owned by the person.
1186 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1187 # field.
1188 &quot;source&quot;: { # The source of a field. # The source of the field.
1189 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1190 #
1191 # Metadata about a source of type PROFILE.
1192 &quot;userTypes&quot;: [ # Output only. The user types.
1193 &quot;A String&quot;,
1194 ],
1195 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1196 },
1197 &quot;type&quot;: &quot;A String&quot;, # The source type.
1198 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1199 #
1200 # Last update timestamp of this source.
1201 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1202 #
1203 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1204 # source. Used for web cache validation.
1205 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1206 },
1207 },
1208 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
1209 # predefined values:
1210 #
1211 # * `male`
1212 # * `female`
1213 # * `unspecified`
1214 },
1215 ],
1216 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
1217 { # A person&#x27;s nickname.
1218 &quot;value&quot;: &quot;A String&quot;, # The nickname.
1219 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
1220 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1221 # verified field is typically a name, email address, phone number, or
1222 # website that has been confirmed to be owned by the person.
1223 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1224 # field.
1225 &quot;source&quot;: { # The source of a field. # The source of the field.
1226 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1227 #
1228 # Metadata about a source of type PROFILE.
1229 &quot;userTypes&quot;: [ # Output only. The user types.
1230 &quot;A String&quot;,
1231 ],
1232 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1233 },
1234 &quot;type&quot;: &quot;A String&quot;, # The source type.
1235 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1236 #
1237 # Last update timestamp of this source.
1238 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1239 #
1240 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1241 # source. Used for web cache validation.
1242 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1243 },
1244 },
1245 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
1246 },
1247 ],
1248 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
1249 # The person&#x27;s relationship statuses.
1250 { # **DEPRECATED**: No data will be returned
1251 # A person&#x27;s relationship status.
1252 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
1253 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1254 # verified field is typically a name, email address, phone number, or
1255 # website that has been confirmed to be owned by the person.
1256 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1257 # field.
1258 &quot;source&quot;: { # The source of a field. # The source of the field.
1259 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1260 #
1261 # Metadata about a source of type PROFILE.
1262 &quot;userTypes&quot;: [ # Output only. The user types.
1263 &quot;A String&quot;,
1264 ],
1265 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1266 },
1267 &quot;type&quot;: &quot;A String&quot;, # The source type.
1268 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1269 #
1270 # Last update timestamp of this source.
1271 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1272 #
1273 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1274 # source. Used for web cache validation.
1275 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1276 },
1277 },
1278 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
1279 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
1280 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
1281 # predefined values:
1282 #
1283 # * `single`
1284 # * `inARelationship`
1285 # * `engaged`
1286 # * `married`
1287 # * `itsComplicated`
1288 # * `openRelationship`
1289 # * `widowed`
1290 # * `inDomesticPartnership`
1291 # * `inCivilUnion`
1292 },
1293 ],
1294 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
1295 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
1296 &quot;A String&quot;,
1297 ],
1298 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
1299 # `person.metadata.sources.profileMetadata.objectType` instead)
1300 #
1301 # The type of the person object.
1302 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
1303 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
1304 # that include a sync token.
1305 #
1306 # The resource name may change when adding or removing fields that link a
1307 # contact and profile such as a verified email, verified phone number, or
1308 # profile URL.
1309 &quot;A String&quot;,
1310 ],
1311 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
1312 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
1313 # that include a sync token.
1314 &quot;sources&quot;: [ # The sources of data for the person.
1315 { # The source of a field.
1316 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1317 #
1318 # Metadata about a source of type PROFILE.
1319 &quot;userTypes&quot;: [ # Output only. The user types.
1320 &quot;A String&quot;,
1321 ],
1322 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1323 },
1324 &quot;type&quot;: &quot;A String&quot;, # The source type.
1325 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1326 #
1327 # Last update timestamp of this source.
1328 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1329 #
1330 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1331 # source. Used for web cache validation.
1332 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07001333 },
1334 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001335 },
1336}
1337
1338 x__xgafv: string, V1 error format.
1339 Allowed values
1340 1 - v1 error format
1341 2 - v2 error format
1342
1343Returns:
1344 An object of the form:
1345
1346 { # Information about a person merged from various data sources such as the
1347 # authenticated user&#x27;s contacts and profile data.
1348 #
1349 # Most fields can have multiple items. The items in a field have no guaranteed
1350 # order, but each non-empty field is guaranteed to have exactly one field with
1351 # `metadata.primary` set to true.
1352 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
1353 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
1354 # are optional.
1355 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
1356 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
1357 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
1358 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
1359 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
1360 # account locale or the `Accept-Language` HTTP header locale.
1361 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
1362 # code of the address.
1363 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
1364 # values:
Bu Sun Kim65020912020-05-20 12:08:20 -07001365 #
1366 # * `home`
1367 # * `work`
1368 # * `other`
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001369 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
1370 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
1371 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1372 # verified field is typically a name, email address, phone number, or
1373 # website that has been confirmed to be owned by the person.
1374 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1375 # field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001376 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001377 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1378 #
1379 # Metadata about a source of type PROFILE.
1380 &quot;userTypes&quot;: [ # Output only. The user types.
1381 &quot;A String&quot;,
1382 ],
1383 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1384 },
1385 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim65020912020-05-20 12:08:20 -07001386 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001387 #
1388 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07001389 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001390 #
1391 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1392 # source. Used for web cache validation.
Bu Sun Kim65020912020-05-20 12:08:20 -07001393 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07001394 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001395 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001396 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
1397 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
1398 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
1399 # will be automatically constructed from structured values.
Bu Sun Kim65020912020-05-20 12:08:20 -07001400 },
1401 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001402 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
1403 #
1404 # The person&#x27;s age range.
Bu Sun Kim65020912020-05-20 12:08:20 -07001405 &quot;relations&quot;: [ # The person&#x27;s relations.
1406 { # A person&#x27;s relation to another person.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001407 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
1408 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
1409 # account locale or the locale specified in the Accept-Language HTTP header.
Bu Sun Kim65020912020-05-20 12:08:20 -07001410 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001411 # these predefined values:
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -04001412 #
1413 # * `spouse`
1414 # * `child`
1415 # * `mother`
1416 # * `father`
1417 # * `parent`
1418 # * `brother`
1419 # * `sister`
1420 # * `friend`
1421 # * `relative`
1422 # * `domesticPartner`
1423 # * `manager`
1424 # * `assistant`
1425 # * `referredBy`
1426 # * `partner`
Bu Sun Kim65020912020-05-20 12:08:20 -07001427 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001428 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1429 # verified field is typically a name, email address, phone number, or
1430 # website that has been confirmed to be owned by the person.
1431 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1432 # field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001433 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001434 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1435 #
1436 # Metadata about a source of type PROFILE.
1437 &quot;userTypes&quot;: [ # Output only. The user types.
1438 &quot;A String&quot;,
1439 ],
1440 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1441 },
1442 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim65020912020-05-20 12:08:20 -07001443 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1444 #
1445 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07001446 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1447 #
1448 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1449 # source. Used for web cache validation.
Bu Sun Kim65020912020-05-20 12:08:20 -07001450 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001451 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001452 },
1453 },
1454 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001455 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
1456 { # A person&#x27;s past or current organization. Overlapping date ranges are
1457 # permitted.
1458 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
Bu Sun Kim65020912020-05-20 12:08:20 -07001459 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001460 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
1461 # false if the organization is a past organization.
1462 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
1463 # symbol, abbreviation, or acronym.
1464 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
1465 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
1466 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
1467 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1468 # verified field is typically a name, email address, phone number, or
1469 # website that has been confirmed to be owned by the person.
1470 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1471 # field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001472 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001473 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1474 #
1475 # Metadata about a source of type PROFILE.
1476 &quot;userTypes&quot;: [ # Output only. The user types.
1477 &quot;A String&quot;,
1478 ],
1479 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1480 },
1481 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001482 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1483 #
1484 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07001485 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1486 #
1487 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1488 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001489 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07001490 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001491 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001492 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001493 # predefined values:
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -04001494 #
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -04001495 # * `work`
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001496 # * `school`
1497 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
1498 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
Dan O'Mearadd494642020-05-01 07:42:23 -07001499 # and time zone are either specified elsewhere or are not significant. The date
1500 # is relative to the Proleptic Gregorian Calendar. This can represent:
1501 #
1502 # * A full date, with non-zero year, month and day values
1503 # * A month and day value, with a zero year, e.g. an anniversary
1504 # * A year on its own, with zero month and day values
1505 # * A year and month value, with a zero day, e.g. a credit card expiration date
1506 #
1507 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
Bu Sun Kim65020912020-05-20 12:08:20 -07001508 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001509 # if specifying a year by itself or a year and month where the day is not
1510 # significant.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001511 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1512 # month and day.
1513 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1514 # a year.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001515 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001516 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
1517 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
1518 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
1519 # `google.com`.
1520 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
1521 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
1522 # and time zone are either specified elsewhere or are not significant. The date
1523 # is relative to the Proleptic Gregorian Calendar. This can represent:
1524 #
1525 # * A full date, with non-zero year, month and day values
1526 # * A month and day value, with a zero year, e.g. an anniversary
1527 # * A year on its own, with zero month and day values
1528 # * A year and month value, with a zero day, e.g. a credit card expiration date
1529 #
1530 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
1531 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
1532 # if specifying a year by itself or a year and month where the day is not
1533 # significant.
1534 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
1535 # month and day.
1536 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
1537 # a year.
1538 },
1539 },
1540 ],
1541 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
1542 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
1543 # profile page that represents who they are or what they care about.
1544 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
1545 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1546 # verified field is typically a name, email address, phone number, or
1547 # website that has been confirmed to be owned by the person.
1548 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1549 # field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001550 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001551 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1552 #
1553 # Metadata about a source of type PROFILE.
1554 &quot;userTypes&quot;: [ # Output only. The user types.
1555 &quot;A String&quot;,
1556 ],
1557 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1558 },
1559 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001560 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1561 #
1562 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07001563 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1564 #
1565 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1566 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001567 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07001568 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001569 },
1570 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
1571 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
1572 # false if the cover photo is a user-provided cover photo.
1573 },
1574 ],
1575 &quot;residences&quot;: [ # The person&#x27;s residences.
1576 { # A person&#x27;s past or current residence.
1577 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
1578 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
Bu Sun Kim65020912020-05-20 12:08:20 -07001579 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1580 # verified field is typically a name, email address, phone number, or
1581 # website that has been confirmed to be owned by the person.
1582 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1583 # field.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001584 &quot;source&quot;: { # The source of a field. # The source of the field.
1585 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1586 #
1587 # Metadata about a source of type PROFILE.
1588 &quot;userTypes&quot;: [ # Output only. The user types.
1589 &quot;A String&quot;,
1590 ],
1591 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1592 },
1593 &quot;type&quot;: &quot;A String&quot;, # The source type.
1594 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1595 #
1596 # Last update timestamp of this source.
1597 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1598 #
1599 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1600 # source. Used for web cache validation.
1601 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1602 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001603 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001604 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
1605 # false if the residence is a past residence.
1606 },
1607 ],
1608 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
1609 { # A person&#x27;s instant messaging client.
1610 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
1611 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
1612 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1613 # verified field is typically a name, email address, phone number, or
1614 # website that has been confirmed to be owned by the person.
1615 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1616 # field.
1617 &quot;source&quot;: { # The source of a field. # The source of the field.
1618 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1619 #
1620 # Metadata about a source of type PROFILE.
1621 &quot;userTypes&quot;: [ # Output only. The user types.
1622 &quot;A String&quot;,
1623 ],
1624 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1625 },
1626 &quot;type&quot;: &quot;A String&quot;, # The source type.
1627 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1628 #
1629 # Last update timestamp of this source.
1630 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1631 #
1632 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1633 # source. Used for web cache validation.
1634 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1635 },
1636 },
1637 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
1638 # predefined values:
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -04001639 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001640 # * `home`
1641 # * `work`
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -04001642 # * `other`
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001643 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
1644 # predefined values:
1645 #
1646 # * `aim`
1647 # * `msn`
1648 # * `yahoo`
1649 # * `skype`
1650 # * `qq`
1651 # * `googleTalk`
1652 # * `icq`
1653 # * `jabber`
1654 # * `netMeeting`
1655 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
1656 # locale or the `Accept-Language` HTTP header locale.
1657 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
1658 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
1659 },
1660 ],
1661 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
1662 { # Arbitrary user data that is populated by the end users.
1663 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
1664 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1665 # verified field is typically a name, email address, phone number, or
1666 # website that has been confirmed to be owned by the person.
1667 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1668 # field.
1669 &quot;source&quot;: { # The source of a field. # The source of the field.
1670 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1671 #
1672 # Metadata about a source of type PROFILE.
1673 &quot;userTypes&quot;: [ # Output only. The user types.
1674 &quot;A String&quot;,
1675 ],
1676 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1677 },
1678 &quot;type&quot;: &quot;A String&quot;, # The source type.
1679 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1680 #
1681 # Last update timestamp of this source.
1682 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1683 #
1684 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1685 # source. Used for web cache validation.
1686 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1687 },
1688 },
1689 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
1690 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
1691 },
1692 ],
1693 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1694 # resource. Used for web cache validation.
1695 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
1696 # The person&#x27;s bragging rights.
1697 { # **DEPRECATED**: No data will be returned
1698 # A person&#x27;s bragging rights.
1699 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
1700 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
1701 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1702 # verified field is typically a name, email address, phone number, or
1703 # website that has been confirmed to be owned by the person.
1704 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1705 # field.
1706 &quot;source&quot;: { # The source of a field. # The source of the field.
1707 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1708 #
1709 # Metadata about a source of type PROFILE.
1710 &quot;userTypes&quot;: [ # Output only. The user types.
1711 &quot;A String&quot;,
1712 ],
1713 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1714 },
1715 &quot;type&quot;: &quot;A String&quot;, # The source type.
1716 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1717 #
1718 # Last update timestamp of this source.
1719 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1720 #
1721 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1722 # source. Used for web cache validation.
1723 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1724 },
1725 },
1726 },
1727 ],
1728 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
1729 # The person&#x27;s relationship interests.
1730 { # **DEPRECATED**: No data will be returned
1731 # A person&#x27;s relationship interest .
1732 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
1733 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1734 # verified field is typically a name, email address, phone number, or
1735 # website that has been confirmed to be owned by the person.
1736 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1737 # field.
1738 &quot;source&quot;: { # The source of a field. # The source of the field.
1739 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1740 #
1741 # Metadata about a source of type PROFILE.
1742 &quot;userTypes&quot;: [ # Output only. The user types.
1743 &quot;A String&quot;,
1744 ],
1745 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1746 },
1747 &quot;type&quot;: &quot;A String&quot;, # The source type.
1748 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1749 #
1750 # Last update timestamp of this source.
1751 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1752 #
1753 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1754 # source. Used for web cache validation.
1755 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1756 },
1757 },
1758 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
1759 # in the viewer&#x27;s account locale or the locale specified in the
1760 # Accept-Language HTTP header.
1761 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
1762 # or one of these predefined values:
1763 #
1764 # * `friend`
1765 # * `date`
1766 # * `relationship`
1767 # * `networking`
1768 },
1769 ],
1770 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
1771 { # A person&#x27;s age range.
1772 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
1773 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1774 # verified field is typically a name, email address, phone number, or
1775 # website that has been confirmed to be owned by the person.
1776 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1777 # field.
1778 &quot;source&quot;: { # The source of a field. # The source of the field.
1779 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1780 #
1781 # Metadata about a source of type PROFILE.
1782 &quot;userTypes&quot;: [ # Output only. The user types.
1783 &quot;A String&quot;,
1784 ],
1785 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1786 },
1787 &quot;type&quot;: &quot;A String&quot;, # The source type.
1788 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1789 #
1790 # Last update timestamp of this source.
1791 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1792 #
1793 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1794 # source. Used for web cache validation.
1795 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1796 },
1797 },
1798 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
1799 },
1800 ],
1801 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
1802 { # A person&#x27;s membership in a group. Only contact group memberships can be
1803 # modified.
1804 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
1805 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1806 # verified field is typically a name, email address, phone number, or
1807 # website that has been confirmed to be owned by the person.
1808 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1809 # field.
1810 &quot;source&quot;: { # The source of a field. # The source of the field.
1811 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1812 #
1813 # Metadata about a source of type PROFILE.
1814 &quot;userTypes&quot;: [ # Output only. The user types.
1815 &quot;A String&quot;,
1816 ],
1817 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1818 },
1819 &quot;type&quot;: &quot;A String&quot;, # The source type.
1820 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1821 #
1822 # Last update timestamp of this source.
1823 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1824 #
1825 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1826 # source. Used for web cache validation.
1827 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1828 },
1829 },
1830 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
1831 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
1832 # string, in the form of `contactGroups/{contact_group_id}`.
1833 # Only contact_group_resource_name can be used for modifying memberships.
1834 # Any contact group membership can be removed, but only user group or
1835 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
1836 # contact must always have at least one contact group membership.
1837 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
1838 },
1839 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
1840 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
1841 },
1842 },
1843 ],
1844 &quot;occupations&quot;: [ # The person&#x27;s occupations.
1845 { # A person&#x27;s occupation.
1846 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
1847 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1848 # verified field is typically a name, email address, phone number, or
1849 # website that has been confirmed to be owned by the person.
1850 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1851 # field.
1852 &quot;source&quot;: { # The source of a field. # The source of the field.
1853 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1854 #
1855 # Metadata about a source of type PROFILE.
1856 &quot;userTypes&quot;: [ # Output only. The user types.
1857 &quot;A String&quot;,
1858 ],
1859 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1860 },
1861 &quot;type&quot;: &quot;A String&quot;, # The source type.
1862 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1863 #
1864 # Last update timestamp of this source.
1865 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1866 #
1867 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1868 # source. Used for web cache validation.
1869 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1870 },
1871 },
1872 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001873 },
1874 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07001875 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
1876 { # A person&#x27;s associated URLs.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001877 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
1878 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1879 # verified field is typically a name, email address, phone number, or
1880 # website that has been confirmed to be owned by the person.
1881 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1882 # field.
1883 &quot;source&quot;: { # The source of a field. # The source of the field.
1884 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1885 #
1886 # Metadata about a source of type PROFILE.
1887 &quot;userTypes&quot;: [ # Output only. The user types.
1888 &quot;A String&quot;,
1889 ],
1890 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1891 },
1892 &quot;type&quot;: &quot;A String&quot;, # The source type.
1893 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1894 #
1895 # Last update timestamp of this source.
1896 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1897 #
1898 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1899 # source. Used for web cache validation.
1900 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
1901 },
1902 },
Bu Sun Kim65020912020-05-20 12:08:20 -07001903 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001904 # values:
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -04001905 #
1906 # * `home`
1907 # * `work`
1908 # * `blog`
1909 # * `profile`
1910 # * `homePage`
1911 # * `ftp`
1912 # * `reservations`
1913 # * `appInstallPage`: website for a Google+ application.
1914 # * `other`
Bu Sun Kim65020912020-05-20 12:08:20 -07001915 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
1916 # account locale or the `Accept-Language` HTTP header locale.
1917 &quot;value&quot;: &quot;A String&quot;, # The URL.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001918 },
1919 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001920 &quot;skills&quot;: [ # The person&#x27;s skills.
1921 { # A skill that the person has.
1922 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
1923 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1924 # verified field is typically a name, email address, phone number, or
1925 # website that has been confirmed to be owned by the person.
1926 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1927 # field.
1928 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07001929 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1930 #
1931 # Metadata about a source of type PROFILE.
1932 &quot;userTypes&quot;: [ # Output only. The user types.
1933 &quot;A String&quot;,
1934 ],
1935 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
1936 },
1937 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001938 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1939 #
1940 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07001941 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001942 #
1943 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1944 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001945 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001946 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001947 },
1948 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08001949 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001950 ],
1951 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
1952 { # A person&#x27;s email address.
1953 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
1954 # predefined values:
1955 #
1956 # * `home`
1957 # * `work`
1958 # * `other`
1959 &quot;value&quot;: &quot;A String&quot;, # The email address.
1960 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
1961 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
1962 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1963 # verified field is typically a name, email address, phone number, or
1964 # website that has been confirmed to be owned by the person.
1965 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
1966 # field.
1967 &quot;source&quot;: { # The source of a field. # The source of the field.
1968 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
1969 #
1970 # Metadata about a source of type PROFILE.
1971 &quot;userTypes&quot;: [ # Output only. The user types.
1972 &quot;A String&quot;,
1973 ],
1974 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07001975 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001976 &quot;type&quot;: &quot;A String&quot;, # The source type.
1977 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
1978 #
1979 # Last update timestamp of this source.
1980 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
1981 #
1982 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
1983 # source. Used for web cache validation.
1984 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07001985 },
1986 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07001987 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
1988 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
1989 },
1990 ],
1991 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
1992 # The person&#x27;s taglines.
1993 { # **DEPRECATED**: No data will be returned
1994 # A brief one-line description of the person.
1995 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
1996 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
1997 # verified field is typically a name, email address, phone number, or
1998 # website that has been confirmed to be owned by the person.
1999 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2000 # field.
2001 &quot;source&quot;: { # The source of a field. # The source of the field.
2002 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2003 #
2004 # Metadata about a source of type PROFILE.
2005 &quot;userTypes&quot;: [ # Output only. The user types.
2006 &quot;A String&quot;,
2007 ],
2008 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2009 },
2010 &quot;type&quot;: &quot;A String&quot;, # The source type.
2011 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2012 #
2013 # Last update timestamp of this source.
2014 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2015 #
2016 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2017 # source. Used for web cache validation.
2018 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2019 },
2020 },
2021 &quot;value&quot;: &quot;A String&quot;, # The tagline.
2022 },
2023 ],
2024 &quot;names&quot;: [ # The person&#x27;s names.
2025 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
2026 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
2027 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
2028 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
2029 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
2030 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
2031 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
2032 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
2033 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
2034 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
2035 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
2036 # the locale specified by the viewer&#x27;s account or the
2037 # `Accept-Language` HTTP header.
2038 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
2039 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
2040 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
2041 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
2042 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2043 # verified field is typically a name, email address, phone number, or
2044 # website that has been confirmed to be owned by the person.
2045 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2046 # field.
2047 &quot;source&quot;: { # The source of a field. # The source of the field.
2048 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2049 #
2050 # Metadata about a source of type PROFILE.
2051 &quot;userTypes&quot;: [ # Output only. The user types.
2052 &quot;A String&quot;,
2053 ],
2054 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2055 },
2056 &quot;type&quot;: &quot;A String&quot;, # The source type.
2057 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2058 #
2059 # Last update timestamp of this source.
2060 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2061 #
2062 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2063 # source. Used for web cache validation.
2064 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2065 },
2066 },
2067 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
2068 },
2069 ],
2070 &quot;biographies&quot;: [ # The person&#x27;s biographies.
2071 { # A person&#x27;s short biography.
2072 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
2073 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2074 # verified field is typically a name, email address, phone number, or
2075 # website that has been confirmed to be owned by the person.
2076 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2077 # field.
2078 &quot;source&quot;: { # The source of a field. # The source of the field.
2079 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2080 #
2081 # Metadata about a source of type PROFILE.
2082 &quot;userTypes&quot;: [ # Output only. The user types.
2083 &quot;A String&quot;,
2084 ],
2085 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2086 },
2087 &quot;type&quot;: &quot;A String&quot;, # The source type.
2088 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2089 #
2090 # Last update timestamp of this source.
2091 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2092 #
2093 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2094 # source. Used for web cache validation.
2095 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2096 },
2097 },
2098 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
2099 &quot;value&quot;: &quot;A String&quot;, # The short biography.
2100 },
2101 ],
2102 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
2103 # with a max length of 27 characters, in the form of
2104 # `people/{person_id}`.
2105 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
2106 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
2107 # help others recognize the person.
2108 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
2109 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2110 # verified field is typically a name, email address, phone number, or
2111 # website that has been confirmed to be owned by the person.
2112 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2113 # field.
2114 &quot;source&quot;: { # The source of a field. # The source of the field.
2115 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2116 #
2117 # Metadata about a source of type PROFILE.
2118 &quot;userTypes&quot;: [ # Output only. The user types.
2119 &quot;A String&quot;,
2120 ],
2121 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2122 },
2123 &quot;type&quot;: &quot;A String&quot;, # The source type.
2124 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2125 #
2126 # Last update timestamp of this source.
2127 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2128 #
2129 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2130 # source. Used for web cache validation.
2131 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2132 },
2133 },
2134 &quot;default&quot;: True or False, # True if the photo is a default photo;
2135 # false if the photo is a user-provided photo.
2136 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
2137 # parameter `sz={size}` at the end of the url, where {size} is the size in
2138 # pixels. Example:
2139 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
2140 },
2141 ],
2142 &quot;events&quot;: [ # The person&#x27;s events.
2143 { # An event related to the person.
2144 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
2145 # values:
2146 #
2147 # * `anniversary`
2148 # * `other`
2149 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
2150 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2151 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
2152 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2153 # verified field is typically a name, email address, phone number, or
2154 # website that has been confirmed to be owned by the person.
2155 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2156 # field.
2157 &quot;source&quot;: { # The source of a field. # The source of the field.
2158 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2159 #
2160 # Metadata about a source of type PROFILE.
2161 &quot;userTypes&quot;: [ # Output only. The user types.
2162 &quot;A String&quot;,
2163 ],
2164 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2165 },
2166 &quot;type&quot;: &quot;A String&quot;, # The source type.
2167 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2168 #
2169 # Last update timestamp of this source.
2170 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2171 #
2172 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2173 # source. Used for web cache validation.
2174 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2175 },
2176 },
2177 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
2178 # and time zone are either specified elsewhere or are not significant. The date
2179 # is relative to the Proleptic Gregorian Calendar. This can represent:
2180 #
2181 # * A full date, with non-zero year, month and day values
2182 # * A month and day value, with a zero year, e.g. an anniversary
2183 # * A year on its own, with zero month and day values
2184 # * A year and month value, with a zero day, e.g. a credit card expiration date
2185 #
2186 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2187 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2188 # if specifying a year by itself or a year and month where the day is not
2189 # significant.
2190 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2191 # month and day.
2192 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2193 # a year.
2194 },
2195 },
2196 ],
2197 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
2198 { # A person&#x27;s locale preference.
2199 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
2200 # language tag representing the locale.
2201 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
2202 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2203 # verified field is typically a name, email address, phone number, or
2204 # website that has been confirmed to be owned by the person.
2205 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2206 # field.
2207 &quot;source&quot;: { # The source of a field. # The source of the field.
2208 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2209 #
2210 # Metadata about a source of type PROFILE.
2211 &quot;userTypes&quot;: [ # Output only. The user types.
2212 &quot;A String&quot;,
2213 ],
2214 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2215 },
2216 &quot;type&quot;: &quot;A String&quot;, # The source type.
2217 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2218 #
2219 # Last update timestamp of this source.
2220 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2221 #
2222 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2223 # source. Used for web cache validation.
2224 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2225 },
2226 },
2227 },
2228 ],
2229 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
2230 { # A person&#x27;s phone number.
2231 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
2232 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
2233 # form of the phone number.
2234 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
2235 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2236 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
2237 # predefined values:
2238 #
2239 # * `home`
2240 # * `work`
2241 # * `mobile`
2242 # * `homeFax`
2243 # * `workFax`
2244 # * `otherFax`
2245 # * `pager`
2246 # * `workMobile`
2247 # * `workPager`
2248 # * `main`
2249 # * `googleVoice`
2250 # * `other`
2251 &quot;value&quot;: &quot;A String&quot;, # The phone number.
2252 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
2253 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2254 # verified field is typically a name, email address, phone number, or
2255 # website that has been confirmed to be owned by the person.
2256 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2257 # field.
2258 &quot;source&quot;: { # The source of a field. # The source of the field.
2259 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2260 #
2261 # Metadata about a source of type PROFILE.
2262 &quot;userTypes&quot;: [ # Output only. The user types.
2263 &quot;A String&quot;,
2264 ],
2265 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2266 },
2267 &quot;type&quot;: &quot;A String&quot;, # The source type.
2268 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2269 #
2270 # Last update timestamp of this source.
2271 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2272 #
2273 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2274 # source. Used for web cache validation.
2275 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2276 },
2277 },
2278 },
2279 ],
2280 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
2281 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
2282 # communications to make voice or video calls over the internet.
2283 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
2284 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2285 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
2286 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
2287 # format.
2288 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
2289 # predefined values:
2290 #
2291 # * `home`
2292 # * `work`
2293 # * `mobile`
2294 # * `other`
2295 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
2296 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2297 # verified field is typically a name, email address, phone number, or
2298 # website that has been confirmed to be owned by the person.
2299 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2300 # field.
2301 &quot;source&quot;: { # The source of a field. # The source of the field.
2302 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2303 #
2304 # Metadata about a source of type PROFILE.
2305 &quot;userTypes&quot;: [ # Output only. The user types.
2306 &quot;A String&quot;,
2307 ],
2308 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2309 },
2310 &quot;type&quot;: &quot;A String&quot;, # The source type.
2311 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2312 #
2313 # Last update timestamp of this source.
2314 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2315 #
2316 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2317 # source. Used for web cache validation.
2318 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2319 },
2320 },
2321 },
2322 ],
2323 &quot;interests&quot;: [ # The person&#x27;s interests.
2324 { # One of the person&#x27;s interests.
2325 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
2326 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2327 # verified field is typically a name, email address, phone number, or
2328 # website that has been confirmed to be owned by the person.
2329 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2330 # field.
2331 &quot;source&quot;: { # The source of a field. # The source of the field.
2332 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2333 #
2334 # Metadata about a source of type PROFILE.
2335 &quot;userTypes&quot;: [ # Output only. The user types.
2336 &quot;A String&quot;,
2337 ],
2338 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2339 },
2340 &quot;type&quot;: &quot;A String&quot;, # The source type.
2341 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2342 #
2343 # Last update timestamp of this source.
2344 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2345 #
2346 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2347 # source. Used for web cache validation.
2348 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2349 },
2350 },
2351 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
2352 },
2353 ],
2354 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
2355 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
2356 # specified. The `date` and `text` fields typically represent the same
2357 # date, but are not guaranteed to.
2358 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
2359 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2360 # verified field is typically a name, email address, phone number, or
2361 # website that has been confirmed to be owned by the person.
2362 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2363 # field.
2364 &quot;source&quot;: { # The source of a field. # The source of the field.
2365 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2366 #
2367 # Metadata about a source of type PROFILE.
2368 &quot;userTypes&quot;: [ # Output only. The user types.
2369 &quot;A String&quot;,
2370 ],
2371 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2372 },
2373 &quot;type&quot;: &quot;A String&quot;, # The source type.
2374 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2375 #
2376 # Last update timestamp of this source.
2377 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2378 #
2379 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2380 # source. Used for web cache validation.
2381 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2382 },
2383 },
2384 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
2385 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
2386 # and time zone are either specified elsewhere or are not significant. The date
2387 # is relative to the Proleptic Gregorian Calendar. This can represent:
2388 #
2389 # * A full date, with non-zero year, month and day values
2390 # * A month and day value, with a zero year, e.g. an anniversary
2391 # * A year on its own, with zero month and day values
2392 # * A year and month value, with a zero day, e.g. a credit card expiration date
2393 #
2394 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2395 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2396 # if specifying a year by itself or a year and month where the day is not
2397 # significant.
2398 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2399 # month and day.
2400 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2401 # a year.
2402 },
2403 },
2404 ],
2405 &quot;genders&quot;: [ # The person&#x27;s genders.
2406 { # A person&#x27;s gender.
2407 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
2408 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
2409 # value are not localized.
2410 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
2411 # can be custom or one of these predefined values:
2412 #
2413 # * `male`
2414 # * `female`
2415 # * `other`
2416 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
2417 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2418 # verified field is typically a name, email address, phone number, or
2419 # website that has been confirmed to be owned by the person.
2420 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2421 # field.
2422 &quot;source&quot;: { # The source of a field. # The source of the field.
2423 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2424 #
2425 # Metadata about a source of type PROFILE.
2426 &quot;userTypes&quot;: [ # Output only. The user types.
2427 &quot;A String&quot;,
2428 ],
2429 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2430 },
2431 &quot;type&quot;: &quot;A String&quot;, # The source type.
2432 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2433 #
2434 # Last update timestamp of this source.
2435 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2436 #
2437 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2438 # source. Used for web cache validation.
2439 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2440 },
2441 },
2442 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
2443 # predefined values:
2444 #
2445 # * `male`
2446 # * `female`
2447 # * `unspecified`
2448 },
2449 ],
2450 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
2451 { # A person&#x27;s nickname.
2452 &quot;value&quot;: &quot;A String&quot;, # The nickname.
2453 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
2454 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2455 # verified field is typically a name, email address, phone number, or
2456 # website that has been confirmed to be owned by the person.
2457 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2458 # field.
2459 &quot;source&quot;: { # The source of a field. # The source of the field.
2460 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2461 #
2462 # Metadata about a source of type PROFILE.
2463 &quot;userTypes&quot;: [ # Output only. The user types.
2464 &quot;A String&quot;,
2465 ],
2466 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2467 },
2468 &quot;type&quot;: &quot;A String&quot;, # The source type.
2469 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2470 #
2471 # Last update timestamp of this source.
2472 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2473 #
2474 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2475 # source. Used for web cache validation.
2476 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2477 },
2478 },
2479 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
2480 },
2481 ],
2482 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
2483 # The person&#x27;s relationship statuses.
2484 { # **DEPRECATED**: No data will be returned
2485 # A person&#x27;s relationship status.
2486 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
2487 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2488 # verified field is typically a name, email address, phone number, or
2489 # website that has been confirmed to be owned by the person.
2490 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2491 # field.
2492 &quot;source&quot;: { # The source of a field. # The source of the field.
2493 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2494 #
2495 # Metadata about a source of type PROFILE.
2496 &quot;userTypes&quot;: [ # Output only. The user types.
2497 &quot;A String&quot;,
2498 ],
2499 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2500 },
2501 &quot;type&quot;: &quot;A String&quot;, # The source type.
2502 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2503 #
2504 # Last update timestamp of this source.
2505 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2506 #
2507 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2508 # source. Used for web cache validation.
2509 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2510 },
2511 },
2512 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
2513 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2514 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
2515 # predefined values:
2516 #
2517 # * `single`
2518 # * `inARelationship`
2519 # * `engaged`
2520 # * `married`
2521 # * `itsComplicated`
2522 # * `openRelationship`
2523 # * `widowed`
2524 # * `inDomesticPartnership`
2525 # * `inCivilUnion`
2526 },
2527 ],
2528 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
2529 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
2530 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07002531 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002532 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
2533 # `person.metadata.sources.profileMetadata.objectType` instead)
2534 #
2535 # The type of the person object.
2536 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
2537 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
2538 # that include a sync token.
2539 #
2540 # The resource name may change when adding or removing fields that link a
2541 # contact and profile such as a verified email, verified phone number, or
2542 # profile URL.
2543 &quot;A String&quot;,
2544 ],
2545 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
2546 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
2547 # that include a sync token.
2548 &quot;sources&quot;: [ # The sources of data for the person.
2549 { # The source of a field.
2550 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07002551 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002552 # Metadata about a source of type PROFILE.
2553 &quot;userTypes&quot;: [ # Output only. The user types.
2554 &quot;A String&quot;,
2555 ],
2556 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2557 },
2558 &quot;type&quot;: &quot;A String&quot;, # The source type.
2559 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07002560 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002561 # Last update timestamp of this source.
2562 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07002563 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002564 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2565 # source. Used for web cache validation.
2566 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07002567 },
2568 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002569 },
2570 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002571</div>
2572
2573<div class="method">
2574 <code class="details" id="deleteContact">deleteContact(resourceName, x__xgafv=None)</code>
2575 <pre>Delete a contact person. Any non-contact data will not be deleted.
2576
2577Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07002578 resourceName: string, Required. The resource name of the contact to delete. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002579 x__xgafv: string, V1 error format.
2580 Allowed values
2581 1 - v1 error format
2582 2 - v2 error format
2583
2584Returns:
2585 An object of the form:
2586
2587 { # A generic empty message that you can re-use to avoid defining duplicated
2588 # empty messages in your APIs. A typical example is to use it as the request
2589 # or the response type of an API method. For instance:
2590 #
2591 # service Foo {
2592 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
2593 # }
2594 #
2595 # The JSON representation for `Empty` is empty JSON object `{}`.
2596 }</pre>
2597</div>
2598
2599<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -07002600 <code class="details" id="deleteContactPhoto">deleteContactPhoto(resourceName, personFields=None, x__xgafv=None)</code>
2601 <pre>Delete a contact&#x27;s photo.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002602
2603Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07002604 resourceName: string, Required. The resource name of the contact whose photo will be deleted. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -07002605 personFields: string, Optional. A field mask to restrict which fields on the person are returned. Multiple
2606fields can be specified by separating them with commas. Defaults to empty
2607if not set, which will skip the post mutate get. Valid values are:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002608
2609* addresses
2610* ageRanges
2611* biographies
2612* birthdays
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002613* coverPhotos
2614* emailAddresses
2615* events
2616* genders
2617* imClients
2618* interests
2619* locales
2620* memberships
2621* metadata
2622* names
2623* nicknames
2624* occupations
2625* organizations
2626* phoneNumbers
2627* photos
2628* relations
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002629* residences
2630* sipAddresses
2631* skills
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002632* urls
2633* userDefined
Bu Sun Kim65020912020-05-20 12:08:20 -07002634 x__xgafv: string, V1 error format.
2635 Allowed values
2636 1 - v1 error format
2637 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002638
2639Returns:
2640 An object of the form:
2641
Bu Sun Kim65020912020-05-20 12:08:20 -07002642 { # The response for deleteing a contact&#x27;s photo.
2643 &quot;person&quot;: { # Information about a person merged from various data sources such as the # The updated person, if person_fields is set in the
Dan O'Mearadd494642020-05-01 07:42:23 -07002644 # DeleteContactPhotoRequest; otherwise this will be unset.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002645 # authenticated user&#x27;s contacts and profile data.
2646 #
2647 # Most fields can have multiple items. The items in a field have no guaranteed
2648 # order, but each non-empty field is guaranteed to have exactly one field with
2649 # `metadata.primary` set to true.
2650 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
2651 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
2652 # are optional.
2653 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
2654 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
2655 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
2656 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
2657 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
2658 # account locale or the `Accept-Language` HTTP header locale.
2659 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
2660 # code of the address.
2661 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
2662 # values:
Dan O'Mearadd494642020-05-01 07:42:23 -07002663 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002664 # * `home`
2665 # * `work`
2666 # * `other`
2667 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
2668 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
2669 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2670 # verified field is typically a name, email address, phone number, or
2671 # website that has been confirmed to be owned by the person.
2672 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2673 # field.
2674 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07002675 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2676 #
2677 # Metadata about a source of type PROFILE.
2678 &quot;userTypes&quot;: [ # Output only. The user types.
2679 &quot;A String&quot;,
2680 ],
2681 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2682 },
2683 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002684 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2685 #
2686 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07002687 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002688 #
2689 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2690 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002691 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002692 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002693 },
2694 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
2695 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
2696 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
2697 # will be automatically constructed from structured values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002698 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002699 ],
2700 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
2701 #
2702 # The person&#x27;s age range.
2703 &quot;relations&quot;: [ # The person&#x27;s relations.
2704 { # A person&#x27;s relation to another person.
2705 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
2706 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
2707 # account locale or the locale specified in the Accept-Language HTTP header.
2708 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
2709 # these predefined values:
2710 #
2711 # * `spouse`
2712 # * `child`
2713 # * `mother`
2714 # * `father`
2715 # * `parent`
2716 # * `brother`
2717 # * `sister`
2718 # * `friend`
2719 # * `relative`
2720 # * `domesticPartner`
2721 # * `manager`
2722 # * `assistant`
2723 # * `referredBy`
2724 # * `partner`
2725 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
2726 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2727 # verified field is typically a name, email address, phone number, or
2728 # website that has been confirmed to be owned by the person.
2729 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2730 # field.
2731 &quot;source&quot;: { # The source of a field. # The source of the field.
2732 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2733 #
2734 # Metadata about a source of type PROFILE.
2735 &quot;userTypes&quot;: [ # Output only. The user types.
2736 &quot;A String&quot;,
2737 ],
2738 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07002739 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002740 &quot;type&quot;: &quot;A String&quot;, # The source type.
2741 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2742 #
2743 # Last update timestamp of this source.
2744 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2745 #
2746 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2747 # source. Used for web cache validation.
2748 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07002749 },
2750 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07002751 },
2752 ],
2753 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
2754 { # A person&#x27;s past or current organization. Overlapping date ranges are
2755 # permitted.
2756 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
2757 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2758 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
2759 # false if the organization is a past organization.
2760 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
2761 # symbol, abbreviation, or acronym.
2762 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
2763 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
2764 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
2765 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2766 # verified field is typically a name, email address, phone number, or
2767 # website that has been confirmed to be owned by the person.
2768 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2769 # field.
2770 &quot;source&quot;: { # The source of a field. # The source of the field.
2771 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2772 #
2773 # Metadata about a source of type PROFILE.
2774 &quot;userTypes&quot;: [ # Output only. The user types.
2775 &quot;A String&quot;,
2776 ],
2777 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2778 },
2779 &quot;type&quot;: &quot;A String&quot;, # The source type.
2780 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2781 #
2782 # Last update timestamp of this source.
2783 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2784 #
2785 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2786 # source. Used for web cache validation.
2787 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2788 },
2789 },
2790 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
2791 # predefined values:
2792 #
2793 # * `work`
2794 # * `school`
2795 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
2796 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
2797 # and time zone are either specified elsewhere or are not significant. The date
2798 # is relative to the Proleptic Gregorian Calendar. This can represent:
2799 #
2800 # * A full date, with non-zero year, month and day values
2801 # * A month and day value, with a zero year, e.g. an anniversary
2802 # * A year on its own, with zero month and day values
2803 # * A year and month value, with a zero day, e.g. a credit card expiration date
2804 #
2805 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2806 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2807 # if specifying a year by itself or a year and month where the day is not
2808 # significant.
2809 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2810 # month and day.
2811 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2812 # a year.
2813 },
2814 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
2815 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
2816 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
2817 # `google.com`.
2818 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
2819 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
2820 # and time zone are either specified elsewhere or are not significant. The date
2821 # is relative to the Proleptic Gregorian Calendar. This can represent:
2822 #
2823 # * A full date, with non-zero year, month and day values
2824 # * A month and day value, with a zero year, e.g. an anniversary
2825 # * A year on its own, with zero month and day values
2826 # * A year and month value, with a zero day, e.g. a credit card expiration date
2827 #
2828 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
2829 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
2830 # if specifying a year by itself or a year and month where the day is not
2831 # significant.
2832 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
2833 # month and day.
2834 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
2835 # a year.
2836 },
2837 },
2838 ],
2839 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
2840 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
2841 # profile page that represents who they are or what they care about.
2842 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
2843 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2844 # verified field is typically a name, email address, phone number, or
2845 # website that has been confirmed to be owned by the person.
2846 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2847 # field.
2848 &quot;source&quot;: { # The source of a field. # The source of the field.
2849 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2850 #
2851 # Metadata about a source of type PROFILE.
2852 &quot;userTypes&quot;: [ # Output only. The user types.
2853 &quot;A String&quot;,
2854 ],
2855 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2856 },
2857 &quot;type&quot;: &quot;A String&quot;, # The source type.
2858 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2859 #
2860 # Last update timestamp of this source.
2861 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2862 #
2863 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2864 # source. Used for web cache validation.
2865 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2866 },
2867 },
2868 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
2869 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
2870 # false if the cover photo is a user-provided cover photo.
2871 },
2872 ],
2873 &quot;residences&quot;: [ # The person&#x27;s residences.
2874 { # A person&#x27;s past or current residence.
2875 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
2876 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
2877 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2878 # verified field is typically a name, email address, phone number, or
2879 # website that has been confirmed to be owned by the person.
2880 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2881 # field.
2882 &quot;source&quot;: { # The source of a field. # The source of the field.
2883 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2884 #
2885 # Metadata about a source of type PROFILE.
2886 &quot;userTypes&quot;: [ # Output only. The user types.
2887 &quot;A String&quot;,
2888 ],
2889 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2890 },
2891 &quot;type&quot;: &quot;A String&quot;, # The source type.
2892 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2893 #
2894 # Last update timestamp of this source.
2895 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2896 #
2897 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2898 # source. Used for web cache validation.
2899 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2900 },
2901 },
2902 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
2903 # false if the residence is a past residence.
2904 },
2905 ],
2906 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
2907 { # A person&#x27;s instant messaging client.
2908 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
2909 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
2910 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2911 # verified field is typically a name, email address, phone number, or
2912 # website that has been confirmed to be owned by the person.
2913 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2914 # field.
2915 &quot;source&quot;: { # The source of a field. # The source of the field.
2916 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2917 #
2918 # Metadata about a source of type PROFILE.
2919 &quot;userTypes&quot;: [ # Output only. The user types.
2920 &quot;A String&quot;,
2921 ],
2922 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2923 },
2924 &quot;type&quot;: &quot;A String&quot;, # The source type.
2925 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2926 #
2927 # Last update timestamp of this source.
2928 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2929 #
2930 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2931 # source. Used for web cache validation.
2932 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2933 },
2934 },
2935 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
2936 # predefined values:
2937 #
2938 # * `home`
2939 # * `work`
2940 # * `other`
2941 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
2942 # predefined values:
2943 #
2944 # * `aim`
2945 # * `msn`
2946 # * `yahoo`
2947 # * `skype`
2948 # * `qq`
2949 # * `googleTalk`
2950 # * `icq`
2951 # * `jabber`
2952 # * `netMeeting`
2953 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
2954 # locale or the `Accept-Language` HTTP header locale.
2955 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
2956 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
2957 },
2958 ],
2959 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
2960 { # Arbitrary user data that is populated by the end users.
2961 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
2962 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
2963 # verified field is typically a name, email address, phone number, or
2964 # website that has been confirmed to be owned by the person.
2965 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
2966 # field.
2967 &quot;source&quot;: { # The source of a field. # The source of the field.
2968 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
2969 #
2970 # Metadata about a source of type PROFILE.
2971 &quot;userTypes&quot;: [ # Output only. The user types.
2972 &quot;A String&quot;,
2973 ],
2974 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
2975 },
2976 &quot;type&quot;: &quot;A String&quot;, # The source type.
2977 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
2978 #
2979 # Last update timestamp of this source.
2980 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
2981 #
2982 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2983 # source. Used for web cache validation.
2984 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
2985 },
2986 },
2987 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
2988 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
2989 },
2990 ],
2991 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
2992 # resource. Used for web cache validation.
2993 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
2994 # The person&#x27;s bragging rights.
2995 { # **DEPRECATED**: No data will be returned
2996 # A person&#x27;s bragging rights.
2997 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
2998 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
2999 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3000 # verified field is typically a name, email address, phone number, or
3001 # website that has been confirmed to be owned by the person.
3002 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3003 # field.
3004 &quot;source&quot;: { # The source of a field. # The source of the field.
3005 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3006 #
3007 # Metadata about a source of type PROFILE.
3008 &quot;userTypes&quot;: [ # Output only. The user types.
3009 &quot;A String&quot;,
3010 ],
3011 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3012 },
3013 &quot;type&quot;: &quot;A String&quot;, # The source type.
3014 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3015 #
3016 # Last update timestamp of this source.
3017 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3018 #
3019 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3020 # source. Used for web cache validation.
3021 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3022 },
3023 },
3024 },
3025 ],
3026 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
3027 # The person&#x27;s relationship interests.
3028 { # **DEPRECATED**: No data will be returned
3029 # A person&#x27;s relationship interest .
3030 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
3031 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3032 # verified field is typically a name, email address, phone number, or
3033 # website that has been confirmed to be owned by the person.
3034 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3035 # field.
3036 &quot;source&quot;: { # The source of a field. # The source of the field.
3037 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3038 #
3039 # Metadata about a source of type PROFILE.
3040 &quot;userTypes&quot;: [ # Output only. The user types.
3041 &quot;A String&quot;,
3042 ],
3043 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3044 },
3045 &quot;type&quot;: &quot;A String&quot;, # The source type.
3046 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3047 #
3048 # Last update timestamp of this source.
3049 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3050 #
3051 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3052 # source. Used for web cache validation.
3053 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3054 },
3055 },
3056 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
3057 # in the viewer&#x27;s account locale or the locale specified in the
3058 # Accept-Language HTTP header.
3059 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
3060 # or one of these predefined values:
3061 #
3062 # * `friend`
3063 # * `date`
3064 # * `relationship`
3065 # * `networking`
3066 },
3067 ],
3068 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
3069 { # A person&#x27;s age range.
3070 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
3071 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3072 # verified field is typically a name, email address, phone number, or
3073 # website that has been confirmed to be owned by the person.
3074 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3075 # field.
3076 &quot;source&quot;: { # The source of a field. # The source of the field.
3077 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3078 #
3079 # Metadata about a source of type PROFILE.
3080 &quot;userTypes&quot;: [ # Output only. The user types.
3081 &quot;A String&quot;,
3082 ],
3083 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3084 },
3085 &quot;type&quot;: &quot;A String&quot;, # The source type.
3086 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3087 #
3088 # Last update timestamp of this source.
3089 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3090 #
3091 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3092 # source. Used for web cache validation.
3093 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3094 },
3095 },
3096 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
3097 },
3098 ],
3099 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
3100 { # A person&#x27;s membership in a group. Only contact group memberships can be
3101 # modified.
3102 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
3103 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3104 # verified field is typically a name, email address, phone number, or
3105 # website that has been confirmed to be owned by the person.
3106 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3107 # field.
3108 &quot;source&quot;: { # The source of a field. # The source of the field.
3109 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3110 #
3111 # Metadata about a source of type PROFILE.
3112 &quot;userTypes&quot;: [ # Output only. The user types.
3113 &quot;A String&quot;,
3114 ],
3115 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3116 },
3117 &quot;type&quot;: &quot;A String&quot;, # The source type.
3118 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3119 #
3120 # Last update timestamp of this source.
3121 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3122 #
3123 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3124 # source. Used for web cache validation.
3125 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3126 },
3127 },
3128 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
3129 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
3130 # string, in the form of `contactGroups/{contact_group_id}`.
3131 # Only contact_group_resource_name can be used for modifying memberships.
3132 # Any contact group membership can be removed, but only user group or
3133 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
3134 # contact must always have at least one contact group membership.
3135 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
3136 },
3137 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
3138 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
3139 },
3140 },
3141 ],
3142 &quot;occupations&quot;: [ # The person&#x27;s occupations.
3143 { # A person&#x27;s occupation.
3144 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
3145 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3146 # verified field is typically a name, email address, phone number, or
3147 # website that has been confirmed to be owned by the person.
3148 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3149 # field.
3150 &quot;source&quot;: { # The source of a field. # The source of the field.
3151 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3152 #
3153 # Metadata about a source of type PROFILE.
3154 &quot;userTypes&quot;: [ # Output only. The user types.
3155 &quot;A String&quot;,
3156 ],
3157 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3158 },
3159 &quot;type&quot;: &quot;A String&quot;, # The source type.
3160 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3161 #
3162 # Last update timestamp of this source.
3163 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3164 #
3165 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3166 # source. Used for web cache validation.
3167 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3168 },
3169 },
3170 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
3171 },
3172 ],
3173 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
3174 { # A person&#x27;s associated URLs.
3175 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
3176 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3177 # verified field is typically a name, email address, phone number, or
3178 # website that has been confirmed to be owned by the person.
3179 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3180 # field.
3181 &quot;source&quot;: { # The source of a field. # The source of the field.
3182 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3183 #
3184 # Metadata about a source of type PROFILE.
3185 &quot;userTypes&quot;: [ # Output only. The user types.
3186 &quot;A String&quot;,
3187 ],
3188 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3189 },
3190 &quot;type&quot;: &quot;A String&quot;, # The source type.
3191 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3192 #
3193 # Last update timestamp of this source.
3194 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3195 #
3196 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3197 # source. Used for web cache validation.
3198 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3199 },
3200 },
3201 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
3202 # values:
3203 #
3204 # * `home`
3205 # * `work`
3206 # * `blog`
3207 # * `profile`
3208 # * `homePage`
3209 # * `ftp`
3210 # * `reservations`
3211 # * `appInstallPage`: website for a Google+ application.
3212 # * `other`
3213 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
3214 # account locale or the `Accept-Language` HTTP header locale.
3215 &quot;value&quot;: &quot;A String&quot;, # The URL.
3216 },
3217 ],
3218 &quot;skills&quot;: [ # The person&#x27;s skills.
3219 { # A skill that the person has.
3220 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
3221 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3222 # verified field is typically a name, email address, phone number, or
3223 # website that has been confirmed to be owned by the person.
3224 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3225 # field.
3226 &quot;source&quot;: { # The source of a field. # The source of the field.
3227 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3228 #
3229 # Metadata about a source of type PROFILE.
3230 &quot;userTypes&quot;: [ # Output only. The user types.
3231 &quot;A String&quot;,
3232 ],
3233 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3234 },
3235 &quot;type&quot;: &quot;A String&quot;, # The source type.
3236 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3237 #
3238 # Last update timestamp of this source.
3239 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3240 #
3241 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3242 # source. Used for web cache validation.
3243 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3244 },
3245 },
3246 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
3247 },
3248 ],
3249 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
3250 { # A person&#x27;s email address.
3251 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
3252 # predefined values:
3253 #
3254 # * `home`
3255 # * `work`
3256 # * `other`
3257 &quot;value&quot;: &quot;A String&quot;, # The email address.
3258 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
3259 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
3260 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3261 # verified field is typically a name, email address, phone number, or
3262 # website that has been confirmed to be owned by the person.
3263 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3264 # field.
3265 &quot;source&quot;: { # The source of a field. # The source of the field.
3266 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3267 #
3268 # Metadata about a source of type PROFILE.
3269 &quot;userTypes&quot;: [ # Output only. The user types.
3270 &quot;A String&quot;,
3271 ],
3272 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3273 },
3274 &quot;type&quot;: &quot;A String&quot;, # The source type.
3275 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3276 #
3277 # Last update timestamp of this source.
3278 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3279 #
3280 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3281 # source. Used for web cache validation.
3282 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3283 },
3284 },
3285 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
3286 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
3287 },
3288 ],
3289 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
3290 # The person&#x27;s taglines.
3291 { # **DEPRECATED**: No data will be returned
3292 # A brief one-line description of the person.
3293 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
3294 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3295 # verified field is typically a name, email address, phone number, or
3296 # website that has been confirmed to be owned by the person.
3297 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3298 # field.
3299 &quot;source&quot;: { # The source of a field. # The source of the field.
3300 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3301 #
3302 # Metadata about a source of type PROFILE.
3303 &quot;userTypes&quot;: [ # Output only. The user types.
3304 &quot;A String&quot;,
3305 ],
3306 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3307 },
3308 &quot;type&quot;: &quot;A String&quot;, # The source type.
3309 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3310 #
3311 # Last update timestamp of this source.
3312 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3313 #
3314 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3315 # source. Used for web cache validation.
3316 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3317 },
3318 },
3319 &quot;value&quot;: &quot;A String&quot;, # The tagline.
3320 },
3321 ],
3322 &quot;names&quot;: [ # The person&#x27;s names.
3323 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
3324 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
3325 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
3326 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
3327 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
3328 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
3329 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
3330 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
3331 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
3332 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
3333 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
3334 # the locale specified by the viewer&#x27;s account or the
3335 # `Accept-Language` HTTP header.
3336 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
3337 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
3338 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
3339 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
3340 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3341 # verified field is typically a name, email address, phone number, or
3342 # website that has been confirmed to be owned by the person.
3343 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3344 # field.
3345 &quot;source&quot;: { # The source of a field. # The source of the field.
3346 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3347 #
3348 # Metadata about a source of type PROFILE.
3349 &quot;userTypes&quot;: [ # Output only. The user types.
3350 &quot;A String&quot;,
3351 ],
3352 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3353 },
3354 &quot;type&quot;: &quot;A String&quot;, # The source type.
3355 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3356 #
3357 # Last update timestamp of this source.
3358 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3359 #
3360 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3361 # source. Used for web cache validation.
3362 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3363 },
3364 },
3365 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
3366 },
3367 ],
3368 &quot;biographies&quot;: [ # The person&#x27;s biographies.
3369 { # A person&#x27;s short biography.
3370 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
3371 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3372 # verified field is typically a name, email address, phone number, or
3373 # website that has been confirmed to be owned by the person.
3374 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3375 # field.
3376 &quot;source&quot;: { # The source of a field. # The source of the field.
3377 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3378 #
3379 # Metadata about a source of type PROFILE.
3380 &quot;userTypes&quot;: [ # Output only. The user types.
3381 &quot;A String&quot;,
3382 ],
3383 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3384 },
3385 &quot;type&quot;: &quot;A String&quot;, # The source type.
3386 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3387 #
3388 # Last update timestamp of this source.
3389 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3390 #
3391 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3392 # source. Used for web cache validation.
3393 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3394 },
3395 },
3396 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
3397 &quot;value&quot;: &quot;A String&quot;, # The short biography.
3398 },
3399 ],
3400 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
3401 # with a max length of 27 characters, in the form of
3402 # `people/{person_id}`.
3403 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
3404 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
3405 # help others recognize the person.
3406 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
3407 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3408 # verified field is typically a name, email address, phone number, or
3409 # website that has been confirmed to be owned by the person.
3410 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3411 # field.
3412 &quot;source&quot;: { # The source of a field. # The source of the field.
3413 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3414 #
3415 # Metadata about a source of type PROFILE.
3416 &quot;userTypes&quot;: [ # Output only. The user types.
3417 &quot;A String&quot;,
3418 ],
3419 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3420 },
3421 &quot;type&quot;: &quot;A String&quot;, # The source type.
3422 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3423 #
3424 # Last update timestamp of this source.
3425 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3426 #
3427 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3428 # source. Used for web cache validation.
3429 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3430 },
3431 },
3432 &quot;default&quot;: True or False, # True if the photo is a default photo;
3433 # false if the photo is a user-provided photo.
3434 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
3435 # parameter `sz={size}` at the end of the url, where {size} is the size in
3436 # pixels. Example:
3437 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
3438 },
3439 ],
3440 &quot;events&quot;: [ # The person&#x27;s events.
3441 { # An event related to the person.
3442 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
3443 # values:
3444 #
3445 # * `anniversary`
3446 # * `other`
3447 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
3448 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
3449 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
3450 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3451 # verified field is typically a name, email address, phone number, or
3452 # website that has been confirmed to be owned by the person.
3453 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3454 # field.
3455 &quot;source&quot;: { # The source of a field. # The source of the field.
3456 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3457 #
3458 # Metadata about a source of type PROFILE.
3459 &quot;userTypes&quot;: [ # Output only. The user types.
3460 &quot;A String&quot;,
3461 ],
3462 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3463 },
3464 &quot;type&quot;: &quot;A String&quot;, # The source type.
3465 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3466 #
3467 # Last update timestamp of this source.
3468 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3469 #
3470 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3471 # source. Used for web cache validation.
3472 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3473 },
3474 },
3475 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
3476 # and time zone are either specified elsewhere or are not significant. The date
3477 # is relative to the Proleptic Gregorian Calendar. This can represent:
3478 #
3479 # * A full date, with non-zero year, month and day values
3480 # * A month and day value, with a zero year, e.g. an anniversary
3481 # * A year on its own, with zero month and day values
3482 # * A year and month value, with a zero day, e.g. a credit card expiration date
3483 #
3484 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
3485 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
3486 # if specifying a year by itself or a year and month where the day is not
3487 # significant.
3488 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
3489 # month and day.
3490 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
3491 # a year.
3492 },
3493 },
3494 ],
3495 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
3496 { # A person&#x27;s locale preference.
3497 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
3498 # language tag representing the locale.
3499 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
3500 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3501 # verified field is typically a name, email address, phone number, or
3502 # website that has been confirmed to be owned by the person.
3503 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3504 # field.
3505 &quot;source&quot;: { # The source of a field. # The source of the field.
3506 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3507 #
3508 # Metadata about a source of type PROFILE.
3509 &quot;userTypes&quot;: [ # Output only. The user types.
3510 &quot;A String&quot;,
3511 ],
3512 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3513 },
3514 &quot;type&quot;: &quot;A String&quot;, # The source type.
3515 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3516 #
3517 # Last update timestamp of this source.
3518 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3519 #
3520 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3521 # source. Used for web cache validation.
3522 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3523 },
3524 },
3525 },
3526 ],
3527 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
3528 { # A person&#x27;s phone number.
3529 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
3530 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
3531 # form of the phone number.
3532 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
3533 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
3534 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
3535 # predefined values:
3536 #
3537 # * `home`
3538 # * `work`
3539 # * `mobile`
3540 # * `homeFax`
3541 # * `workFax`
3542 # * `otherFax`
3543 # * `pager`
3544 # * `workMobile`
3545 # * `workPager`
3546 # * `main`
3547 # * `googleVoice`
3548 # * `other`
3549 &quot;value&quot;: &quot;A String&quot;, # The phone number.
3550 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
3551 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3552 # verified field is typically a name, email address, phone number, or
3553 # website that has been confirmed to be owned by the person.
3554 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3555 # field.
3556 &quot;source&quot;: { # The source of a field. # The source of the field.
3557 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3558 #
3559 # Metadata about a source of type PROFILE.
3560 &quot;userTypes&quot;: [ # Output only. The user types.
3561 &quot;A String&quot;,
3562 ],
3563 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3564 },
3565 &quot;type&quot;: &quot;A String&quot;, # The source type.
3566 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3567 #
3568 # Last update timestamp of this source.
3569 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3570 #
3571 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3572 # source. Used for web cache validation.
3573 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3574 },
3575 },
3576 },
3577 ],
3578 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
3579 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
3580 # communications to make voice or video calls over the internet.
3581 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
3582 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
3583 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
3584 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
3585 # format.
3586 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
3587 # predefined values:
3588 #
3589 # * `home`
3590 # * `work`
3591 # * `mobile`
3592 # * `other`
3593 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
3594 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3595 # verified field is typically a name, email address, phone number, or
3596 # website that has been confirmed to be owned by the person.
3597 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3598 # field.
3599 &quot;source&quot;: { # The source of a field. # The source of the field.
3600 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3601 #
3602 # Metadata about a source of type PROFILE.
3603 &quot;userTypes&quot;: [ # Output only. The user types.
3604 &quot;A String&quot;,
3605 ],
3606 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3607 },
3608 &quot;type&quot;: &quot;A String&quot;, # The source type.
3609 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3610 #
3611 # Last update timestamp of this source.
3612 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3613 #
3614 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3615 # source. Used for web cache validation.
3616 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3617 },
3618 },
3619 },
3620 ],
3621 &quot;interests&quot;: [ # The person&#x27;s interests.
3622 { # One of the person&#x27;s interests.
3623 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
3624 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3625 # verified field is typically a name, email address, phone number, or
3626 # website that has been confirmed to be owned by the person.
3627 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3628 # field.
3629 &quot;source&quot;: { # The source of a field. # The source of the field.
3630 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3631 #
3632 # Metadata about a source of type PROFILE.
3633 &quot;userTypes&quot;: [ # Output only. The user types.
3634 &quot;A String&quot;,
3635 ],
3636 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3637 },
3638 &quot;type&quot;: &quot;A String&quot;, # The source type.
3639 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3640 #
3641 # Last update timestamp of this source.
3642 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3643 #
3644 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3645 # source. Used for web cache validation.
3646 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3647 },
3648 },
3649 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
3650 },
3651 ],
3652 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
3653 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
3654 # specified. The `date` and `text` fields typically represent the same
3655 # date, but are not guaranteed to.
3656 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
3657 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3658 # verified field is typically a name, email address, phone number, or
3659 # website that has been confirmed to be owned by the person.
3660 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3661 # field.
3662 &quot;source&quot;: { # The source of a field. # The source of the field.
3663 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3664 #
3665 # Metadata about a source of type PROFILE.
3666 &quot;userTypes&quot;: [ # Output only. The user types.
3667 &quot;A String&quot;,
3668 ],
3669 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3670 },
3671 &quot;type&quot;: &quot;A String&quot;, # The source type.
3672 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3673 #
3674 # Last update timestamp of this source.
3675 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3676 #
3677 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3678 # source. Used for web cache validation.
3679 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3680 },
3681 },
3682 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
3683 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
3684 # and time zone are either specified elsewhere or are not significant. The date
3685 # is relative to the Proleptic Gregorian Calendar. This can represent:
3686 #
3687 # * A full date, with non-zero year, month and day values
3688 # * A month and day value, with a zero year, e.g. an anniversary
3689 # * A year on its own, with zero month and day values
3690 # * A year and month value, with a zero day, e.g. a credit card expiration date
3691 #
3692 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
3693 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
3694 # if specifying a year by itself or a year and month where the day is not
3695 # significant.
3696 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
3697 # month and day.
3698 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
3699 # a year.
3700 },
3701 },
3702 ],
3703 &quot;genders&quot;: [ # The person&#x27;s genders.
3704 { # A person&#x27;s gender.
3705 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
3706 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
3707 # value are not localized.
3708 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
3709 # can be custom or one of these predefined values:
3710 #
3711 # * `male`
3712 # * `female`
3713 # * `other`
3714 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
3715 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3716 # verified field is typically a name, email address, phone number, or
3717 # website that has been confirmed to be owned by the person.
3718 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3719 # field.
3720 &quot;source&quot;: { # The source of a field. # The source of the field.
3721 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3722 #
3723 # Metadata about a source of type PROFILE.
3724 &quot;userTypes&quot;: [ # Output only. The user types.
3725 &quot;A String&quot;,
3726 ],
3727 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3728 },
3729 &quot;type&quot;: &quot;A String&quot;, # The source type.
3730 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3731 #
3732 # Last update timestamp of this source.
3733 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3734 #
3735 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3736 # source. Used for web cache validation.
3737 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3738 },
3739 },
3740 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
3741 # predefined values:
3742 #
3743 # * `male`
3744 # * `female`
3745 # * `unspecified`
3746 },
3747 ],
3748 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
3749 { # A person&#x27;s nickname.
3750 &quot;value&quot;: &quot;A String&quot;, # The nickname.
3751 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
3752 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3753 # verified field is typically a name, email address, phone number, or
3754 # website that has been confirmed to be owned by the person.
3755 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3756 # field.
3757 &quot;source&quot;: { # The source of a field. # The source of the field.
3758 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3759 #
3760 # Metadata about a source of type PROFILE.
3761 &quot;userTypes&quot;: [ # Output only. The user types.
3762 &quot;A String&quot;,
3763 ],
3764 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3765 },
3766 &quot;type&quot;: &quot;A String&quot;, # The source type.
3767 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3768 #
3769 # Last update timestamp of this source.
3770 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3771 #
3772 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3773 # source. Used for web cache validation.
3774 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3775 },
3776 },
3777 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
3778 },
3779 ],
3780 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
3781 # The person&#x27;s relationship statuses.
3782 { # **DEPRECATED**: No data will be returned
3783 # A person&#x27;s relationship status.
3784 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
3785 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3786 # verified field is typically a name, email address, phone number, or
3787 # website that has been confirmed to be owned by the person.
3788 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3789 # field.
3790 &quot;source&quot;: { # The source of a field. # The source of the field.
3791 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3792 #
3793 # Metadata about a source of type PROFILE.
3794 &quot;userTypes&quot;: [ # Output only. The user types.
3795 &quot;A String&quot;,
3796 ],
3797 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3798 },
3799 &quot;type&quot;: &quot;A String&quot;, # The source type.
3800 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3801 #
3802 # Last update timestamp of this source.
3803 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
3804 #
3805 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3806 # source. Used for web cache validation.
3807 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
3808 },
3809 },
3810 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
3811 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
3812 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
3813 # predefined values:
3814 #
3815 # * `single`
3816 # * `inARelationship`
3817 # * `engaged`
3818 # * `married`
3819 # * `itsComplicated`
3820 # * `openRelationship`
3821 # * `widowed`
3822 # * `inDomesticPartnership`
3823 # * `inCivilUnion`
3824 },
3825 ],
3826 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
3827 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
3828 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07003829 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003830 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
3831 # `person.metadata.sources.profileMetadata.objectType` instead)
3832 #
3833 # The type of the person object.
3834 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
3835 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
3836 # that include a sync token.
3837 #
3838 # The resource name may change when adding or removing fields that link a
3839 # contact and profile such as a verified email, verified phone number, or
3840 # profile URL.
3841 &quot;A String&quot;,
3842 ],
3843 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
3844 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
3845 # that include a sync token.
3846 &quot;sources&quot;: [ # The sources of data for the person.
3847 { # The source of a field.
3848 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07003849 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003850 # Metadata about a source of type PROFILE.
3851 &quot;userTypes&quot;: [ # Output only. The user types.
3852 &quot;A String&quot;,
3853 ],
3854 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3855 },
3856 &quot;type&quot;: &quot;A String&quot;, # The source type.
3857 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07003858 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003859 # Last update timestamp of this source.
3860 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07003861 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003862 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3863 # source. Used for web cache validation.
3864 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07003865 },
3866 ],
3867 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003868 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003869 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003870</div>
3871
3872<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -07003873 <code class="details" id="get">get(resourceName, requestMask_includeField=None, personFields=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -07003874 <pre>Provides information about a person by specifying a resource name. Use
3875`people/me` to indicate the authenticated user.
3876
Bu Sun Kim65020912020-05-20 12:08:20 -07003877The request throws a 400 error if &#x27;personFields&#x27; is not specified.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003878
3879Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07003880 resourceName: string, Required. The resource name of the person to provide information about.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003881
3882- To get information about the authenticated user, specify `people/me`.
3883- To get information about a google account, specify
Dan O'Mearadd494642020-05-01 07:42:23 -07003884 `people/{account_id}`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003885- To get information about a contact, specify the resource name that
3886 identifies the contact as returned by
Dan O'Mearadd494642020-05-01 07:42:23 -07003887[`people.connections.list`](/people/api/rest/v1/people.connections/list). (required)
Dan O'Mearadd494642020-05-01 07:42:23 -07003888 requestMask_includeField: string, Required. Comma-separated list of person fields to be included in the response. Each
3889path should start with `person.`: for example, `person.names` or
3890`person.photos`.
3891 personFields: string, Required. A field mask to restrict which fields on the person are returned. Multiple
3892fields can be specified by separating them with commas. Valid values are:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003893
3894* addresses
3895* ageRanges
3896* biographies
3897* birthdays
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003898* coverPhotos
3899* emailAddresses
3900* events
3901* genders
3902* imClients
3903* interests
3904* locales
3905* memberships
3906* metadata
3907* names
3908* nicknames
3909* occupations
3910* organizations
3911* phoneNumbers
3912* photos
3913* relations
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003914* residences
3915* sipAddresses
3916* skills
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003917* urls
3918* userDefined
Bu Sun Kim65020912020-05-20 12:08:20 -07003919 x__xgafv: string, V1 error format.
3920 Allowed values
3921 1 - v1 error format
3922 2 - v2 error format
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -08003923
3924Returns:
3925 An object of the form:
3926
Dan O'Mearadd494642020-05-01 07:42:23 -07003927 { # Information about a person merged from various data sources such as the
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003928 # authenticated user&#x27;s contacts and profile data.
3929 #
3930 # Most fields can have multiple items. The items in a field have no guaranteed
3931 # order, but each non-empty field is guaranteed to have exactly one field with
3932 # `metadata.primary` set to true.
3933 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
3934 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
3935 # are optional.
3936 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
3937 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
3938 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
3939 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
3940 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
3941 # account locale or the `Accept-Language` HTTP header locale.
3942 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
3943 # code of the address.
3944 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
3945 # values:
Dan O'Mearadd494642020-05-01 07:42:23 -07003946 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003947 # * `home`
3948 # * `work`
3949 # * `other`
3950 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
3951 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
3952 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
3953 # verified field is typically a name, email address, phone number, or
3954 # website that has been confirmed to be owned by the person.
3955 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
3956 # field.
3957 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07003958 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
3959 #
3960 # Metadata about a source of type PROFILE.
3961 &quot;userTypes&quot;: [ # Output only. The user types.
3962 &quot;A String&quot;,
3963 ],
3964 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
3965 },
3966 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003967 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
3968 #
3969 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07003970 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003971 #
3972 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
3973 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003974 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003975 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003976 },
3977 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
3978 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
3979 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
3980 # will be automatically constructed from structured values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003981 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07003982 ],
3983 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
3984 #
3985 # The person&#x27;s age range.
3986 &quot;relations&quot;: [ # The person&#x27;s relations.
3987 { # A person&#x27;s relation to another person.
3988 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
3989 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
3990 # account locale or the locale specified in the Accept-Language HTTP header.
3991 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
3992 # these predefined values:
3993 #
3994 # * `spouse`
3995 # * `child`
3996 # * `mother`
3997 # * `father`
3998 # * `parent`
3999 # * `brother`
4000 # * `sister`
4001 # * `friend`
4002 # * `relative`
4003 # * `domesticPartner`
4004 # * `manager`
4005 # * `assistant`
4006 # * `referredBy`
4007 # * `partner`
4008 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
4009 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4010 # verified field is typically a name, email address, phone number, or
4011 # website that has been confirmed to be owned by the person.
4012 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4013 # field.
4014 &quot;source&quot;: { # The source of a field. # The source of the field.
4015 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4016 #
4017 # Metadata about a source of type PROFILE.
4018 &quot;userTypes&quot;: [ # Output only. The user types.
4019 &quot;A String&quot;,
4020 ],
4021 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07004022 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07004023 &quot;type&quot;: &quot;A String&quot;, # The source type.
4024 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4025 #
4026 # Last update timestamp of this source.
4027 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4028 #
4029 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4030 # source. Used for web cache validation.
4031 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07004032 },
4033 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07004034 },
4035 ],
4036 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
4037 { # A person&#x27;s past or current organization. Overlapping date ranges are
4038 # permitted.
4039 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
4040 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4041 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
4042 # false if the organization is a past organization.
4043 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
4044 # symbol, abbreviation, or acronym.
4045 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
4046 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
4047 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
4048 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4049 # verified field is typically a name, email address, phone number, or
4050 # website that has been confirmed to be owned by the person.
4051 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4052 # field.
4053 &quot;source&quot;: { # The source of a field. # The source of the field.
4054 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4055 #
4056 # Metadata about a source of type PROFILE.
4057 &quot;userTypes&quot;: [ # Output only. The user types.
4058 &quot;A String&quot;,
4059 ],
4060 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4061 },
4062 &quot;type&quot;: &quot;A String&quot;, # The source type.
4063 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4064 #
4065 # Last update timestamp of this source.
4066 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4067 #
4068 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4069 # source. Used for web cache validation.
4070 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4071 },
4072 },
4073 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
4074 # predefined values:
4075 #
4076 # * `work`
4077 # * `school`
4078 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
4079 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
4080 # and time zone are either specified elsewhere or are not significant. The date
4081 # is relative to the Proleptic Gregorian Calendar. This can represent:
4082 #
4083 # * A full date, with non-zero year, month and day values
4084 # * A month and day value, with a zero year, e.g. an anniversary
4085 # * A year on its own, with zero month and day values
4086 # * A year and month value, with a zero day, e.g. a credit card expiration date
4087 #
4088 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4089 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4090 # if specifying a year by itself or a year and month where the day is not
4091 # significant.
4092 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4093 # month and day.
4094 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4095 # a year.
4096 },
4097 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
4098 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
4099 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
4100 # `google.com`.
4101 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
4102 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
4103 # and time zone are either specified elsewhere or are not significant. The date
4104 # is relative to the Proleptic Gregorian Calendar. This can represent:
4105 #
4106 # * A full date, with non-zero year, month and day values
4107 # * A month and day value, with a zero year, e.g. an anniversary
4108 # * A year on its own, with zero month and day values
4109 # * A year and month value, with a zero day, e.g. a credit card expiration date
4110 #
4111 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4112 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4113 # if specifying a year by itself or a year and month where the day is not
4114 # significant.
4115 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4116 # month and day.
4117 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4118 # a year.
4119 },
4120 },
4121 ],
4122 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
4123 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
4124 # profile page that represents who they are or what they care about.
4125 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
4126 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4127 # verified field is typically a name, email address, phone number, or
4128 # website that has been confirmed to be owned by the person.
4129 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4130 # field.
4131 &quot;source&quot;: { # The source of a field. # The source of the field.
4132 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4133 #
4134 # Metadata about a source of type PROFILE.
4135 &quot;userTypes&quot;: [ # Output only. The user types.
4136 &quot;A String&quot;,
4137 ],
4138 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4139 },
4140 &quot;type&quot;: &quot;A String&quot;, # The source type.
4141 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4142 #
4143 # Last update timestamp of this source.
4144 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4145 #
4146 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4147 # source. Used for web cache validation.
4148 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4149 },
4150 },
4151 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
4152 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
4153 # false if the cover photo is a user-provided cover photo.
4154 },
4155 ],
4156 &quot;residences&quot;: [ # The person&#x27;s residences.
4157 { # A person&#x27;s past or current residence.
4158 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
4159 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
4160 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4161 # verified field is typically a name, email address, phone number, or
4162 # website that has been confirmed to be owned by the person.
4163 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4164 # field.
4165 &quot;source&quot;: { # The source of a field. # The source of the field.
4166 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4167 #
4168 # Metadata about a source of type PROFILE.
4169 &quot;userTypes&quot;: [ # Output only. The user types.
4170 &quot;A String&quot;,
4171 ],
4172 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4173 },
4174 &quot;type&quot;: &quot;A String&quot;, # The source type.
4175 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4176 #
4177 # Last update timestamp of this source.
4178 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4179 #
4180 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4181 # source. Used for web cache validation.
4182 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4183 },
4184 },
4185 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
4186 # false if the residence is a past residence.
4187 },
4188 ],
4189 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
4190 { # A person&#x27;s instant messaging client.
4191 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
4192 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
4193 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4194 # verified field is typically a name, email address, phone number, or
4195 # website that has been confirmed to be owned by the person.
4196 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4197 # field.
4198 &quot;source&quot;: { # The source of a field. # The source of the field.
4199 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4200 #
4201 # Metadata about a source of type PROFILE.
4202 &quot;userTypes&quot;: [ # Output only. The user types.
4203 &quot;A String&quot;,
4204 ],
4205 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4206 },
4207 &quot;type&quot;: &quot;A String&quot;, # The source type.
4208 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4209 #
4210 # Last update timestamp of this source.
4211 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4212 #
4213 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4214 # source. Used for web cache validation.
4215 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4216 },
4217 },
4218 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
4219 # predefined values:
4220 #
4221 # * `home`
4222 # * `work`
4223 # * `other`
4224 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
4225 # predefined values:
4226 #
4227 # * `aim`
4228 # * `msn`
4229 # * `yahoo`
4230 # * `skype`
4231 # * `qq`
4232 # * `googleTalk`
4233 # * `icq`
4234 # * `jabber`
4235 # * `netMeeting`
4236 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
4237 # locale or the `Accept-Language` HTTP header locale.
4238 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
4239 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4240 },
4241 ],
4242 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
4243 { # Arbitrary user data that is populated by the end users.
4244 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
4245 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4246 # verified field is typically a name, email address, phone number, or
4247 # website that has been confirmed to be owned by the person.
4248 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4249 # field.
4250 &quot;source&quot;: { # The source of a field. # The source of the field.
4251 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4252 #
4253 # Metadata about a source of type PROFILE.
4254 &quot;userTypes&quot;: [ # Output only. The user types.
4255 &quot;A String&quot;,
4256 ],
4257 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4258 },
4259 &quot;type&quot;: &quot;A String&quot;, # The source type.
4260 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4261 #
4262 # Last update timestamp of this source.
4263 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4264 #
4265 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4266 # source. Used for web cache validation.
4267 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4268 },
4269 },
4270 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
4271 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
4272 },
4273 ],
4274 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4275 # resource. Used for web cache validation.
4276 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
4277 # The person&#x27;s bragging rights.
4278 { # **DEPRECATED**: No data will be returned
4279 # A person&#x27;s bragging rights.
4280 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
4281 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
4282 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4283 # verified field is typically a name, email address, phone number, or
4284 # website that has been confirmed to be owned by the person.
4285 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4286 # field.
4287 &quot;source&quot;: { # The source of a field. # The source of the field.
4288 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4289 #
4290 # Metadata about a source of type PROFILE.
4291 &quot;userTypes&quot;: [ # Output only. The user types.
4292 &quot;A String&quot;,
4293 ],
4294 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4295 },
4296 &quot;type&quot;: &quot;A String&quot;, # The source type.
4297 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4298 #
4299 # Last update timestamp of this source.
4300 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4301 #
4302 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4303 # source. Used for web cache validation.
4304 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4305 },
4306 },
4307 },
4308 ],
4309 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
4310 # The person&#x27;s relationship interests.
4311 { # **DEPRECATED**: No data will be returned
4312 # A person&#x27;s relationship interest .
4313 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
4314 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4315 # verified field is typically a name, email address, phone number, or
4316 # website that has been confirmed to be owned by the person.
4317 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4318 # field.
4319 &quot;source&quot;: { # The source of a field. # The source of the field.
4320 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4321 #
4322 # Metadata about a source of type PROFILE.
4323 &quot;userTypes&quot;: [ # Output only. The user types.
4324 &quot;A String&quot;,
4325 ],
4326 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4327 },
4328 &quot;type&quot;: &quot;A String&quot;, # The source type.
4329 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4330 #
4331 # Last update timestamp of this source.
4332 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4333 #
4334 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4335 # source. Used for web cache validation.
4336 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4337 },
4338 },
4339 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
4340 # in the viewer&#x27;s account locale or the locale specified in the
4341 # Accept-Language HTTP header.
4342 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
4343 # or one of these predefined values:
4344 #
4345 # * `friend`
4346 # * `date`
4347 # * `relationship`
4348 # * `networking`
4349 },
4350 ],
4351 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
4352 { # A person&#x27;s age range.
4353 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
4354 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4355 # verified field is typically a name, email address, phone number, or
4356 # website that has been confirmed to be owned by the person.
4357 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4358 # field.
4359 &quot;source&quot;: { # The source of a field. # The source of the field.
4360 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4361 #
4362 # Metadata about a source of type PROFILE.
4363 &quot;userTypes&quot;: [ # Output only. The user types.
4364 &quot;A String&quot;,
4365 ],
4366 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4367 },
4368 &quot;type&quot;: &quot;A String&quot;, # The source type.
4369 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4370 #
4371 # Last update timestamp of this source.
4372 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4373 #
4374 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4375 # source. Used for web cache validation.
4376 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4377 },
4378 },
4379 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
4380 },
4381 ],
4382 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
4383 { # A person&#x27;s membership in a group. Only contact group memberships can be
4384 # modified.
4385 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
4386 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4387 # verified field is typically a name, email address, phone number, or
4388 # website that has been confirmed to be owned by the person.
4389 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4390 # field.
4391 &quot;source&quot;: { # The source of a field. # The source of the field.
4392 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4393 #
4394 # Metadata about a source of type PROFILE.
4395 &quot;userTypes&quot;: [ # Output only. The user types.
4396 &quot;A String&quot;,
4397 ],
4398 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4399 },
4400 &quot;type&quot;: &quot;A String&quot;, # The source type.
4401 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4402 #
4403 # Last update timestamp of this source.
4404 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4405 #
4406 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4407 # source. Used for web cache validation.
4408 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4409 },
4410 },
4411 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
4412 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
4413 # string, in the form of `contactGroups/{contact_group_id}`.
4414 # Only contact_group_resource_name can be used for modifying memberships.
4415 # Any contact group membership can be removed, but only user group or
4416 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
4417 # contact must always have at least one contact group membership.
4418 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
4419 },
4420 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
4421 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
4422 },
4423 },
4424 ],
4425 &quot;occupations&quot;: [ # The person&#x27;s occupations.
4426 { # A person&#x27;s occupation.
4427 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
4428 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4429 # verified field is typically a name, email address, phone number, or
4430 # website that has been confirmed to be owned by the person.
4431 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4432 # field.
4433 &quot;source&quot;: { # The source of a field. # The source of the field.
4434 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4435 #
4436 # Metadata about a source of type PROFILE.
4437 &quot;userTypes&quot;: [ # Output only. The user types.
4438 &quot;A String&quot;,
4439 ],
4440 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4441 },
4442 &quot;type&quot;: &quot;A String&quot;, # The source type.
4443 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4444 #
4445 # Last update timestamp of this source.
4446 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4447 #
4448 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4449 # source. Used for web cache validation.
4450 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4451 },
4452 },
4453 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
4454 },
4455 ],
4456 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
4457 { # A person&#x27;s associated URLs.
4458 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
4459 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4460 # verified field is typically a name, email address, phone number, or
4461 # website that has been confirmed to be owned by the person.
4462 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4463 # field.
4464 &quot;source&quot;: { # The source of a field. # The source of the field.
4465 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4466 #
4467 # Metadata about a source of type PROFILE.
4468 &quot;userTypes&quot;: [ # Output only. The user types.
4469 &quot;A String&quot;,
4470 ],
4471 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4472 },
4473 &quot;type&quot;: &quot;A String&quot;, # The source type.
4474 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4475 #
4476 # Last update timestamp of this source.
4477 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4478 #
4479 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4480 # source. Used for web cache validation.
4481 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4482 },
4483 },
4484 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
4485 # values:
4486 #
4487 # * `home`
4488 # * `work`
4489 # * `blog`
4490 # * `profile`
4491 # * `homePage`
4492 # * `ftp`
4493 # * `reservations`
4494 # * `appInstallPage`: website for a Google+ application.
4495 # * `other`
4496 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
4497 # account locale or the `Accept-Language` HTTP header locale.
4498 &quot;value&quot;: &quot;A String&quot;, # The URL.
4499 },
4500 ],
4501 &quot;skills&quot;: [ # The person&#x27;s skills.
4502 { # A skill that the person has.
4503 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
4504 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4505 # verified field is typically a name, email address, phone number, or
4506 # website that has been confirmed to be owned by the person.
4507 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4508 # field.
4509 &quot;source&quot;: { # The source of a field. # The source of the field.
4510 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4511 #
4512 # Metadata about a source of type PROFILE.
4513 &quot;userTypes&quot;: [ # Output only. The user types.
4514 &quot;A String&quot;,
4515 ],
4516 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4517 },
4518 &quot;type&quot;: &quot;A String&quot;, # The source type.
4519 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4520 #
4521 # Last update timestamp of this source.
4522 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4523 #
4524 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4525 # source. Used for web cache validation.
4526 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4527 },
4528 },
4529 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
4530 },
4531 ],
4532 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
4533 { # A person&#x27;s email address.
4534 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
4535 # predefined values:
4536 #
4537 # * `home`
4538 # * `work`
4539 # * `other`
4540 &quot;value&quot;: &quot;A String&quot;, # The email address.
4541 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
4542 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
4543 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4544 # verified field is typically a name, email address, phone number, or
4545 # website that has been confirmed to be owned by the person.
4546 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4547 # field.
4548 &quot;source&quot;: { # The source of a field. # The source of the field.
4549 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4550 #
4551 # Metadata about a source of type PROFILE.
4552 &quot;userTypes&quot;: [ # Output only. The user types.
4553 &quot;A String&quot;,
4554 ],
4555 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4556 },
4557 &quot;type&quot;: &quot;A String&quot;, # The source type.
4558 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4559 #
4560 # Last update timestamp of this source.
4561 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4562 #
4563 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4564 # source. Used for web cache validation.
4565 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4566 },
4567 },
4568 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
4569 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4570 },
4571 ],
4572 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
4573 # The person&#x27;s taglines.
4574 { # **DEPRECATED**: No data will be returned
4575 # A brief one-line description of the person.
4576 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
4577 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4578 # verified field is typically a name, email address, phone number, or
4579 # website that has been confirmed to be owned by the person.
4580 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4581 # field.
4582 &quot;source&quot;: { # The source of a field. # The source of the field.
4583 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4584 #
4585 # Metadata about a source of type PROFILE.
4586 &quot;userTypes&quot;: [ # Output only. The user types.
4587 &quot;A String&quot;,
4588 ],
4589 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4590 },
4591 &quot;type&quot;: &quot;A String&quot;, # The source type.
4592 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4593 #
4594 # Last update timestamp of this source.
4595 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4596 #
4597 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4598 # source. Used for web cache validation.
4599 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4600 },
4601 },
4602 &quot;value&quot;: &quot;A String&quot;, # The tagline.
4603 },
4604 ],
4605 &quot;names&quot;: [ # The person&#x27;s names.
4606 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
4607 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
4608 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
4609 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
4610 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
4611 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
4612 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
4613 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
4614 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
4615 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
4616 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
4617 # the locale specified by the viewer&#x27;s account or the
4618 # `Accept-Language` HTTP header.
4619 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
4620 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
4621 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
4622 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
4623 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4624 # verified field is typically a name, email address, phone number, or
4625 # website that has been confirmed to be owned by the person.
4626 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4627 # field.
4628 &quot;source&quot;: { # The source of a field. # The source of the field.
4629 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4630 #
4631 # Metadata about a source of type PROFILE.
4632 &quot;userTypes&quot;: [ # Output only. The user types.
4633 &quot;A String&quot;,
4634 ],
4635 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4636 },
4637 &quot;type&quot;: &quot;A String&quot;, # The source type.
4638 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4639 #
4640 # Last update timestamp of this source.
4641 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4642 #
4643 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4644 # source. Used for web cache validation.
4645 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4646 },
4647 },
4648 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
4649 },
4650 ],
4651 &quot;biographies&quot;: [ # The person&#x27;s biographies.
4652 { # A person&#x27;s short biography.
4653 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
4654 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4655 # verified field is typically a name, email address, phone number, or
4656 # website that has been confirmed to be owned by the person.
4657 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4658 # field.
4659 &quot;source&quot;: { # The source of a field. # The source of the field.
4660 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4661 #
4662 # Metadata about a source of type PROFILE.
4663 &quot;userTypes&quot;: [ # Output only. The user types.
4664 &quot;A String&quot;,
4665 ],
4666 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4667 },
4668 &quot;type&quot;: &quot;A String&quot;, # The source type.
4669 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4670 #
4671 # Last update timestamp of this source.
4672 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4673 #
4674 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4675 # source. Used for web cache validation.
4676 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4677 },
4678 },
4679 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
4680 &quot;value&quot;: &quot;A String&quot;, # The short biography.
4681 },
4682 ],
4683 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
4684 # with a max length of 27 characters, in the form of
4685 # `people/{person_id}`.
4686 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
4687 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
4688 # help others recognize the person.
4689 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
4690 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4691 # verified field is typically a name, email address, phone number, or
4692 # website that has been confirmed to be owned by the person.
4693 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4694 # field.
4695 &quot;source&quot;: { # The source of a field. # The source of the field.
4696 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4697 #
4698 # Metadata about a source of type PROFILE.
4699 &quot;userTypes&quot;: [ # Output only. The user types.
4700 &quot;A String&quot;,
4701 ],
4702 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4703 },
4704 &quot;type&quot;: &quot;A String&quot;, # The source type.
4705 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4706 #
4707 # Last update timestamp of this source.
4708 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4709 #
4710 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4711 # source. Used for web cache validation.
4712 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4713 },
4714 },
4715 &quot;default&quot;: True or False, # True if the photo is a default photo;
4716 # false if the photo is a user-provided photo.
4717 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
4718 # parameter `sz={size}` at the end of the url, where {size} is the size in
4719 # pixels. Example:
4720 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
4721 },
4722 ],
4723 &quot;events&quot;: [ # The person&#x27;s events.
4724 { # An event related to the person.
4725 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
4726 # values:
4727 #
4728 # * `anniversary`
4729 # * `other`
4730 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
4731 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4732 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
4733 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4734 # verified field is typically a name, email address, phone number, or
4735 # website that has been confirmed to be owned by the person.
4736 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4737 # field.
4738 &quot;source&quot;: { # The source of a field. # The source of the field.
4739 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4740 #
4741 # Metadata about a source of type PROFILE.
4742 &quot;userTypes&quot;: [ # Output only. The user types.
4743 &quot;A String&quot;,
4744 ],
4745 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4746 },
4747 &quot;type&quot;: &quot;A String&quot;, # The source type.
4748 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4749 #
4750 # Last update timestamp of this source.
4751 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4752 #
4753 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4754 # source. Used for web cache validation.
4755 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4756 },
4757 },
4758 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
4759 # and time zone are either specified elsewhere or are not significant. The date
4760 # is relative to the Proleptic Gregorian Calendar. This can represent:
4761 #
4762 # * A full date, with non-zero year, month and day values
4763 # * A month and day value, with a zero year, e.g. an anniversary
4764 # * A year on its own, with zero month and day values
4765 # * A year and month value, with a zero day, e.g. a credit card expiration date
4766 #
4767 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4768 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4769 # if specifying a year by itself or a year and month where the day is not
4770 # significant.
4771 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4772 # month and day.
4773 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4774 # a year.
4775 },
4776 },
4777 ],
4778 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
4779 { # A person&#x27;s locale preference.
4780 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
4781 # language tag representing the locale.
4782 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
4783 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4784 # verified field is typically a name, email address, phone number, or
4785 # website that has been confirmed to be owned by the person.
4786 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4787 # field.
4788 &quot;source&quot;: { # The source of a field. # The source of the field.
4789 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4790 #
4791 # Metadata about a source of type PROFILE.
4792 &quot;userTypes&quot;: [ # Output only. The user types.
4793 &quot;A String&quot;,
4794 ],
4795 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4796 },
4797 &quot;type&quot;: &quot;A String&quot;, # The source type.
4798 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4799 #
4800 # Last update timestamp of this source.
4801 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4802 #
4803 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4804 # source. Used for web cache validation.
4805 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4806 },
4807 },
4808 },
4809 ],
4810 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
4811 { # A person&#x27;s phone number.
4812 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
4813 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
4814 # form of the phone number.
4815 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
4816 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4817 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
4818 # predefined values:
4819 #
4820 # * `home`
4821 # * `work`
4822 # * `mobile`
4823 # * `homeFax`
4824 # * `workFax`
4825 # * `otherFax`
4826 # * `pager`
4827 # * `workMobile`
4828 # * `workPager`
4829 # * `main`
4830 # * `googleVoice`
4831 # * `other`
4832 &quot;value&quot;: &quot;A String&quot;, # The phone number.
4833 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
4834 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4835 # verified field is typically a name, email address, phone number, or
4836 # website that has been confirmed to be owned by the person.
4837 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4838 # field.
4839 &quot;source&quot;: { # The source of a field. # The source of the field.
4840 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4841 #
4842 # Metadata about a source of type PROFILE.
4843 &quot;userTypes&quot;: [ # Output only. The user types.
4844 &quot;A String&quot;,
4845 ],
4846 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4847 },
4848 &quot;type&quot;: &quot;A String&quot;, # The source type.
4849 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4850 #
4851 # Last update timestamp of this source.
4852 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4853 #
4854 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4855 # source. Used for web cache validation.
4856 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4857 },
4858 },
4859 },
4860 ],
4861 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
4862 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
4863 # communications to make voice or video calls over the internet.
4864 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
4865 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
4866 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
4867 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
4868 # format.
4869 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
4870 # predefined values:
4871 #
4872 # * `home`
4873 # * `work`
4874 # * `mobile`
4875 # * `other`
4876 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
4877 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4878 # verified field is typically a name, email address, phone number, or
4879 # website that has been confirmed to be owned by the person.
4880 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4881 # field.
4882 &quot;source&quot;: { # The source of a field. # The source of the field.
4883 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4884 #
4885 # Metadata about a source of type PROFILE.
4886 &quot;userTypes&quot;: [ # Output only. The user types.
4887 &quot;A String&quot;,
4888 ],
4889 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4890 },
4891 &quot;type&quot;: &quot;A String&quot;, # The source type.
4892 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4893 #
4894 # Last update timestamp of this source.
4895 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4896 #
4897 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4898 # source. Used for web cache validation.
4899 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4900 },
4901 },
4902 },
4903 ],
4904 &quot;interests&quot;: [ # The person&#x27;s interests.
4905 { # One of the person&#x27;s interests.
4906 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
4907 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4908 # verified field is typically a name, email address, phone number, or
4909 # website that has been confirmed to be owned by the person.
4910 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4911 # field.
4912 &quot;source&quot;: { # The source of a field. # The source of the field.
4913 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4914 #
4915 # Metadata about a source of type PROFILE.
4916 &quot;userTypes&quot;: [ # Output only. The user types.
4917 &quot;A String&quot;,
4918 ],
4919 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4920 },
4921 &quot;type&quot;: &quot;A String&quot;, # The source type.
4922 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4923 #
4924 # Last update timestamp of this source.
4925 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4926 #
4927 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4928 # source. Used for web cache validation.
4929 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4930 },
4931 },
4932 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
4933 },
4934 ],
4935 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
4936 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
4937 # specified. The `date` and `text` fields typically represent the same
4938 # date, but are not guaranteed to.
4939 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
4940 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4941 # verified field is typically a name, email address, phone number, or
4942 # website that has been confirmed to be owned by the person.
4943 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
4944 # field.
4945 &quot;source&quot;: { # The source of a field. # The source of the field.
4946 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
4947 #
4948 # Metadata about a source of type PROFILE.
4949 &quot;userTypes&quot;: [ # Output only. The user types.
4950 &quot;A String&quot;,
4951 ],
4952 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
4953 },
4954 &quot;type&quot;: &quot;A String&quot;, # The source type.
4955 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
4956 #
4957 # Last update timestamp of this source.
4958 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
4959 #
4960 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
4961 # source. Used for web cache validation.
4962 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
4963 },
4964 },
4965 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
4966 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
4967 # and time zone are either specified elsewhere or are not significant. The date
4968 # is relative to the Proleptic Gregorian Calendar. This can represent:
4969 #
4970 # * A full date, with non-zero year, month and day values
4971 # * A month and day value, with a zero year, e.g. an anniversary
4972 # * A year on its own, with zero month and day values
4973 # * A year and month value, with a zero day, e.g. a credit card expiration date
4974 #
4975 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
4976 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
4977 # if specifying a year by itself or a year and month where the day is not
4978 # significant.
4979 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
4980 # month and day.
4981 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
4982 # a year.
4983 },
4984 },
4985 ],
4986 &quot;genders&quot;: [ # The person&#x27;s genders.
4987 { # A person&#x27;s gender.
4988 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
4989 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
4990 # value are not localized.
4991 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
4992 # can be custom or one of these predefined values:
4993 #
4994 # * `male`
4995 # * `female`
4996 # * `other`
4997 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
4998 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
4999 # verified field is typically a name, email address, phone number, or
5000 # website that has been confirmed to be owned by the person.
5001 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5002 # field.
5003 &quot;source&quot;: { # The source of a field. # The source of the field.
5004 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5005 #
5006 # Metadata about a source of type PROFILE.
5007 &quot;userTypes&quot;: [ # Output only. The user types.
5008 &quot;A String&quot;,
5009 ],
5010 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5011 },
5012 &quot;type&quot;: &quot;A String&quot;, # The source type.
5013 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5014 #
5015 # Last update timestamp of this source.
5016 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5017 #
5018 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5019 # source. Used for web cache validation.
5020 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5021 },
5022 },
5023 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
5024 # predefined values:
5025 #
5026 # * `male`
5027 # * `female`
5028 # * `unspecified`
5029 },
5030 ],
5031 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
5032 { # A person&#x27;s nickname.
5033 &quot;value&quot;: &quot;A String&quot;, # The nickname.
5034 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
5035 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5036 # verified field is typically a name, email address, phone number, or
5037 # website that has been confirmed to be owned by the person.
5038 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5039 # field.
5040 &quot;source&quot;: { # The source of a field. # The source of the field.
5041 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5042 #
5043 # Metadata about a source of type PROFILE.
5044 &quot;userTypes&quot;: [ # Output only. The user types.
5045 &quot;A String&quot;,
5046 ],
5047 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5048 },
5049 &quot;type&quot;: &quot;A String&quot;, # The source type.
5050 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5051 #
5052 # Last update timestamp of this source.
5053 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5054 #
5055 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5056 # source. Used for web cache validation.
5057 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5058 },
5059 },
5060 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
5061 },
5062 ],
5063 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
5064 # The person&#x27;s relationship statuses.
5065 { # **DEPRECATED**: No data will be returned
5066 # A person&#x27;s relationship status.
5067 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
5068 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5069 # verified field is typically a name, email address, phone number, or
5070 # website that has been confirmed to be owned by the person.
5071 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5072 # field.
5073 &quot;source&quot;: { # The source of a field. # The source of the field.
5074 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5075 #
5076 # Metadata about a source of type PROFILE.
5077 &quot;userTypes&quot;: [ # Output only. The user types.
5078 &quot;A String&quot;,
5079 ],
5080 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5081 },
5082 &quot;type&quot;: &quot;A String&quot;, # The source type.
5083 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5084 #
5085 # Last update timestamp of this source.
5086 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5087 #
5088 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5089 # source. Used for web cache validation.
5090 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5091 },
5092 },
5093 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
5094 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
5095 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
5096 # predefined values:
5097 #
5098 # * `single`
5099 # * `inARelationship`
5100 # * `engaged`
5101 # * `married`
5102 # * `itsComplicated`
5103 # * `openRelationship`
5104 # * `widowed`
5105 # * `inDomesticPartnership`
5106 # * `inCivilUnion`
5107 },
5108 ],
5109 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
5110 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
5111 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07005112 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005113 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
5114 # `person.metadata.sources.profileMetadata.objectType` instead)
5115 #
5116 # The type of the person object.
5117 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
5118 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
5119 # that include a sync token.
5120 #
5121 # The resource name may change when adding or removing fields that link a
5122 # contact and profile such as a verified email, verified phone number, or
5123 # profile URL.
5124 &quot;A String&quot;,
5125 ],
5126 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
5127 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
5128 # that include a sync token.
5129 &quot;sources&quot;: [ # The sources of data for the person.
5130 { # The source of a field.
5131 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07005132 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005133 # Metadata about a source of type PROFILE.
5134 &quot;userTypes&quot;: [ # Output only. The user types.
5135 &quot;A String&quot;,
5136 ],
5137 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5138 },
5139 &quot;type&quot;: &quot;A String&quot;, # The source type.
5140 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07005141 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005142 # Last update timestamp of this source.
5143 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07005144 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005145 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5146 # source. Used for web cache validation.
5147 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07005148 },
5149 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005150 },
5151 }</pre>
Dan O'Mearadd494642020-05-01 07:42:23 -07005152</div>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07005153
Dan O'Mearadd494642020-05-01 07:42:23 -07005154<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005155 <code class="details" id="getBatchGet">getBatchGet(personFields=None, requestMask_includeField=None, resourceNames=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -07005156 <pre>Provides information about a list of specific people by specifying a list
5157of requested resource names. Use `people/me` to indicate the authenticated
5158user.
5159
Bu Sun Kim65020912020-05-20 12:08:20 -07005160The request throws a 400 error if &#x27;personFields&#x27; is not specified.
Dan O'Mearadd494642020-05-01 07:42:23 -07005161
5162Args:
Dan O'Mearadd494642020-05-01 07:42:23 -07005163 personFields: string, Required. A field mask to restrict which fields on each person are returned. Multiple
5164fields can be specified by separating them with commas. Valid values are:
5165
5166* addresses
5167* ageRanges
5168* biographies
5169* birthdays
5170* coverPhotos
5171* emailAddresses
5172* events
5173* genders
5174* imClients
5175* interests
5176* locales
5177* memberships
5178* metadata
5179* names
5180* nicknames
5181* occupations
5182* organizations
5183* phoneNumbers
5184* photos
5185* relations
5186* residences
5187* sipAddresses
5188* skills
5189* urls
5190* userDefined
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005191 requestMask_includeField: string, Required. Comma-separated list of person fields to be included in the response. Each
5192path should start with `person.`: for example, `person.names` or
5193`person.photos`.
Bu Sun Kim65020912020-05-20 12:08:20 -07005194 resourceNames: string, Required. The resource names of the people to provide information about.
5195
5196- To get information about the authenticated user, specify `people/me`.
5197- To get information about a google account, specify
5198 `people/{account_id}`.
5199- To get information about a contact, specify the resource name that
5200 identifies the contact as returned by
5201[`people.connections.list`](/people/api/rest/v1/people.connections/list).
5202
5203You can include up to 50 resource names in one request. (repeated)
Bu Sun Kim65020912020-05-20 12:08:20 -07005204 x__xgafv: string, V1 error format.
5205 Allowed values
5206 1 - v1 error format
5207 2 - v2 error format
Dan O'Mearadd494642020-05-01 07:42:23 -07005208
5209Returns:
5210 An object of the form:
5211
5212 { # The response to a get request for a list of people by resource name.
Bu Sun Kim65020912020-05-20 12:08:20 -07005213 &quot;responses&quot;: [ # The response for each requested resource name.
Dan O'Mearadd494642020-05-01 07:42:23 -07005214 { # The response for a single person
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005215 &quot;httpStatusCode&quot;: 42, # **DEPRECATED** (Please use status instead)
5216 #
5217 # [HTTP 1.1 status code]
5218 # (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
Bu Sun Kim65020912020-05-20 12:08:20 -07005219 &quot;person&quot;: { # Information about a person merged from various data sources such as the # The person.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005220 # authenticated user&#x27;s contacts and profile data.
5221 #
5222 # Most fields can have multiple items. The items in a field have no guaranteed
5223 # order, but each non-empty field is guaranteed to have exactly one field with
5224 # `metadata.primary` set to true.
5225 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
5226 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
5227 # are optional.
5228 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
5229 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
5230 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
5231 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
5232 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
5233 # account locale or the `Accept-Language` HTTP header locale.
5234 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
5235 # code of the address.
5236 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
5237 # values:
Bu Sun Kim65020912020-05-20 12:08:20 -07005238 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005239 # * `home`
5240 # * `work`
5241 # * `other`
5242 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
5243 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
5244 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5245 # verified field is typically a name, email address, phone number, or
5246 # website that has been confirmed to be owned by the person.
5247 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5248 # field.
5249 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07005250 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5251 #
5252 # Metadata about a source of type PROFILE.
5253 &quot;userTypes&quot;: [ # Output only. The user types.
5254 &quot;A String&quot;,
5255 ],
5256 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5257 },
5258 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005259 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5260 #
5261 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07005262 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5263 #
5264 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5265 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005266 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07005267 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005268 },
5269 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
5270 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
5271 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
5272 # will be automatically constructed from structured values.
Bu Sun Kim65020912020-05-20 12:08:20 -07005273 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005274 ],
5275 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
5276 #
5277 # The person&#x27;s age range.
5278 &quot;relations&quot;: [ # The person&#x27;s relations.
5279 { # A person&#x27;s relation to another person.
5280 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
5281 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
5282 # account locale or the locale specified in the Accept-Language HTTP header.
5283 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
5284 # these predefined values:
5285 #
5286 # * `spouse`
5287 # * `child`
5288 # * `mother`
5289 # * `father`
5290 # * `parent`
5291 # * `brother`
5292 # * `sister`
5293 # * `friend`
5294 # * `relative`
5295 # * `domesticPartner`
5296 # * `manager`
5297 # * `assistant`
5298 # * `referredBy`
5299 # * `partner`
5300 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
5301 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5302 # verified field is typically a name, email address, phone number, or
5303 # website that has been confirmed to be owned by the person.
5304 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5305 # field.
5306 &quot;source&quot;: { # The source of a field. # The source of the field.
5307 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5308 #
5309 # Metadata about a source of type PROFILE.
5310 &quot;userTypes&quot;: [ # Output only. The user types.
5311 &quot;A String&quot;,
5312 ],
5313 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07005314 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005315 &quot;type&quot;: &quot;A String&quot;, # The source type.
5316 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5317 #
5318 # Last update timestamp of this source.
5319 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5320 #
5321 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5322 # source. Used for web cache validation.
5323 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07005324 },
5325 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07005326 },
5327 ],
5328 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
5329 { # A person&#x27;s past or current organization. Overlapping date ranges are
5330 # permitted.
5331 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
5332 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
5333 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
5334 # false if the organization is a past organization.
5335 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
5336 # symbol, abbreviation, or acronym.
5337 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
5338 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
5339 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
5340 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5341 # verified field is typically a name, email address, phone number, or
5342 # website that has been confirmed to be owned by the person.
5343 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5344 # field.
5345 &quot;source&quot;: { # The source of a field. # The source of the field.
5346 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5347 #
5348 # Metadata about a source of type PROFILE.
5349 &quot;userTypes&quot;: [ # Output only. The user types.
5350 &quot;A String&quot;,
5351 ],
5352 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5353 },
5354 &quot;type&quot;: &quot;A String&quot;, # The source type.
5355 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5356 #
5357 # Last update timestamp of this source.
5358 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5359 #
5360 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5361 # source. Used for web cache validation.
5362 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5363 },
5364 },
5365 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
5366 # predefined values:
5367 #
5368 # * `work`
5369 # * `school`
5370 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
5371 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
5372 # and time zone are either specified elsewhere or are not significant. The date
5373 # is relative to the Proleptic Gregorian Calendar. This can represent:
5374 #
5375 # * A full date, with non-zero year, month and day values
5376 # * A month and day value, with a zero year, e.g. an anniversary
5377 # * A year on its own, with zero month and day values
5378 # * A year and month value, with a zero day, e.g. a credit card expiration date
5379 #
5380 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
5381 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
5382 # if specifying a year by itself or a year and month where the day is not
5383 # significant.
5384 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5385 # month and day.
5386 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
5387 # a year.
5388 },
5389 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
5390 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
5391 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
5392 # `google.com`.
5393 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
5394 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
5395 # and time zone are either specified elsewhere or are not significant. The date
5396 # is relative to the Proleptic Gregorian Calendar. This can represent:
5397 #
5398 # * A full date, with non-zero year, month and day values
5399 # * A month and day value, with a zero year, e.g. an anniversary
5400 # * A year on its own, with zero month and day values
5401 # * A year and month value, with a zero day, e.g. a credit card expiration date
5402 #
5403 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
5404 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
5405 # if specifying a year by itself or a year and month where the day is not
5406 # significant.
5407 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
5408 # month and day.
5409 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
5410 # a year.
5411 },
5412 },
5413 ],
5414 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
5415 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
5416 # profile page that represents who they are or what they care about.
5417 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
5418 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5419 # verified field is typically a name, email address, phone number, or
5420 # website that has been confirmed to be owned by the person.
5421 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5422 # field.
5423 &quot;source&quot;: { # The source of a field. # The source of the field.
5424 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5425 #
5426 # Metadata about a source of type PROFILE.
5427 &quot;userTypes&quot;: [ # Output only. The user types.
5428 &quot;A String&quot;,
5429 ],
5430 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5431 },
5432 &quot;type&quot;: &quot;A String&quot;, # The source type.
5433 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5434 #
5435 # Last update timestamp of this source.
5436 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5437 #
5438 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5439 # source. Used for web cache validation.
5440 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5441 },
5442 },
5443 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
5444 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
5445 # false if the cover photo is a user-provided cover photo.
5446 },
5447 ],
5448 &quot;residences&quot;: [ # The person&#x27;s residences.
5449 { # A person&#x27;s past or current residence.
5450 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
5451 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
5452 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5453 # verified field is typically a name, email address, phone number, or
5454 # website that has been confirmed to be owned by the person.
5455 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5456 # field.
5457 &quot;source&quot;: { # The source of a field. # The source of the field.
5458 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5459 #
5460 # Metadata about a source of type PROFILE.
5461 &quot;userTypes&quot;: [ # Output only. The user types.
5462 &quot;A String&quot;,
5463 ],
5464 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5465 },
5466 &quot;type&quot;: &quot;A String&quot;, # The source type.
5467 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5468 #
5469 # Last update timestamp of this source.
5470 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5471 #
5472 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5473 # source. Used for web cache validation.
5474 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5475 },
5476 },
5477 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
5478 # false if the residence is a past residence.
5479 },
5480 ],
5481 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
5482 { # A person&#x27;s instant messaging client.
5483 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
5484 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
5485 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5486 # verified field is typically a name, email address, phone number, or
5487 # website that has been confirmed to be owned by the person.
5488 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5489 # field.
5490 &quot;source&quot;: { # The source of a field. # The source of the field.
5491 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5492 #
5493 # Metadata about a source of type PROFILE.
5494 &quot;userTypes&quot;: [ # Output only. The user types.
5495 &quot;A String&quot;,
5496 ],
5497 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5498 },
5499 &quot;type&quot;: &quot;A String&quot;, # The source type.
5500 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5501 #
5502 # Last update timestamp of this source.
5503 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5504 #
5505 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5506 # source. Used for web cache validation.
5507 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5508 },
5509 },
5510 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
5511 # predefined values:
5512 #
5513 # * `home`
5514 # * `work`
5515 # * `other`
5516 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
5517 # predefined values:
5518 #
5519 # * `aim`
5520 # * `msn`
5521 # * `yahoo`
5522 # * `skype`
5523 # * `qq`
5524 # * `googleTalk`
5525 # * `icq`
5526 # * `jabber`
5527 # * `netMeeting`
5528 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
5529 # locale or the `Accept-Language` HTTP header locale.
5530 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
5531 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
5532 },
5533 ],
5534 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
5535 { # Arbitrary user data that is populated by the end users.
5536 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
5537 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5538 # verified field is typically a name, email address, phone number, or
5539 # website that has been confirmed to be owned by the person.
5540 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5541 # field.
5542 &quot;source&quot;: { # The source of a field. # The source of the field.
5543 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5544 #
5545 # Metadata about a source of type PROFILE.
5546 &quot;userTypes&quot;: [ # Output only. The user types.
5547 &quot;A String&quot;,
5548 ],
5549 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5550 },
5551 &quot;type&quot;: &quot;A String&quot;, # The source type.
5552 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5553 #
5554 # Last update timestamp of this source.
5555 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5556 #
5557 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5558 # source. Used for web cache validation.
5559 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5560 },
5561 },
5562 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
5563 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
5564 },
5565 ],
5566 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5567 # resource. Used for web cache validation.
5568 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
5569 # The person&#x27;s bragging rights.
5570 { # **DEPRECATED**: No data will be returned
5571 # A person&#x27;s bragging rights.
5572 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
5573 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
5574 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5575 # verified field is typically a name, email address, phone number, or
5576 # website that has been confirmed to be owned by the person.
5577 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5578 # field.
5579 &quot;source&quot;: { # The source of a field. # The source of the field.
5580 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5581 #
5582 # Metadata about a source of type PROFILE.
5583 &quot;userTypes&quot;: [ # Output only. The user types.
5584 &quot;A String&quot;,
5585 ],
5586 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5587 },
5588 &quot;type&quot;: &quot;A String&quot;, # The source type.
5589 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5590 #
5591 # Last update timestamp of this source.
5592 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5593 #
5594 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5595 # source. Used for web cache validation.
5596 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5597 },
5598 },
5599 },
5600 ],
5601 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
5602 # The person&#x27;s relationship interests.
5603 { # **DEPRECATED**: No data will be returned
5604 # A person&#x27;s relationship interest .
5605 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
5606 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5607 # verified field is typically a name, email address, phone number, or
5608 # website that has been confirmed to be owned by the person.
5609 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5610 # field.
5611 &quot;source&quot;: { # The source of a field. # The source of the field.
5612 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5613 #
5614 # Metadata about a source of type PROFILE.
5615 &quot;userTypes&quot;: [ # Output only. The user types.
5616 &quot;A String&quot;,
5617 ],
5618 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5619 },
5620 &quot;type&quot;: &quot;A String&quot;, # The source type.
5621 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5622 #
5623 # Last update timestamp of this source.
5624 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5625 #
5626 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5627 # source. Used for web cache validation.
5628 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5629 },
5630 },
5631 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
5632 # in the viewer&#x27;s account locale or the locale specified in the
5633 # Accept-Language HTTP header.
5634 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
5635 # or one of these predefined values:
5636 #
5637 # * `friend`
5638 # * `date`
5639 # * `relationship`
5640 # * `networking`
5641 },
5642 ],
5643 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
5644 { # A person&#x27;s age range.
5645 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
5646 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5647 # verified field is typically a name, email address, phone number, or
5648 # website that has been confirmed to be owned by the person.
5649 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5650 # field.
5651 &quot;source&quot;: { # The source of a field. # The source of the field.
5652 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5653 #
5654 # Metadata about a source of type PROFILE.
5655 &quot;userTypes&quot;: [ # Output only. The user types.
5656 &quot;A String&quot;,
5657 ],
5658 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5659 },
5660 &quot;type&quot;: &quot;A String&quot;, # The source type.
5661 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5662 #
5663 # Last update timestamp of this source.
5664 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5665 #
5666 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5667 # source. Used for web cache validation.
5668 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5669 },
5670 },
5671 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
5672 },
5673 ],
5674 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
5675 { # A person&#x27;s membership in a group. Only contact group memberships can be
5676 # modified.
5677 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
5678 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5679 # verified field is typically a name, email address, phone number, or
5680 # website that has been confirmed to be owned by the person.
5681 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5682 # field.
5683 &quot;source&quot;: { # The source of a field. # The source of the field.
5684 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5685 #
5686 # Metadata about a source of type PROFILE.
5687 &quot;userTypes&quot;: [ # Output only. The user types.
5688 &quot;A String&quot;,
5689 ],
5690 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5691 },
5692 &quot;type&quot;: &quot;A String&quot;, # The source type.
5693 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5694 #
5695 # Last update timestamp of this source.
5696 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5697 #
5698 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5699 # source. Used for web cache validation.
5700 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5701 },
5702 },
5703 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
5704 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
5705 # string, in the form of `contactGroups/{contact_group_id}`.
5706 # Only contact_group_resource_name can be used for modifying memberships.
5707 # Any contact group membership can be removed, but only user group or
5708 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
5709 # contact must always have at least one contact group membership.
5710 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
5711 },
5712 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
5713 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
5714 },
5715 },
5716 ],
5717 &quot;occupations&quot;: [ # The person&#x27;s occupations.
5718 { # A person&#x27;s occupation.
5719 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
5720 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5721 # verified field is typically a name, email address, phone number, or
5722 # website that has been confirmed to be owned by the person.
5723 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5724 # field.
5725 &quot;source&quot;: { # The source of a field. # The source of the field.
5726 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5727 #
5728 # Metadata about a source of type PROFILE.
5729 &quot;userTypes&quot;: [ # Output only. The user types.
5730 &quot;A String&quot;,
5731 ],
5732 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5733 },
5734 &quot;type&quot;: &quot;A String&quot;, # The source type.
5735 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5736 #
5737 # Last update timestamp of this source.
5738 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5739 #
5740 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5741 # source. Used for web cache validation.
5742 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5743 },
5744 },
5745 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
5746 },
5747 ],
5748 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
5749 { # A person&#x27;s associated URLs.
5750 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
5751 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5752 # verified field is typically a name, email address, phone number, or
5753 # website that has been confirmed to be owned by the person.
5754 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5755 # field.
5756 &quot;source&quot;: { # The source of a field. # The source of the field.
5757 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5758 #
5759 # Metadata about a source of type PROFILE.
5760 &quot;userTypes&quot;: [ # Output only. The user types.
5761 &quot;A String&quot;,
5762 ],
5763 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5764 },
5765 &quot;type&quot;: &quot;A String&quot;, # The source type.
5766 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5767 #
5768 # Last update timestamp of this source.
5769 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5770 #
5771 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5772 # source. Used for web cache validation.
5773 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5774 },
5775 },
5776 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
5777 # values:
5778 #
5779 # * `home`
5780 # * `work`
5781 # * `blog`
5782 # * `profile`
5783 # * `homePage`
5784 # * `ftp`
5785 # * `reservations`
5786 # * `appInstallPage`: website for a Google+ application.
5787 # * `other`
5788 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
5789 # account locale or the `Accept-Language` HTTP header locale.
5790 &quot;value&quot;: &quot;A String&quot;, # The URL.
5791 },
5792 ],
5793 &quot;skills&quot;: [ # The person&#x27;s skills.
5794 { # A skill that the person has.
5795 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
5796 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5797 # verified field is typically a name, email address, phone number, or
5798 # website that has been confirmed to be owned by the person.
5799 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5800 # field.
5801 &quot;source&quot;: { # The source of a field. # The source of the field.
5802 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5803 #
5804 # Metadata about a source of type PROFILE.
5805 &quot;userTypes&quot;: [ # Output only. The user types.
5806 &quot;A String&quot;,
5807 ],
5808 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5809 },
5810 &quot;type&quot;: &quot;A String&quot;, # The source type.
5811 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5812 #
5813 # Last update timestamp of this source.
5814 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5815 #
5816 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5817 # source. Used for web cache validation.
5818 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5819 },
5820 },
5821 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
5822 },
5823 ],
5824 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
5825 { # A person&#x27;s email address.
5826 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
5827 # predefined values:
5828 #
5829 # * `home`
5830 # * `work`
5831 # * `other`
5832 &quot;value&quot;: &quot;A String&quot;, # The email address.
5833 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
5834 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
5835 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5836 # verified field is typically a name, email address, phone number, or
5837 # website that has been confirmed to be owned by the person.
5838 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5839 # field.
5840 &quot;source&quot;: { # The source of a field. # The source of the field.
5841 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5842 #
5843 # Metadata about a source of type PROFILE.
5844 &quot;userTypes&quot;: [ # Output only. The user types.
5845 &quot;A String&quot;,
5846 ],
5847 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5848 },
5849 &quot;type&quot;: &quot;A String&quot;, # The source type.
5850 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5851 #
5852 # Last update timestamp of this source.
5853 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5854 #
5855 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5856 # source. Used for web cache validation.
5857 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5858 },
5859 },
5860 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
5861 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
5862 },
5863 ],
5864 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
5865 # The person&#x27;s taglines.
5866 { # **DEPRECATED**: No data will be returned
5867 # A brief one-line description of the person.
5868 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
5869 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5870 # verified field is typically a name, email address, phone number, or
5871 # website that has been confirmed to be owned by the person.
5872 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5873 # field.
5874 &quot;source&quot;: { # The source of a field. # The source of the field.
5875 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5876 #
5877 # Metadata about a source of type PROFILE.
5878 &quot;userTypes&quot;: [ # Output only. The user types.
5879 &quot;A String&quot;,
5880 ],
5881 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5882 },
5883 &quot;type&quot;: &quot;A String&quot;, # The source type.
5884 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5885 #
5886 # Last update timestamp of this source.
5887 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5888 #
5889 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5890 # source. Used for web cache validation.
5891 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5892 },
5893 },
5894 &quot;value&quot;: &quot;A String&quot;, # The tagline.
5895 },
5896 ],
5897 &quot;names&quot;: [ # The person&#x27;s names.
5898 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
5899 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
5900 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
5901 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
5902 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
5903 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
5904 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
5905 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
5906 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
5907 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
5908 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
5909 # the locale specified by the viewer&#x27;s account or the
5910 # `Accept-Language` HTTP header.
5911 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
5912 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
5913 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
5914 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
5915 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5916 # verified field is typically a name, email address, phone number, or
5917 # website that has been confirmed to be owned by the person.
5918 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5919 # field.
5920 &quot;source&quot;: { # The source of a field. # The source of the field.
5921 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5922 #
5923 # Metadata about a source of type PROFILE.
5924 &quot;userTypes&quot;: [ # Output only. The user types.
5925 &quot;A String&quot;,
5926 ],
5927 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5928 },
5929 &quot;type&quot;: &quot;A String&quot;, # The source type.
5930 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5931 #
5932 # Last update timestamp of this source.
5933 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5934 #
5935 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5936 # source. Used for web cache validation.
5937 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5938 },
5939 },
5940 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
5941 },
5942 ],
5943 &quot;biographies&quot;: [ # The person&#x27;s biographies.
5944 { # A person&#x27;s short biography.
5945 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
5946 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5947 # verified field is typically a name, email address, phone number, or
5948 # website that has been confirmed to be owned by the person.
5949 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5950 # field.
5951 &quot;source&quot;: { # The source of a field. # The source of the field.
5952 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5953 #
5954 # Metadata about a source of type PROFILE.
5955 &quot;userTypes&quot;: [ # Output only. The user types.
5956 &quot;A String&quot;,
5957 ],
5958 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5959 },
5960 &quot;type&quot;: &quot;A String&quot;, # The source type.
5961 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5962 #
5963 # Last update timestamp of this source.
5964 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
5965 #
5966 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
5967 # source. Used for web cache validation.
5968 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
5969 },
5970 },
5971 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
5972 &quot;value&quot;: &quot;A String&quot;, # The short biography.
5973 },
5974 ],
5975 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
5976 # with a max length of 27 characters, in the form of
5977 # `people/{person_id}`.
5978 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
5979 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
5980 # help others recognize the person.
5981 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
5982 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
5983 # verified field is typically a name, email address, phone number, or
5984 # website that has been confirmed to be owned by the person.
5985 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
5986 # field.
5987 &quot;source&quot;: { # The source of a field. # The source of the field.
5988 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
5989 #
5990 # Metadata about a source of type PROFILE.
5991 &quot;userTypes&quot;: [ # Output only. The user types.
5992 &quot;A String&quot;,
5993 ],
5994 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
5995 },
5996 &quot;type&quot;: &quot;A String&quot;, # The source type.
5997 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
5998 #
5999 # Last update timestamp of this source.
6000 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6001 #
6002 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6003 # source. Used for web cache validation.
6004 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6005 },
6006 },
6007 &quot;default&quot;: True or False, # True if the photo is a default photo;
6008 # false if the photo is a user-provided photo.
6009 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
6010 # parameter `sz={size}` at the end of the url, where {size} is the size in
6011 # pixels. Example:
6012 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
6013 },
6014 ],
6015 &quot;events&quot;: [ # The person&#x27;s events.
6016 { # An event related to the person.
6017 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
6018 # values:
6019 #
6020 # * `anniversary`
6021 # * `other`
6022 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
6023 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6024 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
6025 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6026 # verified field is typically a name, email address, phone number, or
6027 # website that has been confirmed to be owned by the person.
6028 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6029 # field.
6030 &quot;source&quot;: { # The source of a field. # The source of the field.
6031 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6032 #
6033 # Metadata about a source of type PROFILE.
6034 &quot;userTypes&quot;: [ # Output only. The user types.
6035 &quot;A String&quot;,
6036 ],
6037 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6038 },
6039 &quot;type&quot;: &quot;A String&quot;, # The source type.
6040 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6041 #
6042 # Last update timestamp of this source.
6043 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6044 #
6045 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6046 # source. Used for web cache validation.
6047 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6048 },
6049 },
6050 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
6051 # and time zone are either specified elsewhere or are not significant. The date
6052 # is relative to the Proleptic Gregorian Calendar. This can represent:
6053 #
6054 # * A full date, with non-zero year, month and day values
6055 # * A month and day value, with a zero year, e.g. an anniversary
6056 # * A year on its own, with zero month and day values
6057 # * A year and month value, with a zero day, e.g. a credit card expiration date
6058 #
6059 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6060 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6061 # if specifying a year by itself or a year and month where the day is not
6062 # significant.
6063 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6064 # month and day.
6065 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6066 # a year.
6067 },
6068 },
6069 ],
6070 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
6071 { # A person&#x27;s locale preference.
6072 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
6073 # language tag representing the locale.
6074 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
6075 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6076 # verified field is typically a name, email address, phone number, or
6077 # website that has been confirmed to be owned by the person.
6078 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6079 # field.
6080 &quot;source&quot;: { # The source of a field. # The source of the field.
6081 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6082 #
6083 # Metadata about a source of type PROFILE.
6084 &quot;userTypes&quot;: [ # Output only. The user types.
6085 &quot;A String&quot;,
6086 ],
6087 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6088 },
6089 &quot;type&quot;: &quot;A String&quot;, # The source type.
6090 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6091 #
6092 # Last update timestamp of this source.
6093 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6094 #
6095 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6096 # source. Used for web cache validation.
6097 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6098 },
6099 },
6100 },
6101 ],
6102 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
6103 { # A person&#x27;s phone number.
6104 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
6105 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
6106 # form of the phone number.
6107 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
6108 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6109 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
6110 # predefined values:
6111 #
6112 # * `home`
6113 # * `work`
6114 # * `mobile`
6115 # * `homeFax`
6116 # * `workFax`
6117 # * `otherFax`
6118 # * `pager`
6119 # * `workMobile`
6120 # * `workPager`
6121 # * `main`
6122 # * `googleVoice`
6123 # * `other`
6124 &quot;value&quot;: &quot;A String&quot;, # The phone number.
6125 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
6126 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6127 # verified field is typically a name, email address, phone number, or
6128 # website that has been confirmed to be owned by the person.
6129 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6130 # field.
6131 &quot;source&quot;: { # The source of a field. # The source of the field.
6132 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6133 #
6134 # Metadata about a source of type PROFILE.
6135 &quot;userTypes&quot;: [ # Output only. The user types.
6136 &quot;A String&quot;,
6137 ],
6138 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6139 },
6140 &quot;type&quot;: &quot;A String&quot;, # The source type.
6141 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6142 #
6143 # Last update timestamp of this source.
6144 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6145 #
6146 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6147 # source. Used for web cache validation.
6148 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6149 },
6150 },
6151 },
6152 ],
6153 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
6154 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
6155 # communications to make voice or video calls over the internet.
6156 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
6157 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6158 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
6159 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
6160 # format.
6161 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
6162 # predefined values:
6163 #
6164 # * `home`
6165 # * `work`
6166 # * `mobile`
6167 # * `other`
6168 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
6169 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6170 # verified field is typically a name, email address, phone number, or
6171 # website that has been confirmed to be owned by the person.
6172 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6173 # field.
6174 &quot;source&quot;: { # The source of a field. # The source of the field.
6175 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6176 #
6177 # Metadata about a source of type PROFILE.
6178 &quot;userTypes&quot;: [ # Output only. The user types.
6179 &quot;A String&quot;,
6180 ],
6181 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6182 },
6183 &quot;type&quot;: &quot;A String&quot;, # The source type.
6184 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6185 #
6186 # Last update timestamp of this source.
6187 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6188 #
6189 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6190 # source. Used for web cache validation.
6191 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6192 },
6193 },
6194 },
6195 ],
6196 &quot;interests&quot;: [ # The person&#x27;s interests.
6197 { # One of the person&#x27;s interests.
6198 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
6199 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6200 # verified field is typically a name, email address, phone number, or
6201 # website that has been confirmed to be owned by the person.
6202 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6203 # field.
6204 &quot;source&quot;: { # The source of a field. # The source of the field.
6205 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6206 #
6207 # Metadata about a source of type PROFILE.
6208 &quot;userTypes&quot;: [ # Output only. The user types.
6209 &quot;A String&quot;,
6210 ],
6211 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6212 },
6213 &quot;type&quot;: &quot;A String&quot;, # The source type.
6214 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6215 #
6216 # Last update timestamp of this source.
6217 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6218 #
6219 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6220 # source. Used for web cache validation.
6221 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6222 },
6223 },
6224 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
6225 },
6226 ],
6227 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
6228 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
6229 # specified. The `date` and `text` fields typically represent the same
6230 # date, but are not guaranteed to.
6231 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
6232 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6233 # verified field is typically a name, email address, phone number, or
6234 # website that has been confirmed to be owned by the person.
6235 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6236 # field.
6237 &quot;source&quot;: { # The source of a field. # The source of the field.
6238 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6239 #
6240 # Metadata about a source of type PROFILE.
6241 &quot;userTypes&quot;: [ # Output only. The user types.
6242 &quot;A String&quot;,
6243 ],
6244 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6245 },
6246 &quot;type&quot;: &quot;A String&quot;, # The source type.
6247 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6248 #
6249 # Last update timestamp of this source.
6250 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6251 #
6252 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6253 # source. Used for web cache validation.
6254 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6255 },
6256 },
6257 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
6258 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
6259 # and time zone are either specified elsewhere or are not significant. The date
6260 # is relative to the Proleptic Gregorian Calendar. This can represent:
6261 #
6262 # * A full date, with non-zero year, month and day values
6263 # * A month and day value, with a zero year, e.g. an anniversary
6264 # * A year on its own, with zero month and day values
6265 # * A year and month value, with a zero day, e.g. a credit card expiration date
6266 #
6267 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6268 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6269 # if specifying a year by itself or a year and month where the day is not
6270 # significant.
6271 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6272 # month and day.
6273 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6274 # a year.
6275 },
6276 },
6277 ],
6278 &quot;genders&quot;: [ # The person&#x27;s genders.
6279 { # A person&#x27;s gender.
6280 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
6281 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
6282 # value are not localized.
6283 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
6284 # can be custom or one of these predefined values:
6285 #
6286 # * `male`
6287 # * `female`
6288 # * `other`
6289 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
6290 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6291 # verified field is typically a name, email address, phone number, or
6292 # website that has been confirmed to be owned by the person.
6293 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6294 # field.
6295 &quot;source&quot;: { # The source of a field. # The source of the field.
6296 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6297 #
6298 # Metadata about a source of type PROFILE.
6299 &quot;userTypes&quot;: [ # Output only. The user types.
6300 &quot;A String&quot;,
6301 ],
6302 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6303 },
6304 &quot;type&quot;: &quot;A String&quot;, # The source type.
6305 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6306 #
6307 # Last update timestamp of this source.
6308 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6309 #
6310 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6311 # source. Used for web cache validation.
6312 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6313 },
6314 },
6315 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
6316 # predefined values:
6317 #
6318 # * `male`
6319 # * `female`
6320 # * `unspecified`
6321 },
6322 ],
6323 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
6324 { # A person&#x27;s nickname.
6325 &quot;value&quot;: &quot;A String&quot;, # The nickname.
6326 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
6327 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6328 # verified field is typically a name, email address, phone number, or
6329 # website that has been confirmed to be owned by the person.
6330 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6331 # field.
6332 &quot;source&quot;: { # The source of a field. # The source of the field.
6333 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6334 #
6335 # Metadata about a source of type PROFILE.
6336 &quot;userTypes&quot;: [ # Output only. The user types.
6337 &quot;A String&quot;,
6338 ],
6339 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6340 },
6341 &quot;type&quot;: &quot;A String&quot;, # The source type.
6342 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6343 #
6344 # Last update timestamp of this source.
6345 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6346 #
6347 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6348 # source. Used for web cache validation.
6349 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6350 },
6351 },
6352 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
6353 },
6354 ],
6355 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
6356 # The person&#x27;s relationship statuses.
6357 { # **DEPRECATED**: No data will be returned
6358 # A person&#x27;s relationship status.
6359 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
6360 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6361 # verified field is typically a name, email address, phone number, or
6362 # website that has been confirmed to be owned by the person.
6363 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6364 # field.
6365 &quot;source&quot;: { # The source of a field. # The source of the field.
6366 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6367 #
6368 # Metadata about a source of type PROFILE.
6369 &quot;userTypes&quot;: [ # Output only. The user types.
6370 &quot;A String&quot;,
6371 ],
6372 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6373 },
6374 &quot;type&quot;: &quot;A String&quot;, # The source type.
6375 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6376 #
6377 # Last update timestamp of this source.
6378 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6379 #
6380 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6381 # source. Used for web cache validation.
6382 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6383 },
6384 },
6385 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
6386 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6387 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
6388 # predefined values:
6389 #
6390 # * `single`
6391 # * `inARelationship`
6392 # * `engaged`
6393 # * `married`
6394 # * `itsComplicated`
6395 # * `openRelationship`
6396 # * `widowed`
6397 # * `inDomesticPartnership`
6398 # * `inCivilUnion`
6399 },
6400 ],
6401 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
6402 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
6403 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07006404 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006405 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
6406 # `person.metadata.sources.profileMetadata.objectType` instead)
6407 #
6408 # The type of the person object.
6409 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
6410 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
6411 # that include a sync token.
6412 #
6413 # The resource name may change when adding or removing fields that link a
6414 # contact and profile such as a verified email, verified phone number, or
6415 # profile URL.
6416 &quot;A String&quot;,
6417 ],
6418 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
6419 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
6420 # that include a sync token.
6421 &quot;sources&quot;: [ # The sources of data for the person.
6422 { # The source of a field.
6423 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07006424 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006425 # Metadata about a source of type PROFILE.
6426 &quot;userTypes&quot;: [ # Output only. The user types.
6427 &quot;A String&quot;,
6428 ],
6429 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6430 },
6431 &quot;type&quot;: &quot;A String&quot;, # The source type.
6432 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07006433 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006434 # Last update timestamp of this source.
6435 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07006436 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006437 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6438 # source. Used for web cache validation.
6439 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07006440 },
6441 ],
6442 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006443 },
Bu Sun Kim65020912020-05-20 12:08:20 -07006444 &quot;status&quot;: { # The `Status` type defines a logical error model that is suitable for # The status of the response.
Dan O'Mearadd494642020-05-01 07:42:23 -07006445 # different programming environments, including REST APIs and RPC APIs. It is
6446 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6447 # three pieces of data: error code, error message, and error details.
6448 #
6449 # You can find out more about this error model and how to work with it in the
6450 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -07006451 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Dan O'Mearadd494642020-05-01 07:42:23 -07006452 # message types for APIs to use.
6453 {
Bu Sun Kim65020912020-05-20 12:08:20 -07006454 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -07006455 },
6456 ],
Bu Sun Kim65020912020-05-20 12:08:20 -07006457 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006458 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6459 # user-facing error message should be localized and sent in the
6460 # google.rpc.Status.details field, or localized by the client.
Dan O'Mearadd494642020-05-01 07:42:23 -07006461 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006462 &quot;requestedResourceName&quot;: &quot;A String&quot;, # The original requested resource name. May be different than the resource
6463 # name on the returned person.
6464 #
6465 # The resource name can change when adding or removing fields that link a
6466 # contact and profile such as a verified email, verified phone number, or a
6467 # profile URL.
Dan O'Mearadd494642020-05-01 07:42:23 -07006468 },
6469 ],
6470 }</pre>
6471</div>
6472
6473<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -07006474 <code class="details" id="updateContact">updateContact(resourceName, body=None, updatePersonFields=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -07006475 <pre>Update contact data for an existing contact person. Any non-contact data
6476will not be modified.
6477
6478The request throws a 400 error if `updatePersonFields` is not specified.
6479
6480The request throws a 400 error if `person.metadata.sources` is not
6481specified for the contact to be updated.
6482
6483The request throws a 400 error with an error with reason
Bu Sun Kim65020912020-05-20 12:08:20 -07006484`&quot;failedPrecondition&quot;` if `person.metadata.sources.etag` is different than
6485the contact&#x27;s etag, which indicates the contact has changed since its data
Dan O'Mearadd494642020-05-01 07:42:23 -07006486was read. Clients should get the latest person and re-apply their updates
6487to the latest person.
6488
6489Args:
6490 resourceName: string, The resource name for the person, assigned by the server. An ASCII string
6491with a max length of 27 characters, in the form of
6492`people/{person_id}`. (required)
6493 body: object, The request body.
6494 The object takes the form of:
6495
6496{ # Information about a person merged from various data sources such as the
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006497 # authenticated user&#x27;s contacts and profile data.
6498 #
6499 # Most fields can have multiple items. The items in a field have no guaranteed
6500 # order, but each non-empty field is guaranteed to have exactly one field with
6501 # `metadata.primary` set to true.
6502 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
6503 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
6504 # are optional.
6505 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
6506 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
6507 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
6508 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
6509 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
6510 # account locale or the `Accept-Language` HTTP header locale.
6511 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
6512 # code of the address.
6513 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
6514 # values:
Dan O'Mearadd494642020-05-01 07:42:23 -07006515 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006516 # * `home`
6517 # * `work`
6518 # * `other`
6519 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
6520 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
6521 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6522 # verified field is typically a name, email address, phone number, or
6523 # website that has been confirmed to be owned by the person.
6524 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6525 # field.
6526 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07006527 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6528 #
6529 # Metadata about a source of type PROFILE.
6530 &quot;userTypes&quot;: [ # Output only. The user types.
6531 &quot;A String&quot;,
6532 ],
6533 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6534 },
6535 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006536 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6537 #
6538 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07006539 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Dan O'Mearadd494642020-05-01 07:42:23 -07006540 #
6541 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6542 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006543 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Dan O'Mearadd494642020-05-01 07:42:23 -07006544 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006545 },
6546 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
6547 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
6548 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
6549 # will be automatically constructed from structured values.
Dan O'Mearadd494642020-05-01 07:42:23 -07006550 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006551 ],
6552 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
6553 #
6554 # The person&#x27;s age range.
6555 &quot;relations&quot;: [ # The person&#x27;s relations.
6556 { # A person&#x27;s relation to another person.
6557 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
6558 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
6559 # account locale or the locale specified in the Accept-Language HTTP header.
6560 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
6561 # these predefined values:
6562 #
6563 # * `spouse`
6564 # * `child`
6565 # * `mother`
6566 # * `father`
6567 # * `parent`
6568 # * `brother`
6569 # * `sister`
6570 # * `friend`
6571 # * `relative`
6572 # * `domesticPartner`
6573 # * `manager`
6574 # * `assistant`
6575 # * `referredBy`
6576 # * `partner`
6577 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
6578 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6579 # verified field is typically a name, email address, phone number, or
6580 # website that has been confirmed to be owned by the person.
6581 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6582 # field.
6583 &quot;source&quot;: { # The source of a field. # The source of the field.
6584 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6585 #
6586 # Metadata about a source of type PROFILE.
6587 &quot;userTypes&quot;: [ # Output only. The user types.
6588 &quot;A String&quot;,
6589 ],
6590 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07006591 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006592 &quot;type&quot;: &quot;A String&quot;, # The source type.
6593 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6594 #
6595 # Last update timestamp of this source.
6596 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6597 #
6598 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6599 # source. Used for web cache validation.
6600 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07006601 },
6602 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07006603 },
6604 ],
6605 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
6606 { # A person&#x27;s past or current organization. Overlapping date ranges are
6607 # permitted.
6608 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
6609 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6610 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
6611 # false if the organization is a past organization.
6612 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
6613 # symbol, abbreviation, or acronym.
6614 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
6615 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
6616 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
6617 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6618 # verified field is typically a name, email address, phone number, or
6619 # website that has been confirmed to be owned by the person.
6620 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6621 # field.
6622 &quot;source&quot;: { # The source of a field. # The source of the field.
6623 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6624 #
6625 # Metadata about a source of type PROFILE.
6626 &quot;userTypes&quot;: [ # Output only. The user types.
6627 &quot;A String&quot;,
6628 ],
6629 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6630 },
6631 &quot;type&quot;: &quot;A String&quot;, # The source type.
6632 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6633 #
6634 # Last update timestamp of this source.
6635 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6636 #
6637 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6638 # source. Used for web cache validation.
6639 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6640 },
6641 },
6642 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
6643 # predefined values:
6644 #
6645 # * `work`
6646 # * `school`
6647 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
6648 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
6649 # and time zone are either specified elsewhere or are not significant. The date
6650 # is relative to the Proleptic Gregorian Calendar. This can represent:
6651 #
6652 # * A full date, with non-zero year, month and day values
6653 # * A month and day value, with a zero year, e.g. an anniversary
6654 # * A year on its own, with zero month and day values
6655 # * A year and month value, with a zero day, e.g. a credit card expiration date
6656 #
6657 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6658 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6659 # if specifying a year by itself or a year and month where the day is not
6660 # significant.
6661 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6662 # month and day.
6663 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6664 # a year.
6665 },
6666 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
6667 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
6668 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
6669 # `google.com`.
6670 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
6671 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
6672 # and time zone are either specified elsewhere or are not significant. The date
6673 # is relative to the Proleptic Gregorian Calendar. This can represent:
6674 #
6675 # * A full date, with non-zero year, month and day values
6676 # * A month and day value, with a zero year, e.g. an anniversary
6677 # * A year on its own, with zero month and day values
6678 # * A year and month value, with a zero day, e.g. a credit card expiration date
6679 #
6680 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
6681 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
6682 # if specifying a year by itself or a year and month where the day is not
6683 # significant.
6684 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
6685 # month and day.
6686 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
6687 # a year.
6688 },
6689 },
6690 ],
6691 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
6692 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
6693 # profile page that represents who they are or what they care about.
6694 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
6695 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6696 # verified field is typically a name, email address, phone number, or
6697 # website that has been confirmed to be owned by the person.
6698 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6699 # field.
6700 &quot;source&quot;: { # The source of a field. # The source of the field.
6701 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6702 #
6703 # Metadata about a source of type PROFILE.
6704 &quot;userTypes&quot;: [ # Output only. The user types.
6705 &quot;A String&quot;,
6706 ],
6707 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6708 },
6709 &quot;type&quot;: &quot;A String&quot;, # The source type.
6710 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6711 #
6712 # Last update timestamp of this source.
6713 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6714 #
6715 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6716 # source. Used for web cache validation.
6717 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6718 },
6719 },
6720 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
6721 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
6722 # false if the cover photo is a user-provided cover photo.
6723 },
6724 ],
6725 &quot;residences&quot;: [ # The person&#x27;s residences.
6726 { # A person&#x27;s past or current residence.
6727 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
6728 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
6729 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6730 # verified field is typically a name, email address, phone number, or
6731 # website that has been confirmed to be owned by the person.
6732 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6733 # field.
6734 &quot;source&quot;: { # The source of a field. # The source of the field.
6735 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6736 #
6737 # Metadata about a source of type PROFILE.
6738 &quot;userTypes&quot;: [ # Output only. The user types.
6739 &quot;A String&quot;,
6740 ],
6741 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6742 },
6743 &quot;type&quot;: &quot;A String&quot;, # The source type.
6744 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6745 #
6746 # Last update timestamp of this source.
6747 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6748 #
6749 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6750 # source. Used for web cache validation.
6751 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6752 },
6753 },
6754 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
6755 # false if the residence is a past residence.
6756 },
6757 ],
6758 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
6759 { # A person&#x27;s instant messaging client.
6760 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
6761 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
6762 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6763 # verified field is typically a name, email address, phone number, or
6764 # website that has been confirmed to be owned by the person.
6765 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6766 # field.
6767 &quot;source&quot;: { # The source of a field. # The source of the field.
6768 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6769 #
6770 # Metadata about a source of type PROFILE.
6771 &quot;userTypes&quot;: [ # Output only. The user types.
6772 &quot;A String&quot;,
6773 ],
6774 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6775 },
6776 &quot;type&quot;: &quot;A String&quot;, # The source type.
6777 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6778 #
6779 # Last update timestamp of this source.
6780 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6781 #
6782 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6783 # source. Used for web cache validation.
6784 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6785 },
6786 },
6787 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
6788 # predefined values:
6789 #
6790 # * `home`
6791 # * `work`
6792 # * `other`
6793 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
6794 # predefined values:
6795 #
6796 # * `aim`
6797 # * `msn`
6798 # * `yahoo`
6799 # * `skype`
6800 # * `qq`
6801 # * `googleTalk`
6802 # * `icq`
6803 # * `jabber`
6804 # * `netMeeting`
6805 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
6806 # locale or the `Accept-Language` HTTP header locale.
6807 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
6808 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
6809 },
6810 ],
6811 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
6812 { # Arbitrary user data that is populated by the end users.
6813 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
6814 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6815 # verified field is typically a name, email address, phone number, or
6816 # website that has been confirmed to be owned by the person.
6817 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6818 # field.
6819 &quot;source&quot;: { # The source of a field. # The source of the field.
6820 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6821 #
6822 # Metadata about a source of type PROFILE.
6823 &quot;userTypes&quot;: [ # Output only. The user types.
6824 &quot;A String&quot;,
6825 ],
6826 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6827 },
6828 &quot;type&quot;: &quot;A String&quot;, # The source type.
6829 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6830 #
6831 # Last update timestamp of this source.
6832 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6833 #
6834 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6835 # source. Used for web cache validation.
6836 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6837 },
6838 },
6839 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
6840 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
6841 },
6842 ],
6843 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6844 # resource. Used for web cache validation.
6845 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
6846 # The person&#x27;s bragging rights.
6847 { # **DEPRECATED**: No data will be returned
6848 # A person&#x27;s bragging rights.
6849 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
6850 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
6851 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6852 # verified field is typically a name, email address, phone number, or
6853 # website that has been confirmed to be owned by the person.
6854 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6855 # field.
6856 &quot;source&quot;: { # The source of a field. # The source of the field.
6857 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6858 #
6859 # Metadata about a source of type PROFILE.
6860 &quot;userTypes&quot;: [ # Output only. The user types.
6861 &quot;A String&quot;,
6862 ],
6863 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6864 },
6865 &quot;type&quot;: &quot;A String&quot;, # The source type.
6866 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6867 #
6868 # Last update timestamp of this source.
6869 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6870 #
6871 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6872 # source. Used for web cache validation.
6873 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6874 },
6875 },
6876 },
6877 ],
6878 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
6879 # The person&#x27;s relationship interests.
6880 { # **DEPRECATED**: No data will be returned
6881 # A person&#x27;s relationship interest .
6882 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
6883 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6884 # verified field is typically a name, email address, phone number, or
6885 # website that has been confirmed to be owned by the person.
6886 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6887 # field.
6888 &quot;source&quot;: { # The source of a field. # The source of the field.
6889 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6890 #
6891 # Metadata about a source of type PROFILE.
6892 &quot;userTypes&quot;: [ # Output only. The user types.
6893 &quot;A String&quot;,
6894 ],
6895 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6896 },
6897 &quot;type&quot;: &quot;A String&quot;, # The source type.
6898 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6899 #
6900 # Last update timestamp of this source.
6901 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6902 #
6903 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6904 # source. Used for web cache validation.
6905 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6906 },
6907 },
6908 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
6909 # in the viewer&#x27;s account locale or the locale specified in the
6910 # Accept-Language HTTP header.
6911 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
6912 # or one of these predefined values:
6913 #
6914 # * `friend`
6915 # * `date`
6916 # * `relationship`
6917 # * `networking`
6918 },
6919 ],
6920 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
6921 { # A person&#x27;s age range.
6922 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
6923 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6924 # verified field is typically a name, email address, phone number, or
6925 # website that has been confirmed to be owned by the person.
6926 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6927 # field.
6928 &quot;source&quot;: { # The source of a field. # The source of the field.
6929 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6930 #
6931 # Metadata about a source of type PROFILE.
6932 &quot;userTypes&quot;: [ # Output only. The user types.
6933 &quot;A String&quot;,
6934 ],
6935 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6936 },
6937 &quot;type&quot;: &quot;A String&quot;, # The source type.
6938 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6939 #
6940 # Last update timestamp of this source.
6941 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6942 #
6943 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6944 # source. Used for web cache validation.
6945 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6946 },
6947 },
6948 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
6949 },
6950 ],
6951 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
6952 { # A person&#x27;s membership in a group. Only contact group memberships can be
6953 # modified.
6954 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
6955 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6956 # verified field is typically a name, email address, phone number, or
6957 # website that has been confirmed to be owned by the person.
6958 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
6959 # field.
6960 &quot;source&quot;: { # The source of a field. # The source of the field.
6961 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
6962 #
6963 # Metadata about a source of type PROFILE.
6964 &quot;userTypes&quot;: [ # Output only. The user types.
6965 &quot;A String&quot;,
6966 ],
6967 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
6968 },
6969 &quot;type&quot;: &quot;A String&quot;, # The source type.
6970 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
6971 #
6972 # Last update timestamp of this source.
6973 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
6974 #
6975 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
6976 # source. Used for web cache validation.
6977 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
6978 },
6979 },
6980 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
6981 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
6982 # string, in the form of `contactGroups/{contact_group_id}`.
6983 # Only contact_group_resource_name can be used for modifying memberships.
6984 # Any contact group membership can be removed, but only user group or
6985 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
6986 # contact must always have at least one contact group membership.
6987 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
6988 },
6989 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
6990 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
6991 },
6992 },
6993 ],
6994 &quot;occupations&quot;: [ # The person&#x27;s occupations.
6995 { # A person&#x27;s occupation.
6996 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
6997 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
6998 # verified field is typically a name, email address, phone number, or
6999 # website that has been confirmed to be owned by the person.
7000 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7001 # field.
7002 &quot;source&quot;: { # The source of a field. # The source of the field.
7003 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7004 #
7005 # Metadata about a source of type PROFILE.
7006 &quot;userTypes&quot;: [ # Output only. The user types.
7007 &quot;A String&quot;,
7008 ],
7009 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7010 },
7011 &quot;type&quot;: &quot;A String&quot;, # The source type.
7012 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7013 #
7014 # Last update timestamp of this source.
7015 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7016 #
7017 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7018 # source. Used for web cache validation.
7019 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7020 },
7021 },
7022 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
7023 },
7024 ],
7025 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
7026 { # A person&#x27;s associated URLs.
7027 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
7028 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7029 # verified field is typically a name, email address, phone number, or
7030 # website that has been confirmed to be owned by the person.
7031 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7032 # field.
7033 &quot;source&quot;: { # The source of a field. # The source of the field.
7034 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7035 #
7036 # Metadata about a source of type PROFILE.
7037 &quot;userTypes&quot;: [ # Output only. The user types.
7038 &quot;A String&quot;,
7039 ],
7040 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7041 },
7042 &quot;type&quot;: &quot;A String&quot;, # The source type.
7043 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7044 #
7045 # Last update timestamp of this source.
7046 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7047 #
7048 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7049 # source. Used for web cache validation.
7050 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7051 },
7052 },
7053 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
7054 # values:
7055 #
7056 # * `home`
7057 # * `work`
7058 # * `blog`
7059 # * `profile`
7060 # * `homePage`
7061 # * `ftp`
7062 # * `reservations`
7063 # * `appInstallPage`: website for a Google+ application.
7064 # * `other`
7065 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
7066 # account locale or the `Accept-Language` HTTP header locale.
7067 &quot;value&quot;: &quot;A String&quot;, # The URL.
7068 },
7069 ],
7070 &quot;skills&quot;: [ # The person&#x27;s skills.
7071 { # A skill that the person has.
7072 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
7073 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7074 # verified field is typically a name, email address, phone number, or
7075 # website that has been confirmed to be owned by the person.
7076 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7077 # field.
7078 &quot;source&quot;: { # The source of a field. # The source of the field.
7079 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7080 #
7081 # Metadata about a source of type PROFILE.
7082 &quot;userTypes&quot;: [ # Output only. The user types.
7083 &quot;A String&quot;,
7084 ],
7085 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7086 },
7087 &quot;type&quot;: &quot;A String&quot;, # The source type.
7088 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7089 #
7090 # Last update timestamp of this source.
7091 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7092 #
7093 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7094 # source. Used for web cache validation.
7095 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7096 },
7097 },
7098 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
7099 },
7100 ],
7101 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
7102 { # A person&#x27;s email address.
7103 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
7104 # predefined values:
7105 #
7106 # * `home`
7107 # * `work`
7108 # * `other`
7109 &quot;value&quot;: &quot;A String&quot;, # The email address.
7110 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
7111 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
7112 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7113 # verified field is typically a name, email address, phone number, or
7114 # website that has been confirmed to be owned by the person.
7115 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7116 # field.
7117 &quot;source&quot;: { # The source of a field. # The source of the field.
7118 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7119 #
7120 # Metadata about a source of type PROFILE.
7121 &quot;userTypes&quot;: [ # Output only. The user types.
7122 &quot;A String&quot;,
7123 ],
7124 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7125 },
7126 &quot;type&quot;: &quot;A String&quot;, # The source type.
7127 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7128 #
7129 # Last update timestamp of this source.
7130 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7131 #
7132 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7133 # source. Used for web cache validation.
7134 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7135 },
7136 },
7137 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
7138 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7139 },
7140 ],
7141 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
7142 # The person&#x27;s taglines.
7143 { # **DEPRECATED**: No data will be returned
7144 # A brief one-line description of the person.
7145 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
7146 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7147 # verified field is typically a name, email address, phone number, or
7148 # website that has been confirmed to be owned by the person.
7149 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7150 # field.
7151 &quot;source&quot;: { # The source of a field. # The source of the field.
7152 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7153 #
7154 # Metadata about a source of type PROFILE.
7155 &quot;userTypes&quot;: [ # Output only. The user types.
7156 &quot;A String&quot;,
7157 ],
7158 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7159 },
7160 &quot;type&quot;: &quot;A String&quot;, # The source type.
7161 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7162 #
7163 # Last update timestamp of this source.
7164 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7165 #
7166 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7167 # source. Used for web cache validation.
7168 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7169 },
7170 },
7171 &quot;value&quot;: &quot;A String&quot;, # The tagline.
7172 },
7173 ],
7174 &quot;names&quot;: [ # The person&#x27;s names.
7175 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
7176 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
7177 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
7178 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
7179 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
7180 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
7181 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
7182 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
7183 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
7184 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
7185 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
7186 # the locale specified by the viewer&#x27;s account or the
7187 # `Accept-Language` HTTP header.
7188 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
7189 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
7190 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
7191 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
7192 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7193 # verified field is typically a name, email address, phone number, or
7194 # website that has been confirmed to be owned by the person.
7195 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7196 # field.
7197 &quot;source&quot;: { # The source of a field. # The source of the field.
7198 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7199 #
7200 # Metadata about a source of type PROFILE.
7201 &quot;userTypes&quot;: [ # Output only. The user types.
7202 &quot;A String&quot;,
7203 ],
7204 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7205 },
7206 &quot;type&quot;: &quot;A String&quot;, # The source type.
7207 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7208 #
7209 # Last update timestamp of this source.
7210 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7211 #
7212 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7213 # source. Used for web cache validation.
7214 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7215 },
7216 },
7217 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
7218 },
7219 ],
7220 &quot;biographies&quot;: [ # The person&#x27;s biographies.
7221 { # A person&#x27;s short biography.
7222 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
7223 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7224 # verified field is typically a name, email address, phone number, or
7225 # website that has been confirmed to be owned by the person.
7226 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7227 # field.
7228 &quot;source&quot;: { # The source of a field. # The source of the field.
7229 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7230 #
7231 # Metadata about a source of type PROFILE.
7232 &quot;userTypes&quot;: [ # Output only. The user types.
7233 &quot;A String&quot;,
7234 ],
7235 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7236 },
7237 &quot;type&quot;: &quot;A String&quot;, # The source type.
7238 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7239 #
7240 # Last update timestamp of this source.
7241 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7242 #
7243 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7244 # source. Used for web cache validation.
7245 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7246 },
7247 },
7248 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
7249 &quot;value&quot;: &quot;A String&quot;, # The short biography.
7250 },
7251 ],
7252 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
7253 # with a max length of 27 characters, in the form of
7254 # `people/{person_id}`.
7255 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
7256 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
7257 # help others recognize the person.
7258 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
7259 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7260 # verified field is typically a name, email address, phone number, or
7261 # website that has been confirmed to be owned by the person.
7262 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7263 # field.
7264 &quot;source&quot;: { # The source of a field. # The source of the field.
7265 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7266 #
7267 # Metadata about a source of type PROFILE.
7268 &quot;userTypes&quot;: [ # Output only. The user types.
7269 &quot;A String&quot;,
7270 ],
7271 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7272 },
7273 &quot;type&quot;: &quot;A String&quot;, # The source type.
7274 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7275 #
7276 # Last update timestamp of this source.
7277 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7278 #
7279 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7280 # source. Used for web cache validation.
7281 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7282 },
7283 },
7284 &quot;default&quot;: True or False, # True if the photo is a default photo;
7285 # false if the photo is a user-provided photo.
7286 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
7287 # parameter `sz={size}` at the end of the url, where {size} is the size in
7288 # pixels. Example:
7289 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
7290 },
7291 ],
7292 &quot;events&quot;: [ # The person&#x27;s events.
7293 { # An event related to the person.
7294 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
7295 # values:
7296 #
7297 # * `anniversary`
7298 # * `other`
7299 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
7300 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7301 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
7302 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7303 # verified field is typically a name, email address, phone number, or
7304 # website that has been confirmed to be owned by the person.
7305 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7306 # field.
7307 &quot;source&quot;: { # The source of a field. # The source of the field.
7308 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7309 #
7310 # Metadata about a source of type PROFILE.
7311 &quot;userTypes&quot;: [ # Output only. The user types.
7312 &quot;A String&quot;,
7313 ],
7314 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7315 },
7316 &quot;type&quot;: &quot;A String&quot;, # The source type.
7317 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7318 #
7319 # Last update timestamp of this source.
7320 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7321 #
7322 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7323 # source. Used for web cache validation.
7324 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7325 },
7326 },
7327 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
7328 # and time zone are either specified elsewhere or are not significant. The date
7329 # is relative to the Proleptic Gregorian Calendar. This can represent:
7330 #
7331 # * A full date, with non-zero year, month and day values
7332 # * A month and day value, with a zero year, e.g. an anniversary
7333 # * A year on its own, with zero month and day values
7334 # * A year and month value, with a zero day, e.g. a credit card expiration date
7335 #
7336 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7337 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7338 # if specifying a year by itself or a year and month where the day is not
7339 # significant.
7340 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7341 # month and day.
7342 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7343 # a year.
7344 },
7345 },
7346 ],
7347 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
7348 { # A person&#x27;s locale preference.
7349 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
7350 # language tag representing the locale.
7351 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
7352 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7353 # verified field is typically a name, email address, phone number, or
7354 # website that has been confirmed to be owned by the person.
7355 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7356 # field.
7357 &quot;source&quot;: { # The source of a field. # The source of the field.
7358 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7359 #
7360 # Metadata about a source of type PROFILE.
7361 &quot;userTypes&quot;: [ # Output only. The user types.
7362 &quot;A String&quot;,
7363 ],
7364 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7365 },
7366 &quot;type&quot;: &quot;A String&quot;, # The source type.
7367 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7368 #
7369 # Last update timestamp of this source.
7370 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7371 #
7372 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7373 # source. Used for web cache validation.
7374 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7375 },
7376 },
7377 },
7378 ],
7379 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
7380 { # A person&#x27;s phone number.
7381 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
7382 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
7383 # form of the phone number.
7384 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
7385 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7386 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
7387 # predefined values:
7388 #
7389 # * `home`
7390 # * `work`
7391 # * `mobile`
7392 # * `homeFax`
7393 # * `workFax`
7394 # * `otherFax`
7395 # * `pager`
7396 # * `workMobile`
7397 # * `workPager`
7398 # * `main`
7399 # * `googleVoice`
7400 # * `other`
7401 &quot;value&quot;: &quot;A String&quot;, # The phone number.
7402 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
7403 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7404 # verified field is typically a name, email address, phone number, or
7405 # website that has been confirmed to be owned by the person.
7406 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7407 # field.
7408 &quot;source&quot;: { # The source of a field. # The source of the field.
7409 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7410 #
7411 # Metadata about a source of type PROFILE.
7412 &quot;userTypes&quot;: [ # Output only. The user types.
7413 &quot;A String&quot;,
7414 ],
7415 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7416 },
7417 &quot;type&quot;: &quot;A String&quot;, # The source type.
7418 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7419 #
7420 # Last update timestamp of this source.
7421 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7422 #
7423 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7424 # source. Used for web cache validation.
7425 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7426 },
7427 },
7428 },
7429 ],
7430 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
7431 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
7432 # communications to make voice or video calls over the internet.
7433 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
7434 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7435 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
7436 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
7437 # format.
7438 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
7439 # predefined values:
7440 #
7441 # * `home`
7442 # * `work`
7443 # * `mobile`
7444 # * `other`
7445 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
7446 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7447 # verified field is typically a name, email address, phone number, or
7448 # website that has been confirmed to be owned by the person.
7449 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7450 # field.
7451 &quot;source&quot;: { # The source of a field. # The source of the field.
7452 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7453 #
7454 # Metadata about a source of type PROFILE.
7455 &quot;userTypes&quot;: [ # Output only. The user types.
7456 &quot;A String&quot;,
7457 ],
7458 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7459 },
7460 &quot;type&quot;: &quot;A String&quot;, # The source type.
7461 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7462 #
7463 # Last update timestamp of this source.
7464 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7465 #
7466 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7467 # source. Used for web cache validation.
7468 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7469 },
7470 },
7471 },
7472 ],
7473 &quot;interests&quot;: [ # The person&#x27;s interests.
7474 { # One of the person&#x27;s interests.
7475 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
7476 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7477 # verified field is typically a name, email address, phone number, or
7478 # website that has been confirmed to be owned by the person.
7479 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7480 # field.
7481 &quot;source&quot;: { # The source of a field. # The source of the field.
7482 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7483 #
7484 # Metadata about a source of type PROFILE.
7485 &quot;userTypes&quot;: [ # Output only. The user types.
7486 &quot;A String&quot;,
7487 ],
7488 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7489 },
7490 &quot;type&quot;: &quot;A String&quot;, # The source type.
7491 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7492 #
7493 # Last update timestamp of this source.
7494 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7495 #
7496 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7497 # source. Used for web cache validation.
7498 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7499 },
7500 },
7501 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
7502 },
7503 ],
7504 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
7505 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
7506 # specified. The `date` and `text` fields typically represent the same
7507 # date, but are not guaranteed to.
7508 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
7509 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7510 # verified field is typically a name, email address, phone number, or
7511 # website that has been confirmed to be owned by the person.
7512 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7513 # field.
7514 &quot;source&quot;: { # The source of a field. # The source of the field.
7515 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7516 #
7517 # Metadata about a source of type PROFILE.
7518 &quot;userTypes&quot;: [ # Output only. The user types.
7519 &quot;A String&quot;,
7520 ],
7521 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7522 },
7523 &quot;type&quot;: &quot;A String&quot;, # The source type.
7524 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7525 #
7526 # Last update timestamp of this source.
7527 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7528 #
7529 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7530 # source. Used for web cache validation.
7531 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7532 },
7533 },
7534 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
7535 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
7536 # and time zone are either specified elsewhere or are not significant. The date
7537 # is relative to the Proleptic Gregorian Calendar. This can represent:
7538 #
7539 # * A full date, with non-zero year, month and day values
7540 # * A month and day value, with a zero year, e.g. an anniversary
7541 # * A year on its own, with zero month and day values
7542 # * A year and month value, with a zero day, e.g. a credit card expiration date
7543 #
7544 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7545 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7546 # if specifying a year by itself or a year and month where the day is not
7547 # significant.
7548 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7549 # month and day.
7550 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7551 # a year.
7552 },
7553 },
7554 ],
7555 &quot;genders&quot;: [ # The person&#x27;s genders.
7556 { # A person&#x27;s gender.
7557 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
7558 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
7559 # value are not localized.
7560 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
7561 # can be custom or one of these predefined values:
7562 #
7563 # * `male`
7564 # * `female`
7565 # * `other`
7566 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
7567 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7568 # verified field is typically a name, email address, phone number, or
7569 # website that has been confirmed to be owned by the person.
7570 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7571 # field.
7572 &quot;source&quot;: { # The source of a field. # The source of the field.
7573 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7574 #
7575 # Metadata about a source of type PROFILE.
7576 &quot;userTypes&quot;: [ # Output only. The user types.
7577 &quot;A String&quot;,
7578 ],
7579 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7580 },
7581 &quot;type&quot;: &quot;A String&quot;, # The source type.
7582 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7583 #
7584 # Last update timestamp of this source.
7585 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7586 #
7587 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7588 # source. Used for web cache validation.
7589 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7590 },
7591 },
7592 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
7593 # predefined values:
7594 #
7595 # * `male`
7596 # * `female`
7597 # * `unspecified`
7598 },
7599 ],
7600 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
7601 { # A person&#x27;s nickname.
7602 &quot;value&quot;: &quot;A String&quot;, # The nickname.
7603 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
7604 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7605 # verified field is typically a name, email address, phone number, or
7606 # website that has been confirmed to be owned by the person.
7607 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7608 # field.
7609 &quot;source&quot;: { # The source of a field. # The source of the field.
7610 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7611 #
7612 # Metadata about a source of type PROFILE.
7613 &quot;userTypes&quot;: [ # Output only. The user types.
7614 &quot;A String&quot;,
7615 ],
7616 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7617 },
7618 &quot;type&quot;: &quot;A String&quot;, # The source type.
7619 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7620 #
7621 # Last update timestamp of this source.
7622 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7623 #
7624 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7625 # source. Used for web cache validation.
7626 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7627 },
7628 },
7629 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
7630 },
7631 ],
7632 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
7633 # The person&#x27;s relationship statuses.
7634 { # **DEPRECATED**: No data will be returned
7635 # A person&#x27;s relationship status.
7636 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
7637 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7638 # verified field is typically a name, email address, phone number, or
7639 # website that has been confirmed to be owned by the person.
7640 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7641 # field.
7642 &quot;source&quot;: { # The source of a field. # The source of the field.
7643 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7644 #
7645 # Metadata about a source of type PROFILE.
7646 &quot;userTypes&quot;: [ # Output only. The user types.
7647 &quot;A String&quot;,
7648 ],
7649 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7650 },
7651 &quot;type&quot;: &quot;A String&quot;, # The source type.
7652 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7653 #
7654 # Last update timestamp of this source.
7655 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7656 #
7657 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7658 # source. Used for web cache validation.
7659 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7660 },
7661 },
7662 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
7663 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7664 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
7665 # predefined values:
7666 #
7667 # * `single`
7668 # * `inARelationship`
7669 # * `engaged`
7670 # * `married`
7671 # * `itsComplicated`
7672 # * `openRelationship`
7673 # * `widowed`
7674 # * `inDomesticPartnership`
7675 # * `inCivilUnion`
7676 },
7677 ],
7678 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
7679 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
7680 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07007681 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007682 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
7683 # `person.metadata.sources.profileMetadata.objectType` instead)
7684 #
7685 # The type of the person object.
7686 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
7687 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
7688 # that include a sync token.
7689 #
7690 # The resource name may change when adding or removing fields that link a
7691 # contact and profile such as a verified email, verified phone number, or
7692 # profile URL.
7693 &quot;A String&quot;,
7694 ],
7695 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
7696 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
7697 # that include a sync token.
7698 &quot;sources&quot;: [ # The sources of data for the person.
7699 { # The source of a field.
7700 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07007701 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007702 # Metadata about a source of type PROFILE.
7703 &quot;userTypes&quot;: [ # Output only. The user types.
7704 &quot;A String&quot;,
7705 ],
7706 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7707 },
7708 &quot;type&quot;: &quot;A String&quot;, # The source type.
7709 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07007710 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007711 # Last update timestamp of this source.
7712 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07007713 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007714 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7715 # source. Used for web cache validation.
7716 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07007717 },
7718 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007719 },
7720}
Dan O'Mearadd494642020-05-01 07:42:23 -07007721
Dan O'Mearadd494642020-05-01 07:42:23 -07007722 updatePersonFields: string, Required. A field mask to restrict which fields on the person are updated. Multiple
7723fields can be specified by separating them with commas.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07007724All updated fields will be replaced. Valid values are:
7725
7726* addresses
7727* biographies
7728* birthdays
7729* emailAddresses
7730* events
7731* genders
7732* imClients
7733* interests
7734* locales
7735* memberships
7736* names
7737* nicknames
7738* occupations
7739* organizations
7740* phoneNumbers
7741* relations
7742* residences
7743* sipAddresses
7744* urls
7745* userDefined
Bu Sun Kim65020912020-05-20 12:08:20 -07007746 x__xgafv: string, V1 error format.
7747 Allowed values
7748 1 - v1 error format
7749 2 - v2 error format
Dan O'Mearadd494642020-05-01 07:42:23 -07007750
7751Returns:
7752 An object of the form:
7753
7754 { # Information about a person merged from various data sources such as the
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007755 # authenticated user&#x27;s contacts and profile data.
7756 #
7757 # Most fields can have multiple items. The items in a field have no guaranteed
7758 # order, but each non-empty field is guaranteed to have exactly one field with
7759 # `metadata.primary` set to true.
7760 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
7761 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
7762 # are optional.
7763 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
7764 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
7765 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
7766 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
7767 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
7768 # account locale or the `Accept-Language` HTTP header locale.
7769 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
7770 # code of the address.
7771 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
7772 # values:
Dan O'Mearadd494642020-05-01 07:42:23 -07007773 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007774 # * `home`
7775 # * `work`
7776 # * `other`
7777 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
7778 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
7779 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7780 # verified field is typically a name, email address, phone number, or
7781 # website that has been confirmed to be owned by the person.
7782 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7783 # field.
7784 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07007785 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7786 #
7787 # Metadata about a source of type PROFILE.
7788 &quot;userTypes&quot;: [ # Output only. The user types.
7789 &quot;A String&quot;,
7790 ],
7791 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7792 },
7793 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007794 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7795 #
7796 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07007797 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Dan O'Mearadd494642020-05-01 07:42:23 -07007798 #
7799 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7800 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007801 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Dan O'Mearadd494642020-05-01 07:42:23 -07007802 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007803 },
7804 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
7805 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
7806 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
7807 # will be automatically constructed from structured values.
Dan O'Mearadd494642020-05-01 07:42:23 -07007808 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007809 ],
7810 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
7811 #
7812 # The person&#x27;s age range.
7813 &quot;relations&quot;: [ # The person&#x27;s relations.
7814 { # A person&#x27;s relation to another person.
7815 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
7816 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
7817 # account locale or the locale specified in the Accept-Language HTTP header.
7818 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
7819 # these predefined values:
7820 #
7821 # * `spouse`
7822 # * `child`
7823 # * `mother`
7824 # * `father`
7825 # * `parent`
7826 # * `brother`
7827 # * `sister`
7828 # * `friend`
7829 # * `relative`
7830 # * `domesticPartner`
7831 # * `manager`
7832 # * `assistant`
7833 # * `referredBy`
7834 # * `partner`
7835 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
7836 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7837 # verified field is typically a name, email address, phone number, or
7838 # website that has been confirmed to be owned by the person.
7839 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7840 # field.
7841 &quot;source&quot;: { # The source of a field. # The source of the field.
7842 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7843 #
7844 # Metadata about a source of type PROFILE.
7845 &quot;userTypes&quot;: [ # Output only. The user types.
7846 &quot;A String&quot;,
7847 ],
7848 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07007849 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007850 &quot;type&quot;: &quot;A String&quot;, # The source type.
7851 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7852 #
7853 # Last update timestamp of this source.
7854 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7855 #
7856 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7857 # source. Used for web cache validation.
7858 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07007859 },
7860 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07007861 },
7862 ],
7863 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
7864 { # A person&#x27;s past or current organization. Overlapping date ranges are
7865 # permitted.
7866 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
7867 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
7868 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
7869 # false if the organization is a past organization.
7870 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
7871 # symbol, abbreviation, or acronym.
7872 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
7873 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
7874 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
7875 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7876 # verified field is typically a name, email address, phone number, or
7877 # website that has been confirmed to be owned by the person.
7878 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7879 # field.
7880 &quot;source&quot;: { # The source of a field. # The source of the field.
7881 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7882 #
7883 # Metadata about a source of type PROFILE.
7884 &quot;userTypes&quot;: [ # Output only. The user types.
7885 &quot;A String&quot;,
7886 ],
7887 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7888 },
7889 &quot;type&quot;: &quot;A String&quot;, # The source type.
7890 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7891 #
7892 # Last update timestamp of this source.
7893 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7894 #
7895 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7896 # source. Used for web cache validation.
7897 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7898 },
7899 },
7900 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
7901 # predefined values:
7902 #
7903 # * `work`
7904 # * `school`
7905 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
7906 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
7907 # and time zone are either specified elsewhere or are not significant. The date
7908 # is relative to the Proleptic Gregorian Calendar. This can represent:
7909 #
7910 # * A full date, with non-zero year, month and day values
7911 # * A month and day value, with a zero year, e.g. an anniversary
7912 # * A year on its own, with zero month and day values
7913 # * A year and month value, with a zero day, e.g. a credit card expiration date
7914 #
7915 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7916 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7917 # if specifying a year by itself or a year and month where the day is not
7918 # significant.
7919 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7920 # month and day.
7921 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7922 # a year.
7923 },
7924 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
7925 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
7926 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
7927 # `google.com`.
7928 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
7929 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
7930 # and time zone are either specified elsewhere or are not significant. The date
7931 # is relative to the Proleptic Gregorian Calendar. This can represent:
7932 #
7933 # * A full date, with non-zero year, month and day values
7934 # * A month and day value, with a zero year, e.g. an anniversary
7935 # * A year on its own, with zero month and day values
7936 # * A year and month value, with a zero day, e.g. a credit card expiration date
7937 #
7938 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
7939 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
7940 # if specifying a year by itself or a year and month where the day is not
7941 # significant.
7942 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
7943 # month and day.
7944 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
7945 # a year.
7946 },
7947 },
7948 ],
7949 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
7950 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
7951 # profile page that represents who they are or what they care about.
7952 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
7953 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7954 # verified field is typically a name, email address, phone number, or
7955 # website that has been confirmed to be owned by the person.
7956 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7957 # field.
7958 &quot;source&quot;: { # The source of a field. # The source of the field.
7959 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7960 #
7961 # Metadata about a source of type PROFILE.
7962 &quot;userTypes&quot;: [ # Output only. The user types.
7963 &quot;A String&quot;,
7964 ],
7965 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
7966 },
7967 &quot;type&quot;: &quot;A String&quot;, # The source type.
7968 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
7969 #
7970 # Last update timestamp of this source.
7971 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
7972 #
7973 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
7974 # source. Used for web cache validation.
7975 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
7976 },
7977 },
7978 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
7979 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
7980 # false if the cover photo is a user-provided cover photo.
7981 },
7982 ],
7983 &quot;residences&quot;: [ # The person&#x27;s residences.
7984 { # A person&#x27;s past or current residence.
7985 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
7986 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
7987 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
7988 # verified field is typically a name, email address, phone number, or
7989 # website that has been confirmed to be owned by the person.
7990 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
7991 # field.
7992 &quot;source&quot;: { # The source of a field. # The source of the field.
7993 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
7994 #
7995 # Metadata about a source of type PROFILE.
7996 &quot;userTypes&quot;: [ # Output only. The user types.
7997 &quot;A String&quot;,
7998 ],
7999 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8000 },
8001 &quot;type&quot;: &quot;A String&quot;, # The source type.
8002 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8003 #
8004 # Last update timestamp of this source.
8005 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8006 #
8007 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8008 # source. Used for web cache validation.
8009 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8010 },
8011 },
8012 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
8013 # false if the residence is a past residence.
8014 },
8015 ],
8016 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
8017 { # A person&#x27;s instant messaging client.
8018 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
8019 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
8020 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8021 # verified field is typically a name, email address, phone number, or
8022 # website that has been confirmed to be owned by the person.
8023 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8024 # field.
8025 &quot;source&quot;: { # The source of a field. # The source of the field.
8026 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8027 #
8028 # Metadata about a source of type PROFILE.
8029 &quot;userTypes&quot;: [ # Output only. The user types.
8030 &quot;A String&quot;,
8031 ],
8032 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8033 },
8034 &quot;type&quot;: &quot;A String&quot;, # The source type.
8035 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8036 #
8037 # Last update timestamp of this source.
8038 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8039 #
8040 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8041 # source. Used for web cache validation.
8042 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8043 },
8044 },
8045 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
8046 # predefined values:
8047 #
8048 # * `home`
8049 # * `work`
8050 # * `other`
8051 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
8052 # predefined values:
8053 #
8054 # * `aim`
8055 # * `msn`
8056 # * `yahoo`
8057 # * `skype`
8058 # * `qq`
8059 # * `googleTalk`
8060 # * `icq`
8061 # * `jabber`
8062 # * `netMeeting`
8063 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
8064 # locale or the `Accept-Language` HTTP header locale.
8065 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
8066 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8067 },
8068 ],
8069 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
8070 { # Arbitrary user data that is populated by the end users.
8071 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
8072 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8073 # verified field is typically a name, email address, phone number, or
8074 # website that has been confirmed to be owned by the person.
8075 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8076 # field.
8077 &quot;source&quot;: { # The source of a field. # The source of the field.
8078 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8079 #
8080 # Metadata about a source of type PROFILE.
8081 &quot;userTypes&quot;: [ # Output only. The user types.
8082 &quot;A String&quot;,
8083 ],
8084 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8085 },
8086 &quot;type&quot;: &quot;A String&quot;, # The source type.
8087 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8088 #
8089 # Last update timestamp of this source.
8090 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8091 #
8092 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8093 # source. Used for web cache validation.
8094 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8095 },
8096 },
8097 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
8098 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
8099 },
8100 ],
8101 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8102 # resource. Used for web cache validation.
8103 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
8104 # The person&#x27;s bragging rights.
8105 { # **DEPRECATED**: No data will be returned
8106 # A person&#x27;s bragging rights.
8107 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
8108 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
8109 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8110 # verified field is typically a name, email address, phone number, or
8111 # website that has been confirmed to be owned by the person.
8112 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8113 # field.
8114 &quot;source&quot;: { # The source of a field. # The source of the field.
8115 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8116 #
8117 # Metadata about a source of type PROFILE.
8118 &quot;userTypes&quot;: [ # Output only. The user types.
8119 &quot;A String&quot;,
8120 ],
8121 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8122 },
8123 &quot;type&quot;: &quot;A String&quot;, # The source type.
8124 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8125 #
8126 # Last update timestamp of this source.
8127 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8128 #
8129 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8130 # source. Used for web cache validation.
8131 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8132 },
8133 },
8134 },
8135 ],
8136 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
8137 # The person&#x27;s relationship interests.
8138 { # **DEPRECATED**: No data will be returned
8139 # A person&#x27;s relationship interest .
8140 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
8141 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8142 # verified field is typically a name, email address, phone number, or
8143 # website that has been confirmed to be owned by the person.
8144 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8145 # field.
8146 &quot;source&quot;: { # The source of a field. # The source of the field.
8147 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8148 #
8149 # Metadata about a source of type PROFILE.
8150 &quot;userTypes&quot;: [ # Output only. The user types.
8151 &quot;A String&quot;,
8152 ],
8153 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8154 },
8155 &quot;type&quot;: &quot;A String&quot;, # The source type.
8156 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8157 #
8158 # Last update timestamp of this source.
8159 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8160 #
8161 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8162 # source. Used for web cache validation.
8163 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8164 },
8165 },
8166 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
8167 # in the viewer&#x27;s account locale or the locale specified in the
8168 # Accept-Language HTTP header.
8169 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
8170 # or one of these predefined values:
8171 #
8172 # * `friend`
8173 # * `date`
8174 # * `relationship`
8175 # * `networking`
8176 },
8177 ],
8178 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
8179 { # A person&#x27;s age range.
8180 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
8181 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8182 # verified field is typically a name, email address, phone number, or
8183 # website that has been confirmed to be owned by the person.
8184 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8185 # field.
8186 &quot;source&quot;: { # The source of a field. # The source of the field.
8187 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8188 #
8189 # Metadata about a source of type PROFILE.
8190 &quot;userTypes&quot;: [ # Output only. The user types.
8191 &quot;A String&quot;,
8192 ],
8193 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8194 },
8195 &quot;type&quot;: &quot;A String&quot;, # The source type.
8196 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8197 #
8198 # Last update timestamp of this source.
8199 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8200 #
8201 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8202 # source. Used for web cache validation.
8203 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8204 },
8205 },
8206 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
8207 },
8208 ],
8209 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
8210 { # A person&#x27;s membership in a group. Only contact group memberships can be
8211 # modified.
8212 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
8213 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8214 # verified field is typically a name, email address, phone number, or
8215 # website that has been confirmed to be owned by the person.
8216 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8217 # field.
8218 &quot;source&quot;: { # The source of a field. # The source of the field.
8219 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8220 #
8221 # Metadata about a source of type PROFILE.
8222 &quot;userTypes&quot;: [ # Output only. The user types.
8223 &quot;A String&quot;,
8224 ],
8225 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8226 },
8227 &quot;type&quot;: &quot;A String&quot;, # The source type.
8228 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8229 #
8230 # Last update timestamp of this source.
8231 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8232 #
8233 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8234 # source. Used for web cache validation.
8235 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8236 },
8237 },
8238 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
8239 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
8240 # string, in the form of `contactGroups/{contact_group_id}`.
8241 # Only contact_group_resource_name can be used for modifying memberships.
8242 # Any contact group membership can be removed, but only user group or
8243 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
8244 # contact must always have at least one contact group membership.
8245 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
8246 },
8247 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
8248 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
8249 },
8250 },
8251 ],
8252 &quot;occupations&quot;: [ # The person&#x27;s occupations.
8253 { # A person&#x27;s occupation.
8254 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
8255 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8256 # verified field is typically a name, email address, phone number, or
8257 # website that has been confirmed to be owned by the person.
8258 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8259 # field.
8260 &quot;source&quot;: { # The source of a field. # The source of the field.
8261 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8262 #
8263 # Metadata about a source of type PROFILE.
8264 &quot;userTypes&quot;: [ # Output only. The user types.
8265 &quot;A String&quot;,
8266 ],
8267 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8268 },
8269 &quot;type&quot;: &quot;A String&quot;, # The source type.
8270 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8271 #
8272 # Last update timestamp of this source.
8273 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8274 #
8275 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8276 # source. Used for web cache validation.
8277 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8278 },
8279 },
8280 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
8281 },
8282 ],
8283 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
8284 { # A person&#x27;s associated URLs.
8285 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
8286 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8287 # verified field is typically a name, email address, phone number, or
8288 # website that has been confirmed to be owned by the person.
8289 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8290 # field.
8291 &quot;source&quot;: { # The source of a field. # The source of the field.
8292 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8293 #
8294 # Metadata about a source of type PROFILE.
8295 &quot;userTypes&quot;: [ # Output only. The user types.
8296 &quot;A String&quot;,
8297 ],
8298 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8299 },
8300 &quot;type&quot;: &quot;A String&quot;, # The source type.
8301 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8302 #
8303 # Last update timestamp of this source.
8304 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8305 #
8306 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8307 # source. Used for web cache validation.
8308 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8309 },
8310 },
8311 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
8312 # values:
8313 #
8314 # * `home`
8315 # * `work`
8316 # * `blog`
8317 # * `profile`
8318 # * `homePage`
8319 # * `ftp`
8320 # * `reservations`
8321 # * `appInstallPage`: website for a Google+ application.
8322 # * `other`
8323 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
8324 # account locale or the `Accept-Language` HTTP header locale.
8325 &quot;value&quot;: &quot;A String&quot;, # The URL.
8326 },
8327 ],
8328 &quot;skills&quot;: [ # The person&#x27;s skills.
8329 { # A skill that the person has.
8330 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
8331 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8332 # verified field is typically a name, email address, phone number, or
8333 # website that has been confirmed to be owned by the person.
8334 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8335 # field.
8336 &quot;source&quot;: { # The source of a field. # The source of the field.
8337 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8338 #
8339 # Metadata about a source of type PROFILE.
8340 &quot;userTypes&quot;: [ # Output only. The user types.
8341 &quot;A String&quot;,
8342 ],
8343 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8344 },
8345 &quot;type&quot;: &quot;A String&quot;, # The source type.
8346 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8347 #
8348 # Last update timestamp of this source.
8349 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8350 #
8351 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8352 # source. Used for web cache validation.
8353 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8354 },
8355 },
8356 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
8357 },
8358 ],
8359 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
8360 { # A person&#x27;s email address.
8361 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
8362 # predefined values:
8363 #
8364 # * `home`
8365 # * `work`
8366 # * `other`
8367 &quot;value&quot;: &quot;A String&quot;, # The email address.
8368 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
8369 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
8370 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8371 # verified field is typically a name, email address, phone number, or
8372 # website that has been confirmed to be owned by the person.
8373 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8374 # field.
8375 &quot;source&quot;: { # The source of a field. # The source of the field.
8376 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8377 #
8378 # Metadata about a source of type PROFILE.
8379 &quot;userTypes&quot;: [ # Output only. The user types.
8380 &quot;A String&quot;,
8381 ],
8382 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8383 },
8384 &quot;type&quot;: &quot;A String&quot;, # The source type.
8385 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8386 #
8387 # Last update timestamp of this source.
8388 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8389 #
8390 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8391 # source. Used for web cache validation.
8392 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8393 },
8394 },
8395 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
8396 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8397 },
8398 ],
8399 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
8400 # The person&#x27;s taglines.
8401 { # **DEPRECATED**: No data will be returned
8402 # A brief one-line description of the person.
8403 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
8404 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8405 # verified field is typically a name, email address, phone number, or
8406 # website that has been confirmed to be owned by the person.
8407 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8408 # field.
8409 &quot;source&quot;: { # The source of a field. # The source of the field.
8410 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8411 #
8412 # Metadata about a source of type PROFILE.
8413 &quot;userTypes&quot;: [ # Output only. The user types.
8414 &quot;A String&quot;,
8415 ],
8416 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8417 },
8418 &quot;type&quot;: &quot;A String&quot;, # The source type.
8419 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8420 #
8421 # Last update timestamp of this source.
8422 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8423 #
8424 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8425 # source. Used for web cache validation.
8426 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8427 },
8428 },
8429 &quot;value&quot;: &quot;A String&quot;, # The tagline.
8430 },
8431 ],
8432 &quot;names&quot;: [ # The person&#x27;s names.
8433 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
8434 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
8435 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
8436 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
8437 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
8438 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
8439 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
8440 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
8441 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
8442 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
8443 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
8444 # the locale specified by the viewer&#x27;s account or the
8445 # `Accept-Language` HTTP header.
8446 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
8447 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
8448 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
8449 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
8450 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8451 # verified field is typically a name, email address, phone number, or
8452 # website that has been confirmed to be owned by the person.
8453 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8454 # field.
8455 &quot;source&quot;: { # The source of a field. # The source of the field.
8456 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8457 #
8458 # Metadata about a source of type PROFILE.
8459 &quot;userTypes&quot;: [ # Output only. The user types.
8460 &quot;A String&quot;,
8461 ],
8462 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8463 },
8464 &quot;type&quot;: &quot;A String&quot;, # The source type.
8465 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8466 #
8467 # Last update timestamp of this source.
8468 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8469 #
8470 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8471 # source. Used for web cache validation.
8472 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8473 },
8474 },
8475 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
8476 },
8477 ],
8478 &quot;biographies&quot;: [ # The person&#x27;s biographies.
8479 { # A person&#x27;s short biography.
8480 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
8481 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8482 # verified field is typically a name, email address, phone number, or
8483 # website that has been confirmed to be owned by the person.
8484 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8485 # field.
8486 &quot;source&quot;: { # The source of a field. # The source of the field.
8487 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8488 #
8489 # Metadata about a source of type PROFILE.
8490 &quot;userTypes&quot;: [ # Output only. The user types.
8491 &quot;A String&quot;,
8492 ],
8493 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8494 },
8495 &quot;type&quot;: &quot;A String&quot;, # The source type.
8496 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8497 #
8498 # Last update timestamp of this source.
8499 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8500 #
8501 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8502 # source. Used for web cache validation.
8503 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8504 },
8505 },
8506 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
8507 &quot;value&quot;: &quot;A String&quot;, # The short biography.
8508 },
8509 ],
8510 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
8511 # with a max length of 27 characters, in the form of
8512 # `people/{person_id}`.
8513 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
8514 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
8515 # help others recognize the person.
8516 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
8517 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8518 # verified field is typically a name, email address, phone number, or
8519 # website that has been confirmed to be owned by the person.
8520 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8521 # field.
8522 &quot;source&quot;: { # The source of a field. # The source of the field.
8523 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8524 #
8525 # Metadata about a source of type PROFILE.
8526 &quot;userTypes&quot;: [ # Output only. The user types.
8527 &quot;A String&quot;,
8528 ],
8529 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8530 },
8531 &quot;type&quot;: &quot;A String&quot;, # The source type.
8532 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8533 #
8534 # Last update timestamp of this source.
8535 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8536 #
8537 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8538 # source. Used for web cache validation.
8539 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8540 },
8541 },
8542 &quot;default&quot;: True or False, # True if the photo is a default photo;
8543 # false if the photo is a user-provided photo.
8544 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
8545 # parameter `sz={size}` at the end of the url, where {size} is the size in
8546 # pixels. Example:
8547 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
8548 },
8549 ],
8550 &quot;events&quot;: [ # The person&#x27;s events.
8551 { # An event related to the person.
8552 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
8553 # values:
8554 #
8555 # * `anniversary`
8556 # * `other`
8557 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
8558 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8559 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
8560 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8561 # verified field is typically a name, email address, phone number, or
8562 # website that has been confirmed to be owned by the person.
8563 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8564 # field.
8565 &quot;source&quot;: { # The source of a field. # The source of the field.
8566 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8567 #
8568 # Metadata about a source of type PROFILE.
8569 &quot;userTypes&quot;: [ # Output only. The user types.
8570 &quot;A String&quot;,
8571 ],
8572 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8573 },
8574 &quot;type&quot;: &quot;A String&quot;, # The source type.
8575 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8576 #
8577 # Last update timestamp of this source.
8578 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8579 #
8580 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8581 # source. Used for web cache validation.
8582 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8583 },
8584 },
8585 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
8586 # and time zone are either specified elsewhere or are not significant. The date
8587 # is relative to the Proleptic Gregorian Calendar. This can represent:
8588 #
8589 # * A full date, with non-zero year, month and day values
8590 # * A month and day value, with a zero year, e.g. an anniversary
8591 # * A year on its own, with zero month and day values
8592 # * A year and month value, with a zero day, e.g. a credit card expiration date
8593 #
8594 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
8595 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
8596 # if specifying a year by itself or a year and month where the day is not
8597 # significant.
8598 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
8599 # month and day.
8600 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
8601 # a year.
8602 },
8603 },
8604 ],
8605 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
8606 { # A person&#x27;s locale preference.
8607 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
8608 # language tag representing the locale.
8609 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
8610 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8611 # verified field is typically a name, email address, phone number, or
8612 # website that has been confirmed to be owned by the person.
8613 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8614 # field.
8615 &quot;source&quot;: { # The source of a field. # The source of the field.
8616 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8617 #
8618 # Metadata about a source of type PROFILE.
8619 &quot;userTypes&quot;: [ # Output only. The user types.
8620 &quot;A String&quot;,
8621 ],
8622 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8623 },
8624 &quot;type&quot;: &quot;A String&quot;, # The source type.
8625 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8626 #
8627 # Last update timestamp of this source.
8628 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8629 #
8630 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8631 # source. Used for web cache validation.
8632 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8633 },
8634 },
8635 },
8636 ],
8637 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
8638 { # A person&#x27;s phone number.
8639 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
8640 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
8641 # form of the phone number.
8642 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
8643 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8644 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
8645 # predefined values:
8646 #
8647 # * `home`
8648 # * `work`
8649 # * `mobile`
8650 # * `homeFax`
8651 # * `workFax`
8652 # * `otherFax`
8653 # * `pager`
8654 # * `workMobile`
8655 # * `workPager`
8656 # * `main`
8657 # * `googleVoice`
8658 # * `other`
8659 &quot;value&quot;: &quot;A String&quot;, # The phone number.
8660 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
8661 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8662 # verified field is typically a name, email address, phone number, or
8663 # website that has been confirmed to be owned by the person.
8664 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8665 # field.
8666 &quot;source&quot;: { # The source of a field. # The source of the field.
8667 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8668 #
8669 # Metadata about a source of type PROFILE.
8670 &quot;userTypes&quot;: [ # Output only. The user types.
8671 &quot;A String&quot;,
8672 ],
8673 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8674 },
8675 &quot;type&quot;: &quot;A String&quot;, # The source type.
8676 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8677 #
8678 # Last update timestamp of this source.
8679 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8680 #
8681 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8682 # source. Used for web cache validation.
8683 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8684 },
8685 },
8686 },
8687 ],
8688 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
8689 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
8690 # communications to make voice or video calls over the internet.
8691 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
8692 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8693 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
8694 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
8695 # format.
8696 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
8697 # predefined values:
8698 #
8699 # * `home`
8700 # * `work`
8701 # * `mobile`
8702 # * `other`
8703 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
8704 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8705 # verified field is typically a name, email address, phone number, or
8706 # website that has been confirmed to be owned by the person.
8707 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8708 # field.
8709 &quot;source&quot;: { # The source of a field. # The source of the field.
8710 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8711 #
8712 # Metadata about a source of type PROFILE.
8713 &quot;userTypes&quot;: [ # Output only. The user types.
8714 &quot;A String&quot;,
8715 ],
8716 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8717 },
8718 &quot;type&quot;: &quot;A String&quot;, # The source type.
8719 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8720 #
8721 # Last update timestamp of this source.
8722 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8723 #
8724 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8725 # source. Used for web cache validation.
8726 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8727 },
8728 },
8729 },
8730 ],
8731 &quot;interests&quot;: [ # The person&#x27;s interests.
8732 { # One of the person&#x27;s interests.
8733 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
8734 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8735 # verified field is typically a name, email address, phone number, or
8736 # website that has been confirmed to be owned by the person.
8737 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8738 # field.
8739 &quot;source&quot;: { # The source of a field. # The source of the field.
8740 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8741 #
8742 # Metadata about a source of type PROFILE.
8743 &quot;userTypes&quot;: [ # Output only. The user types.
8744 &quot;A String&quot;,
8745 ],
8746 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8747 },
8748 &quot;type&quot;: &quot;A String&quot;, # The source type.
8749 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8750 #
8751 # Last update timestamp of this source.
8752 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8753 #
8754 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8755 # source. Used for web cache validation.
8756 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8757 },
8758 },
8759 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
8760 },
8761 ],
8762 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
8763 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
8764 # specified. The `date` and `text` fields typically represent the same
8765 # date, but are not guaranteed to.
8766 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
8767 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8768 # verified field is typically a name, email address, phone number, or
8769 # website that has been confirmed to be owned by the person.
8770 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8771 # field.
8772 &quot;source&quot;: { # The source of a field. # The source of the field.
8773 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8774 #
8775 # Metadata about a source of type PROFILE.
8776 &quot;userTypes&quot;: [ # Output only. The user types.
8777 &quot;A String&quot;,
8778 ],
8779 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8780 },
8781 &quot;type&quot;: &quot;A String&quot;, # The source type.
8782 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8783 #
8784 # Last update timestamp of this source.
8785 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8786 #
8787 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8788 # source. Used for web cache validation.
8789 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8790 },
8791 },
8792 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
8793 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
8794 # and time zone are either specified elsewhere or are not significant. The date
8795 # is relative to the Proleptic Gregorian Calendar. This can represent:
8796 #
8797 # * A full date, with non-zero year, month and day values
8798 # * A month and day value, with a zero year, e.g. an anniversary
8799 # * A year on its own, with zero month and day values
8800 # * A year and month value, with a zero day, e.g. a credit card expiration date
8801 #
8802 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
8803 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
8804 # if specifying a year by itself or a year and month where the day is not
8805 # significant.
8806 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
8807 # month and day.
8808 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
8809 # a year.
8810 },
8811 },
8812 ],
8813 &quot;genders&quot;: [ # The person&#x27;s genders.
8814 { # A person&#x27;s gender.
8815 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
8816 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
8817 # value are not localized.
8818 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
8819 # can be custom or one of these predefined values:
8820 #
8821 # * `male`
8822 # * `female`
8823 # * `other`
8824 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
8825 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8826 # verified field is typically a name, email address, phone number, or
8827 # website that has been confirmed to be owned by the person.
8828 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8829 # field.
8830 &quot;source&quot;: { # The source of a field. # The source of the field.
8831 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8832 #
8833 # Metadata about a source of type PROFILE.
8834 &quot;userTypes&quot;: [ # Output only. The user types.
8835 &quot;A String&quot;,
8836 ],
8837 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8838 },
8839 &quot;type&quot;: &quot;A String&quot;, # The source type.
8840 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8841 #
8842 # Last update timestamp of this source.
8843 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8844 #
8845 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8846 # source. Used for web cache validation.
8847 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8848 },
8849 },
8850 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
8851 # predefined values:
8852 #
8853 # * `male`
8854 # * `female`
8855 # * `unspecified`
8856 },
8857 ],
8858 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
8859 { # A person&#x27;s nickname.
8860 &quot;value&quot;: &quot;A String&quot;, # The nickname.
8861 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
8862 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8863 # verified field is typically a name, email address, phone number, or
8864 # website that has been confirmed to be owned by the person.
8865 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8866 # field.
8867 &quot;source&quot;: { # The source of a field. # The source of the field.
8868 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8869 #
8870 # Metadata about a source of type PROFILE.
8871 &quot;userTypes&quot;: [ # Output only. The user types.
8872 &quot;A String&quot;,
8873 ],
8874 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8875 },
8876 &quot;type&quot;: &quot;A String&quot;, # The source type.
8877 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8878 #
8879 # Last update timestamp of this source.
8880 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8881 #
8882 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8883 # source. Used for web cache validation.
8884 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8885 },
8886 },
8887 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
8888 },
8889 ],
8890 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
8891 # The person&#x27;s relationship statuses.
8892 { # **DEPRECATED**: No data will be returned
8893 # A person&#x27;s relationship status.
8894 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
8895 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
8896 # verified field is typically a name, email address, phone number, or
8897 # website that has been confirmed to be owned by the person.
8898 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
8899 # field.
8900 &quot;source&quot;: { # The source of a field. # The source of the field.
8901 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
8902 #
8903 # Metadata about a source of type PROFILE.
8904 &quot;userTypes&quot;: [ # Output only. The user types.
8905 &quot;A String&quot;,
8906 ],
8907 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8908 },
8909 &quot;type&quot;: &quot;A String&quot;, # The source type.
8910 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
8911 #
8912 # Last update timestamp of this source.
8913 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
8914 #
8915 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8916 # source. Used for web cache validation.
8917 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
8918 },
8919 },
8920 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
8921 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
8922 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
8923 # predefined values:
8924 #
8925 # * `single`
8926 # * `inARelationship`
8927 # * `engaged`
8928 # * `married`
8929 # * `itsComplicated`
8930 # * `openRelationship`
8931 # * `widowed`
8932 # * `inDomesticPartnership`
8933 # * `inCivilUnion`
8934 },
8935 ],
8936 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
8937 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
8938 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -07008939 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07008940 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
8941 # `person.metadata.sources.profileMetadata.objectType` instead)
8942 #
8943 # The type of the person object.
8944 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
8945 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
8946 # that include a sync token.
8947 #
8948 # The resource name may change when adding or removing fields that link a
8949 # contact and profile such as a verified email, verified phone number, or
8950 # profile URL.
8951 &quot;A String&quot;,
8952 ],
8953 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
8954 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
8955 # that include a sync token.
8956 &quot;sources&quot;: [ # The sources of data for the person.
8957 { # The source of a field.
8958 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07008959 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07008960 # Metadata about a source of type PROFILE.
8961 &quot;userTypes&quot;: [ # Output only. The user types.
8962 &quot;A String&quot;,
8963 ],
8964 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
8965 },
8966 &quot;type&quot;: &quot;A String&quot;, # The source type.
8967 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07008968 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07008969 # Last update timestamp of this source.
8970 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -07008971 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07008972 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
8973 # source. Used for web cache validation.
8974 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07008975 },
8976 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07008977 },
8978 }</pre>
Dan O'Mearadd494642020-05-01 07:42:23 -07008979</div>
8980
8981<div class="method">
8982 <code class="details" id="updateContactPhoto">updateContactPhoto(resourceName, body=None, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -07008983 <pre>Update a contact&#x27;s photo.
Dan O'Mearadd494642020-05-01 07:42:23 -07008984
8985Args:
8986 resourceName: string, Required. Person resource name (required)
8987 body: object, The request body.
8988 The object takes the form of:
8989
Bu Sun Kim65020912020-05-20 12:08:20 -07008990{ # A request to update an existing contact&#x27;s photo.
Dan O'Mearadd494642020-05-01 07:42:23 -07008991 # All requests must have a valid photo format: JPEG or PNG.
Bu Sun Kim65020912020-05-20 12:08:20 -07008992 &quot;photoBytes&quot;: &quot;A String&quot;, # Required. Raw photo bytes
8993 &quot;personFields&quot;: &quot;A String&quot;, # Optional. A field mask to restrict which fields on the person are returned. Multiple
Dan O'Mearadd494642020-05-01 07:42:23 -07008994 # fields can be specified by separating them with commas. Defaults to empty
8995 # if not set, which will skip the post mutate get. Valid values are:
8996 #
8997 # * addresses
8998 # * ageRanges
8999 # * biographies
9000 # * birthdays
9001 # * coverPhotos
9002 # * emailAddresses
9003 # * events
9004 # * genders
9005 # * imClients
9006 # * interests
9007 # * locales
9008 # * memberships
9009 # * metadata
9010 # * names
9011 # * nicknames
9012 # * occupations
9013 # * organizations
9014 # * phoneNumbers
9015 # * photos
9016 # * relations
9017 # * residences
9018 # * sipAddresses
9019 # * skills
9020 # * urls
9021 # * userDefined
Dan O'Mearadd494642020-05-01 07:42:23 -07009022 }
9023
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009024 x__xgafv: string, V1 error format.
9025 Allowed values
9026 1 - v1 error format
9027 2 - v2 error format
9028
9029Returns:
9030 An object of the form:
9031
Bu Sun Kim65020912020-05-20 12:08:20 -07009032 { # The response for updating a contact&#x27;s photo.
9033 &quot;person&quot;: { # Information about a person merged from various data sources such as the # The updated person, if person_fields is set in the
Dan O'Mearadd494642020-05-01 07:42:23 -07009034 # UpdateContactPhotoRequest; otherwise this will be unset.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009035 # authenticated user&#x27;s contacts and profile data.
9036 #
9037 # Most fields can have multiple items. The items in a field have no guaranteed
9038 # order, but each non-empty field is guaranteed to have exactly one field with
9039 # `metadata.primary` set to true.
9040 &quot;addresses&quot;: [ # The person&#x27;s street addresses.
9041 { # A person&#x27;s physical address. May be a P.O. box or street address. All fields
9042 # are optional.
9043 &quot;region&quot;: &quot;A String&quot;, # The region of the address; for example, the state or province.
9044 &quot;country&quot;: &quot;A String&quot;, # The country of the address.
9045 &quot;extendedAddress&quot;: &quot;A String&quot;, # The extended address of the address; for example, the apartment number.
9046 &quot;poBox&quot;: &quot;A String&quot;, # The P.O. box of the address.
9047 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the address translated and formatted in the viewer&#x27;s
9048 # account locale or the `Accept-Language` HTTP header locale.
9049 &quot;countryCode&quot;: &quot;A String&quot;, # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
9050 # code of the address.
9051 &quot;type&quot;: &quot;A String&quot;, # The type of the address. The type can be custom or one of these predefined
9052 # values:
Dan O'Mearadd494642020-05-01 07:42:23 -07009053 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009054 # * `home`
9055 # * `work`
9056 # * `other`
9057 &quot;postalCode&quot;: &quot;A String&quot;, # The postal code of the address.
9058 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the address.
9059 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9060 # verified field is typically a name, email address, phone number, or
9061 # website that has been confirmed to be owned by the person.
9062 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9063 # field.
9064 &quot;source&quot;: { # The source of a field. # The source of the field.
Bu Sun Kim65020912020-05-20 12:08:20 -07009065 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9066 #
9067 # Metadata about a source of type PROFILE.
9068 &quot;userTypes&quot;: [ # Output only. The user types.
9069 &quot;A String&quot;,
9070 ],
9071 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9072 },
9073 &quot;type&quot;: &quot;A String&quot;, # The source type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009074 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9075 #
9076 # Last update timestamp of this source.
Bu Sun Kim65020912020-05-20 12:08:20 -07009077 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009078 #
9079 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9080 # source. Used for web cache validation.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009081 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009082 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009083 },
9084 &quot;streetAddress&quot;: &quot;A String&quot;, # The street address.
9085 &quot;city&quot;: &quot;A String&quot;, # The city of the address.
9086 &quot;formattedValue&quot;: &quot;A String&quot;, # The unstructured value of the address. If this is not set by the user it
9087 # will be automatically constructed from structured values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07009088 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009089 ],
9090 &quot;ageRange&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
9091 #
9092 # The person&#x27;s age range.
9093 &quot;relations&quot;: [ # The person&#x27;s relations.
9094 { # A person&#x27;s relation to another person.
9095 &quot;person&quot;: &quot;A String&quot;, # The name of the other person this relation refers to.
9096 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the relation translated and formatted in the viewer&#x27;s
9097 # account locale or the locale specified in the Accept-Language HTTP header.
9098 &quot;type&quot;: &quot;A String&quot;, # The person&#x27;s relation to the other person. The type can be custom or one of
9099 # these predefined values:
9100 #
9101 # * `spouse`
9102 # * `child`
9103 # * `mother`
9104 # * `father`
9105 # * `parent`
9106 # * `brother`
9107 # * `sister`
9108 # * `friend`
9109 # * `relative`
9110 # * `domesticPartner`
9111 # * `manager`
9112 # * `assistant`
9113 # * `referredBy`
9114 # * `partner`
9115 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relation.
9116 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9117 # verified field is typically a name, email address, phone number, or
9118 # website that has been confirmed to be owned by the person.
9119 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9120 # field.
9121 &quot;source&quot;: { # The source of a field. # The source of the field.
9122 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9123 #
9124 # Metadata about a source of type PROFILE.
9125 &quot;userTypes&quot;: [ # Output only. The user types.
9126 &quot;A String&quot;,
9127 ],
9128 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
Bu Sun Kim65020912020-05-20 12:08:20 -07009129 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009130 &quot;type&quot;: &quot;A String&quot;, # The source type.
9131 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9132 #
9133 # Last update timestamp of this source.
9134 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9135 #
9136 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9137 # source. Used for web cache validation.
9138 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -07009139 },
9140 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -07009141 },
9142 ],
9143 &quot;organizations&quot;: [ # The person&#x27;s past or current organizations.
9144 { # A person&#x27;s past or current organization. Overlapping date ranges are
9145 # permitted.
9146 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the organization translated and formatted in the
9147 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9148 &quot;current&quot;: True or False, # True if the organization is the person&#x27;s current organization;
9149 # false if the organization is a past organization.
9150 &quot;symbol&quot;: &quot;A String&quot;, # The symbol associated with the organization; for example, a stock ticker
9151 # symbol, abbreviation, or acronym.
9152 &quot;phoneticName&quot;: &quot;A String&quot;, # The phonetic name of the organization.
9153 &quot;title&quot;: &quot;A String&quot;, # The person&#x27;s job title at the organization.
9154 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the organization.
9155 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9156 # verified field is typically a name, email address, phone number, or
9157 # website that has been confirmed to be owned by the person.
9158 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9159 # field.
9160 &quot;source&quot;: { # The source of a field. # The source of the field.
9161 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9162 #
9163 # Metadata about a source of type PROFILE.
9164 &quot;userTypes&quot;: [ # Output only. The user types.
9165 &quot;A String&quot;,
9166 ],
9167 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9168 },
9169 &quot;type&quot;: &quot;A String&quot;, # The source type.
9170 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9171 #
9172 # Last update timestamp of this source.
9173 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9174 #
9175 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9176 # source. Used for web cache validation.
9177 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9178 },
9179 },
9180 &quot;type&quot;: &quot;A String&quot;, # The type of the organization. The type can be custom or one of these
9181 # predefined values:
9182 #
9183 # * `work`
9184 # * `school`
9185 &quot;name&quot;: &quot;A String&quot;, # The name of the organization.
9186 &quot;endDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The end date when the person left the organization.
9187 # and time zone are either specified elsewhere or are not significant. The date
9188 # is relative to the Proleptic Gregorian Calendar. This can represent:
9189 #
9190 # * A full date, with non-zero year, month and day values
9191 # * A month and day value, with a zero year, e.g. an anniversary
9192 # * A year on its own, with zero month and day values
9193 # * A year and month value, with a zero day, e.g. a credit card expiration date
9194 #
9195 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9196 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9197 # if specifying a year by itself or a year and month where the day is not
9198 # significant.
9199 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9200 # month and day.
9201 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9202 # a year.
9203 },
9204 &quot;location&quot;: &quot;A String&quot;, # The location of the organization office the person works at.
9205 &quot;department&quot;: &quot;A String&quot;, # The person&#x27;s department at the organization.
9206 &quot;domain&quot;: &quot;A String&quot;, # The domain name associated with the organization; for example,
9207 # `google.com`.
9208 &quot;jobDescription&quot;: &quot;A String&quot;, # The person&#x27;s job description at the organization.
9209 &quot;startDate&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The start date when the person joined the organization.
9210 # and time zone are either specified elsewhere or are not significant. The date
9211 # is relative to the Proleptic Gregorian Calendar. This can represent:
9212 #
9213 # * A full date, with non-zero year, month and day values
9214 # * A month and day value, with a zero year, e.g. an anniversary
9215 # * A year on its own, with zero month and day values
9216 # * A year and month value, with a zero day, e.g. a credit card expiration date
9217 #
9218 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9219 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9220 # if specifying a year by itself or a year and month where the day is not
9221 # significant.
9222 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9223 # month and day.
9224 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9225 # a year.
9226 },
9227 },
9228 ],
9229 &quot;coverPhotos&quot;: [ # Output only. The person&#x27;s cover photos.
9230 { # A person&#x27;s cover photo. A large image shown on the person&#x27;s
9231 # profile page that represents who they are or what they care about.
9232 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the cover photo.
9233 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9234 # verified field is typically a name, email address, phone number, or
9235 # website that has been confirmed to be owned by the person.
9236 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9237 # field.
9238 &quot;source&quot;: { # The source of a field. # The source of the field.
9239 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9240 #
9241 # Metadata about a source of type PROFILE.
9242 &quot;userTypes&quot;: [ # Output only. The user types.
9243 &quot;A String&quot;,
9244 ],
9245 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9246 },
9247 &quot;type&quot;: &quot;A String&quot;, # The source type.
9248 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9249 #
9250 # Last update timestamp of this source.
9251 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9252 #
9253 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9254 # source. Used for web cache validation.
9255 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9256 },
9257 },
9258 &quot;url&quot;: &quot;A String&quot;, # The URL of the cover photo.
9259 &quot;default&quot;: True or False, # True if the cover photo is the default cover photo;
9260 # false if the cover photo is a user-provided cover photo.
9261 },
9262 ],
9263 &quot;residences&quot;: [ # The person&#x27;s residences.
9264 { # A person&#x27;s past or current residence.
9265 &quot;value&quot;: &quot;A String&quot;, # The address of the residence.
9266 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the residence.
9267 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9268 # verified field is typically a name, email address, phone number, or
9269 # website that has been confirmed to be owned by the person.
9270 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9271 # field.
9272 &quot;source&quot;: { # The source of a field. # The source of the field.
9273 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9274 #
9275 # Metadata about a source of type PROFILE.
9276 &quot;userTypes&quot;: [ # Output only. The user types.
9277 &quot;A String&quot;,
9278 ],
9279 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9280 },
9281 &quot;type&quot;: &quot;A String&quot;, # The source type.
9282 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9283 #
9284 # Last update timestamp of this source.
9285 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9286 #
9287 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9288 # source. Used for web cache validation.
9289 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9290 },
9291 },
9292 &quot;current&quot;: True or False, # True if the residence is the person&#x27;s current residence;
9293 # false if the residence is a past residence.
9294 },
9295 ],
9296 &quot;imClients&quot;: [ # The person&#x27;s instant messaging clients.
9297 { # A person&#x27;s instant messaging client.
9298 &quot;username&quot;: &quot;A String&quot;, # The user name used in the IM client.
9299 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the IM client.
9300 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9301 # verified field is typically a name, email address, phone number, or
9302 # website that has been confirmed to be owned by the person.
9303 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9304 # field.
9305 &quot;source&quot;: { # The source of a field. # The source of the field.
9306 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9307 #
9308 # Metadata about a source of type PROFILE.
9309 &quot;userTypes&quot;: [ # Output only. The user types.
9310 &quot;A String&quot;,
9311 ],
9312 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9313 },
9314 &quot;type&quot;: &quot;A String&quot;, # The source type.
9315 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9316 #
9317 # Last update timestamp of this source.
9318 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9319 #
9320 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9321 # source. Used for web cache validation.
9322 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9323 },
9324 },
9325 &quot;type&quot;: &quot;A String&quot;, # The type of the IM client. The type can be custom or one of these
9326 # predefined values:
9327 #
9328 # * `home`
9329 # * `work`
9330 # * `other`
9331 &quot;protocol&quot;: &quot;A String&quot;, # The protocol of the IM client. The protocol can be custom or one of these
9332 # predefined values:
9333 #
9334 # * `aim`
9335 # * `msn`
9336 # * `yahoo`
9337 # * `skype`
9338 # * `qq`
9339 # * `googleTalk`
9340 # * `icq`
9341 # * `jabber`
9342 # * `netMeeting`
9343 &quot;formattedProtocol&quot;: &quot;A String&quot;, # Output only. The protocol of the IM client formatted in the viewer&#x27;s account
9344 # locale or the `Accept-Language` HTTP header locale.
9345 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the IM client translated and formatted in the
9346 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9347 },
9348 ],
9349 &quot;userDefined&quot;: [ # The person&#x27;s user defined data.
9350 { # Arbitrary user data that is populated by the end users.
9351 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the user defined data.
9352 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9353 # verified field is typically a name, email address, phone number, or
9354 # website that has been confirmed to be owned by the person.
9355 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9356 # field.
9357 &quot;source&quot;: { # The source of a field. # The source of the field.
9358 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9359 #
9360 # Metadata about a source of type PROFILE.
9361 &quot;userTypes&quot;: [ # Output only. The user types.
9362 &quot;A String&quot;,
9363 ],
9364 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9365 },
9366 &quot;type&quot;: &quot;A String&quot;, # The source type.
9367 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9368 #
9369 # Last update timestamp of this source.
9370 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9371 #
9372 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9373 # source. Used for web cache validation.
9374 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9375 },
9376 },
9377 &quot;value&quot;: &quot;A String&quot;, # The end user specified value of the user defined data.
9378 &quot;key&quot;: &quot;A String&quot;, # The end user specified key of the user defined data.
9379 },
9380 ],
9381 &quot;etag&quot;: &quot;A String&quot;, # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9382 # resource. Used for web cache validation.
9383 &quot;braggingRights&quot;: [ # **DEPRECATED**: No data will be returned
9384 # The person&#x27;s bragging rights.
9385 { # **DEPRECATED**: No data will be returned
9386 # A person&#x27;s bragging rights.
9387 &quot;value&quot;: &quot;A String&quot;, # The bragging rights; for example, `climbed mount everest`.
9388 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the bragging rights.
9389 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9390 # verified field is typically a name, email address, phone number, or
9391 # website that has been confirmed to be owned by the person.
9392 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9393 # field.
9394 &quot;source&quot;: { # The source of a field. # The source of the field.
9395 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9396 #
9397 # Metadata about a source of type PROFILE.
9398 &quot;userTypes&quot;: [ # Output only. The user types.
9399 &quot;A String&quot;,
9400 ],
9401 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9402 },
9403 &quot;type&quot;: &quot;A String&quot;, # The source type.
9404 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9405 #
9406 # Last update timestamp of this source.
9407 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9408 #
9409 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9410 # source. Used for web cache validation.
9411 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9412 },
9413 },
9414 },
9415 ],
9416 &quot;relationshipInterests&quot;: [ # Output only. **DEPRECATED**: No data will be returned
9417 # The person&#x27;s relationship interests.
9418 { # **DEPRECATED**: No data will be returned
9419 # A person&#x27;s relationship interest .
9420 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship interest.
9421 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9422 # verified field is typically a name, email address, phone number, or
9423 # website that has been confirmed to be owned by the person.
9424 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9425 # field.
9426 &quot;source&quot;: { # The source of a field. # The source of the field.
9427 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9428 #
9429 # Metadata about a source of type PROFILE.
9430 &quot;userTypes&quot;: [ # Output only. The user types.
9431 &quot;A String&quot;,
9432 ],
9433 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9434 },
9435 &quot;type&quot;: &quot;A String&quot;, # The source type.
9436 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9437 #
9438 # Last update timestamp of this source.
9439 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9440 #
9441 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9442 # source. Used for web cache validation.
9443 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9444 },
9445 },
9446 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship interest translated and formatted
9447 # in the viewer&#x27;s account locale or the locale specified in the
9448 # Accept-Language HTTP header.
9449 &quot;value&quot;: &quot;A String&quot;, # The kind of relationship the person is looking for. The value can be custom
9450 # or one of these predefined values:
9451 #
9452 # * `friend`
9453 # * `date`
9454 # * `relationship`
9455 # * `networking`
9456 },
9457 ],
9458 &quot;ageRanges&quot;: [ # Output only. The person&#x27;s age ranges.
9459 { # A person&#x27;s age range.
9460 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the age range.
9461 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9462 # verified field is typically a name, email address, phone number, or
9463 # website that has been confirmed to be owned by the person.
9464 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9465 # field.
9466 &quot;source&quot;: { # The source of a field. # The source of the field.
9467 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9468 #
9469 # Metadata about a source of type PROFILE.
9470 &quot;userTypes&quot;: [ # Output only. The user types.
9471 &quot;A String&quot;,
9472 ],
9473 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9474 },
9475 &quot;type&quot;: &quot;A String&quot;, # The source type.
9476 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9477 #
9478 # Last update timestamp of this source.
9479 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9480 #
9481 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9482 # source. Used for web cache validation.
9483 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9484 },
9485 },
9486 &quot;ageRange&quot;: &quot;A String&quot;, # The age range.
9487 },
9488 ],
9489 &quot;memberships&quot;: [ # The person&#x27;s group memberships.
9490 { # A person&#x27;s membership in a group. Only contact group memberships can be
9491 # modified.
9492 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the membership.
9493 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9494 # verified field is typically a name, email address, phone number, or
9495 # website that has been confirmed to be owned by the person.
9496 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9497 # field.
9498 &quot;source&quot;: { # The source of a field. # The source of the field.
9499 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9500 #
9501 # Metadata about a source of type PROFILE.
9502 &quot;userTypes&quot;: [ # Output only. The user types.
9503 &quot;A String&quot;,
9504 ],
9505 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9506 },
9507 &quot;type&quot;: &quot;A String&quot;, # The source type.
9508 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9509 #
9510 # Last update timestamp of this source.
9511 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9512 #
9513 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9514 # source. Used for web cache validation.
9515 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9516 },
9517 },
9518 &quot;contactGroupMembership&quot;: { # A Google contact group membership. # The contact group membership.
9519 &quot;contactGroupResourceName&quot;: &quot;A String&quot;, # The resource name for the contact group, assigned by the server. An ASCII
9520 # string, in the form of `contactGroups/{contact_group_id}`.
9521 # Only contact_group_resource_name can be used for modifying memberships.
9522 # Any contact group membership can be removed, but only user group or
9523 # &quot;myContacts&quot; or &quot;starred&quot; system groups memberships can be added. A
9524 # contact must always have at least one contact group membership.
9525 &quot;contactGroupId&quot;: &quot;A String&quot;, # Output only. The contact group ID for the contact group membership.
9526 },
9527 &quot;domainMembership&quot;: { # A G Suite Domain membership. # Output only. The domain membership.
9528 &quot;inViewerDomain&quot;: True or False, # True if the person is in the viewer&#x27;s G Suite domain.
9529 },
9530 },
9531 ],
9532 &quot;occupations&quot;: [ # The person&#x27;s occupations.
9533 { # A person&#x27;s occupation.
9534 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the occupation.
9535 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9536 # verified field is typically a name, email address, phone number, or
9537 # website that has been confirmed to be owned by the person.
9538 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9539 # field.
9540 &quot;source&quot;: { # The source of a field. # The source of the field.
9541 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9542 #
9543 # Metadata about a source of type PROFILE.
9544 &quot;userTypes&quot;: [ # Output only. The user types.
9545 &quot;A String&quot;,
9546 ],
9547 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9548 },
9549 &quot;type&quot;: &quot;A String&quot;, # The source type.
9550 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9551 #
9552 # Last update timestamp of this source.
9553 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9554 #
9555 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9556 # source. Used for web cache validation.
9557 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9558 },
9559 },
9560 &quot;value&quot;: &quot;A String&quot;, # The occupation; for example, `carpenter`.
9561 },
9562 ],
9563 &quot;urls&quot;: [ # The person&#x27;s associated URLs.
9564 { # A person&#x27;s associated URLs.
9565 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the URL.
9566 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9567 # verified field is typically a name, email address, phone number, or
9568 # website that has been confirmed to be owned by the person.
9569 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9570 # field.
9571 &quot;source&quot;: { # The source of a field. # The source of the field.
9572 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9573 #
9574 # Metadata about a source of type PROFILE.
9575 &quot;userTypes&quot;: [ # Output only. The user types.
9576 &quot;A String&quot;,
9577 ],
9578 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9579 },
9580 &quot;type&quot;: &quot;A String&quot;, # The source type.
9581 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9582 #
9583 # Last update timestamp of this source.
9584 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9585 #
9586 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9587 # source. Used for web cache validation.
9588 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9589 },
9590 },
9591 &quot;type&quot;: &quot;A String&quot;, # The type of the URL. The type can be custom or one of these predefined
9592 # values:
9593 #
9594 # * `home`
9595 # * `work`
9596 # * `blog`
9597 # * `profile`
9598 # * `homePage`
9599 # * `ftp`
9600 # * `reservations`
9601 # * `appInstallPage`: website for a Google+ application.
9602 # * `other`
9603 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the URL translated and formatted in the viewer&#x27;s
9604 # account locale or the `Accept-Language` HTTP header locale.
9605 &quot;value&quot;: &quot;A String&quot;, # The URL.
9606 },
9607 ],
9608 &quot;skills&quot;: [ # The person&#x27;s skills.
9609 { # A skill that the person has.
9610 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the skill.
9611 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9612 # verified field is typically a name, email address, phone number, or
9613 # website that has been confirmed to be owned by the person.
9614 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9615 # field.
9616 &quot;source&quot;: { # The source of a field. # The source of the field.
9617 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9618 #
9619 # Metadata about a source of type PROFILE.
9620 &quot;userTypes&quot;: [ # Output only. The user types.
9621 &quot;A String&quot;,
9622 ],
9623 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9624 },
9625 &quot;type&quot;: &quot;A String&quot;, # The source type.
9626 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9627 #
9628 # Last update timestamp of this source.
9629 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9630 #
9631 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9632 # source. Used for web cache validation.
9633 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9634 },
9635 },
9636 &quot;value&quot;: &quot;A String&quot;, # The skill; for example, `underwater basket weaving`.
9637 },
9638 ],
9639 &quot;emailAddresses&quot;: [ # The person&#x27;s email addresses.
9640 { # A person&#x27;s email address.
9641 &quot;type&quot;: &quot;A String&quot;, # The type of the email address. The type can be custom or one of these
9642 # predefined values:
9643 #
9644 # * `home`
9645 # * `work`
9646 # * `other`
9647 &quot;value&quot;: &quot;A String&quot;, # The email address.
9648 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the email.
9649 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the email address.
9650 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9651 # verified field is typically a name, email address, phone number, or
9652 # website that has been confirmed to be owned by the person.
9653 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9654 # field.
9655 &quot;source&quot;: { # The source of a field. # The source of the field.
9656 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9657 #
9658 # Metadata about a source of type PROFILE.
9659 &quot;userTypes&quot;: [ # Output only. The user types.
9660 &quot;A String&quot;,
9661 ],
9662 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9663 },
9664 &quot;type&quot;: &quot;A String&quot;, # The source type.
9665 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9666 #
9667 # Last update timestamp of this source.
9668 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9669 #
9670 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9671 # source. Used for web cache validation.
9672 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9673 },
9674 },
9675 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the email address translated and formatted in the
9676 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9677 },
9678 ],
9679 &quot;taglines&quot;: [ # Output only. **DEPRECATED**: No data will be returned
9680 # The person&#x27;s taglines.
9681 { # **DEPRECATED**: No data will be returned
9682 # A brief one-line description of the person.
9683 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the tagline.
9684 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9685 # verified field is typically a name, email address, phone number, or
9686 # website that has been confirmed to be owned by the person.
9687 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9688 # field.
9689 &quot;source&quot;: { # The source of a field. # The source of the field.
9690 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9691 #
9692 # Metadata about a source of type PROFILE.
9693 &quot;userTypes&quot;: [ # Output only. The user types.
9694 &quot;A String&quot;,
9695 ],
9696 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9697 },
9698 &quot;type&quot;: &quot;A String&quot;, # The source type.
9699 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9700 #
9701 # Last update timestamp of this source.
9702 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9703 #
9704 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9705 # source. Used for web cache validation.
9706 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9707 },
9708 },
9709 &quot;value&quot;: &quot;A String&quot;, # The tagline.
9710 },
9711 ],
9712 &quot;names&quot;: [ # The person&#x27;s names.
9713 { # A person&#x27;s name. If the name is a mononym, the family name is empty.
9714 &quot;phoneticHonorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes spelled as they sound.
9715 &quot;givenName&quot;: &quot;A String&quot;, # The given name.
9716 &quot;familyName&quot;: &quot;A String&quot;, # The family name.
9717 &quot;middleName&quot;: &quot;A String&quot;, # The middle name(s).
9718 &quot;phoneticMiddleName&quot;: &quot;A String&quot;, # The middle name(s) spelled as they sound.
9719 &quot;honorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes, such as `Jr.`
9720 &quot;phoneticGivenName&quot;: &quot;A String&quot;, # The given name spelled as it sounds.
9721 &quot;phoneticFamilyName&quot;: &quot;A String&quot;, # The family name spelled as it sounds.
9722 &quot;honorificPrefix&quot;: &quot;A String&quot;, # The honorific prefixes, such as `Mrs.` or `Dr.`
9723 &quot;displayNameLastFirst&quot;: &quot;A String&quot;, # Output only. The display name with the last name first formatted according to
9724 # the locale specified by the viewer&#x27;s account or the
9725 # `Accept-Language` HTTP header.
9726 &quot;phoneticFullName&quot;: &quot;A String&quot;, # The full name spelled as it sounds.
9727 &quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name formatted according to the locale specified by
9728 # the viewer&#x27;s account or the `Accept-Language` HTTP header.
9729 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the name.
9730 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9731 # verified field is typically a name, email address, phone number, or
9732 # website that has been confirmed to be owned by the person.
9733 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9734 # field.
9735 &quot;source&quot;: { # The source of a field. # The source of the field.
9736 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9737 #
9738 # Metadata about a source of type PROFILE.
9739 &quot;userTypes&quot;: [ # Output only. The user types.
9740 &quot;A String&quot;,
9741 ],
9742 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9743 },
9744 &quot;type&quot;: &quot;A String&quot;, # The source type.
9745 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9746 #
9747 # Last update timestamp of this source.
9748 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9749 #
9750 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9751 # source. Used for web cache validation.
9752 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9753 },
9754 },
9755 &quot;phoneticHonorificSuffix&quot;: &quot;A String&quot;, # The honorific suffixes spelled as they sound.
9756 },
9757 ],
9758 &quot;biographies&quot;: [ # The person&#x27;s biographies.
9759 { # A person&#x27;s short biography.
9760 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the biography.
9761 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9762 # verified field is typically a name, email address, phone number, or
9763 # website that has been confirmed to be owned by the person.
9764 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9765 # field.
9766 &quot;source&quot;: { # The source of a field. # The source of the field.
9767 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9768 #
9769 # Metadata about a source of type PROFILE.
9770 &quot;userTypes&quot;: [ # Output only. The user types.
9771 &quot;A String&quot;,
9772 ],
9773 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9774 },
9775 &quot;type&quot;: &quot;A String&quot;, # The source type.
9776 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9777 #
9778 # Last update timestamp of this source.
9779 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9780 #
9781 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9782 # source. Used for web cache validation.
9783 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9784 },
9785 },
9786 &quot;contentType&quot;: &quot;A String&quot;, # The content type of the biography.
9787 &quot;value&quot;: &quot;A String&quot;, # The short biography.
9788 },
9789 ],
9790 &quot;resourceName&quot;: &quot;A String&quot;, # The resource name for the person, assigned by the server. An ASCII string
9791 # with a max length of 27 characters, in the form of
9792 # `people/{person_id}`.
9793 &quot;photos&quot;: [ # Output only. The person&#x27;s photos.
9794 { # A person&#x27;s photo. A picture shown next to the person&#x27;s name to
9795 # help others recognize the person.
9796 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the photo.
9797 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9798 # verified field is typically a name, email address, phone number, or
9799 # website that has been confirmed to be owned by the person.
9800 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9801 # field.
9802 &quot;source&quot;: { # The source of a field. # The source of the field.
9803 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9804 #
9805 # Metadata about a source of type PROFILE.
9806 &quot;userTypes&quot;: [ # Output only. The user types.
9807 &quot;A String&quot;,
9808 ],
9809 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9810 },
9811 &quot;type&quot;: &quot;A String&quot;, # The source type.
9812 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9813 #
9814 # Last update timestamp of this source.
9815 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9816 #
9817 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9818 # source. Used for web cache validation.
9819 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9820 },
9821 },
9822 &quot;default&quot;: True or False, # True if the photo is a default photo;
9823 # false if the photo is a user-provided photo.
9824 &quot;url&quot;: &quot;A String&quot;, # The URL of the photo. You can change the desired size by appending a query
9825 # parameter `sz={size}` at the end of the url, where {size} is the size in
9826 # pixels. Example:
9827 # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
9828 },
9829 ],
9830 &quot;events&quot;: [ # The person&#x27;s events.
9831 { # An event related to the person.
9832 &quot;type&quot;: &quot;A String&quot;, # The type of the event. The type can be custom or one of these predefined
9833 # values:
9834 #
9835 # * `anniversary`
9836 # * `other`
9837 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the event translated and formatted in the
9838 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9839 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the event.
9840 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9841 # verified field is typically a name, email address, phone number, or
9842 # website that has been confirmed to be owned by the person.
9843 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9844 # field.
9845 &quot;source&quot;: { # The source of a field. # The source of the field.
9846 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9847 #
9848 # Metadata about a source of type PROFILE.
9849 &quot;userTypes&quot;: [ # Output only. The user types.
9850 &quot;A String&quot;,
9851 ],
9852 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9853 },
9854 &quot;type&quot;: &quot;A String&quot;, # The source type.
9855 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9856 #
9857 # Last update timestamp of this source.
9858 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9859 #
9860 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9861 # source. Used for web cache validation.
9862 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9863 },
9864 },
9865 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the event.
9866 # and time zone are either specified elsewhere or are not significant. The date
9867 # is relative to the Proleptic Gregorian Calendar. This can represent:
9868 #
9869 # * A full date, with non-zero year, month and day values
9870 # * A month and day value, with a zero year, e.g. an anniversary
9871 # * A year on its own, with zero month and day values
9872 # * A year and month value, with a zero day, e.g. a credit card expiration date
9873 #
9874 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
9875 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
9876 # if specifying a year by itself or a year and month where the day is not
9877 # significant.
9878 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
9879 # month and day.
9880 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
9881 # a year.
9882 },
9883 },
9884 ],
9885 &quot;locales&quot;: [ # The person&#x27;s locale preferences.
9886 { # A person&#x27;s locale preference.
9887 &quot;value&quot;: &quot;A String&quot;, # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
9888 # language tag representing the locale.
9889 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the locale.
9890 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9891 # verified field is typically a name, email address, phone number, or
9892 # website that has been confirmed to be owned by the person.
9893 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9894 # field.
9895 &quot;source&quot;: { # The source of a field. # The source of the field.
9896 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9897 #
9898 # Metadata about a source of type PROFILE.
9899 &quot;userTypes&quot;: [ # Output only. The user types.
9900 &quot;A String&quot;,
9901 ],
9902 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9903 },
9904 &quot;type&quot;: &quot;A String&quot;, # The source type.
9905 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9906 #
9907 # Last update timestamp of this source.
9908 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9909 #
9910 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9911 # source. Used for web cache validation.
9912 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9913 },
9914 },
9915 },
9916 ],
9917 &quot;phoneNumbers&quot;: [ # The person&#x27;s phone numbers.
9918 { # A person&#x27;s phone number.
9919 &quot;canonicalForm&quot;: &quot;A String&quot;, # Output only. The canonicalized [ITU-T
9920 # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
9921 # form of the phone number.
9922 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the phone number translated and formatted in the
9923 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9924 &quot;type&quot;: &quot;A String&quot;, # The type of the phone number. The type can be custom or one of these
9925 # predefined values:
9926 #
9927 # * `home`
9928 # * `work`
9929 # * `mobile`
9930 # * `homeFax`
9931 # * `workFax`
9932 # * `otherFax`
9933 # * `pager`
9934 # * `workMobile`
9935 # * `workPager`
9936 # * `main`
9937 # * `googleVoice`
9938 # * `other`
9939 &quot;value&quot;: &quot;A String&quot;, # The phone number.
9940 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the phone number.
9941 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9942 # verified field is typically a name, email address, phone number, or
9943 # website that has been confirmed to be owned by the person.
9944 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9945 # field.
9946 &quot;source&quot;: { # The source of a field. # The source of the field.
9947 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9948 #
9949 # Metadata about a source of type PROFILE.
9950 &quot;userTypes&quot;: [ # Output only. The user types.
9951 &quot;A String&quot;,
9952 ],
9953 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9954 },
9955 &quot;type&quot;: &quot;A String&quot;, # The source type.
9956 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
9957 #
9958 # Last update timestamp of this source.
9959 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
9960 #
9961 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
9962 # source. Used for web cache validation.
9963 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
9964 },
9965 },
9966 },
9967 ],
9968 &quot;sipAddresses&quot;: [ # The person&#x27;s SIP addresses.
9969 { # A person&#x27;s SIP address. Session Initial Protocol addresses are used for VoIP
9970 # communications to make voice or video calls over the internet.
9971 &quot;formattedType&quot;: &quot;A String&quot;, # Output only. The type of the SIP address translated and formatted in the
9972 # viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
9973 &quot;value&quot;: &quot;A String&quot;, # The SIP address in the
9974 # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
9975 # format.
9976 &quot;type&quot;: &quot;A String&quot;, # The type of the SIP address. The type can be custom or or one of these
9977 # predefined values:
9978 #
9979 # * `home`
9980 # * `work`
9981 # * `mobile`
9982 # * `other`
9983 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the SIP address.
9984 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
9985 # verified field is typically a name, email address, phone number, or
9986 # website that has been confirmed to be owned by the person.
9987 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
9988 # field.
9989 &quot;source&quot;: { # The source of a field. # The source of the field.
9990 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
9991 #
9992 # Metadata about a source of type PROFILE.
9993 &quot;userTypes&quot;: [ # Output only. The user types.
9994 &quot;A String&quot;,
9995 ],
9996 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
9997 },
9998 &quot;type&quot;: &quot;A String&quot;, # The source type.
9999 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10000 #
10001 # Last update timestamp of this source.
10002 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10003 #
10004 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10005 # source. Used for web cache validation.
10006 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10007 },
10008 },
10009 },
10010 ],
10011 &quot;interests&quot;: [ # The person&#x27;s interests.
10012 { # One of the person&#x27;s interests.
10013 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the interest.
10014 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
10015 # verified field is typically a name, email address, phone number, or
10016 # website that has been confirmed to be owned by the person.
10017 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
10018 # field.
10019 &quot;source&quot;: { # The source of a field. # The source of the field.
10020 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
10021 #
10022 # Metadata about a source of type PROFILE.
10023 &quot;userTypes&quot;: [ # Output only. The user types.
10024 &quot;A String&quot;,
10025 ],
10026 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10027 },
10028 &quot;type&quot;: &quot;A String&quot;, # The source type.
10029 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10030 #
10031 # Last update timestamp of this source.
10032 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10033 #
10034 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10035 # source. Used for web cache validation.
10036 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10037 },
10038 },
10039 &quot;value&quot;: &quot;A String&quot;, # The interest; for example, `stargazing`.
10040 },
10041 ],
10042 &quot;birthdays&quot;: [ # The person&#x27;s birthdays.
10043 { # A person&#x27;s birthday. At least one of the `date` and `text` fields are
10044 # specified. The `date` and `text` fields typically represent the same
10045 # date, but are not guaranteed to.
10046 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the birthday.
10047 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
10048 # verified field is typically a name, email address, phone number, or
10049 # website that has been confirmed to be owned by the person.
10050 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
10051 # field.
10052 &quot;source&quot;: { # The source of a field. # The source of the field.
10053 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
10054 #
10055 # Metadata about a source of type PROFILE.
10056 &quot;userTypes&quot;: [ # Output only. The user types.
10057 &quot;A String&quot;,
10058 ],
10059 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10060 },
10061 &quot;type&quot;: &quot;A String&quot;, # The source type.
10062 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10063 #
10064 # Last update timestamp of this source.
10065 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10066 #
10067 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10068 # source. Used for web cache validation.
10069 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10070 },
10071 },
10072 &quot;text&quot;: &quot;A String&quot;, # A free-form string representing the user&#x27;s birthday.
10073 &quot;date&quot;: { # Represents a whole or partial calendar date, e.g. a birthday. The time of day # The date of the birthday.
10074 # and time zone are either specified elsewhere or are not significant. The date
10075 # is relative to the Proleptic Gregorian Calendar. This can represent:
10076 #
10077 # * A full date, with non-zero year, month and day values
10078 # * A month and day value, with a zero year, e.g. an anniversary
10079 # * A year on its own, with zero month and day values
10080 # * A year and month value, with a zero day, e.g. a credit card expiration date
10081 #
10082 # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
10083 &quot;day&quot;: 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
10084 # if specifying a year by itself or a year and month where the day is not
10085 # significant.
10086 &quot;month&quot;: 42, # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
10087 # month and day.
10088 &quot;year&quot;: 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
10089 # a year.
10090 },
10091 },
10092 ],
10093 &quot;genders&quot;: [ # The person&#x27;s genders.
10094 { # A person&#x27;s gender.
10095 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the gender translated and formatted in the viewer&#x27;s account
10096 # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
10097 # value are not localized.
10098 &quot;addressMeAs&quot;: &quot;A String&quot;, # The type of pronouns that should be used to address the person. The value
10099 # can be custom or one of these predefined values:
10100 #
10101 # * `male`
10102 # * `female`
10103 # * `other`
10104 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the gender.
10105 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
10106 # verified field is typically a name, email address, phone number, or
10107 # website that has been confirmed to be owned by the person.
10108 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
10109 # field.
10110 &quot;source&quot;: { # The source of a field. # The source of the field.
10111 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
10112 #
10113 # Metadata about a source of type PROFILE.
10114 &quot;userTypes&quot;: [ # Output only. The user types.
10115 &quot;A String&quot;,
10116 ],
10117 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10118 },
10119 &quot;type&quot;: &quot;A String&quot;, # The source type.
10120 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10121 #
10122 # Last update timestamp of this source.
10123 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10124 #
10125 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10126 # source. Used for web cache validation.
10127 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10128 },
10129 },
10130 &quot;value&quot;: &quot;A String&quot;, # The gender for the person. The gender can be custom or one of these
10131 # predefined values:
10132 #
10133 # * `male`
10134 # * `female`
10135 # * `unspecified`
10136 },
10137 ],
10138 &quot;nicknames&quot;: [ # The person&#x27;s nicknames.
10139 { # A person&#x27;s nickname.
10140 &quot;value&quot;: &quot;A String&quot;, # The nickname.
10141 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the nickname.
10142 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
10143 # verified field is typically a name, email address, phone number, or
10144 # website that has been confirmed to be owned by the person.
10145 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
10146 # field.
10147 &quot;source&quot;: { # The source of a field. # The source of the field.
10148 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
10149 #
10150 # Metadata about a source of type PROFILE.
10151 &quot;userTypes&quot;: [ # Output only. The user types.
10152 &quot;A String&quot;,
10153 ],
10154 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10155 },
10156 &quot;type&quot;: &quot;A String&quot;, # The source type.
10157 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10158 #
10159 # Last update timestamp of this source.
10160 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10161 #
10162 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10163 # source. Used for web cache validation.
10164 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10165 },
10166 },
10167 &quot;type&quot;: &quot;A String&quot;, # The type of the nickname.
10168 },
10169 ],
10170 &quot;relationshipStatuses&quot;: [ # Output only. **DEPRECATED**: No data will be returned
10171 # The person&#x27;s relationship statuses.
10172 { # **DEPRECATED**: No data will be returned
10173 # A person&#x27;s relationship status.
10174 &quot;metadata&quot;: { # Metadata about a field. # Metadata about the relationship status.
10175 &quot;verified&quot;: True or False, # Output only. True if the field is verified; false if the field is unverified. A
10176 # verified field is typically a name, email address, phone number, or
10177 # website that has been confirmed to be owned by the person.
10178 &quot;primary&quot;: True or False, # True if the field is the primary field; false if the field is a secondary
10179 # field.
10180 &quot;source&quot;: { # The source of a field. # The source of the field.
10181 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
10182 #
10183 # Metadata about a source of type PROFILE.
10184 &quot;userTypes&quot;: [ # Output only. The user types.
10185 &quot;A String&quot;,
10186 ],
10187 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10188 },
10189 &quot;type&quot;: &quot;A String&quot;, # The source type.
10190 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
10191 #
10192 # Last update timestamp of this source.
10193 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
10194 #
10195 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10196 # source. Used for web cache validation.
10197 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
10198 },
10199 },
10200 &quot;formattedValue&quot;: &quot;A String&quot;, # Output only. The value of the relationship status translated and formatted in
10201 # the viewer&#x27;s account locale or the `Accept-Language` HTTP header locale.
10202 &quot;value&quot;: &quot;A String&quot;, # The relationship status. The value can be custom or one of these
10203 # predefined values:
10204 #
10205 # * `single`
10206 # * `inARelationship`
10207 # * `engaged`
10208 # * `married`
10209 # * `itsComplicated`
10210 # * `openRelationship`
10211 # * `widowed`
10212 # * `inDomesticPartnership`
10213 # * `inCivilUnion`
10214 },
10215 ],
10216 &quot;metadata&quot;: { # The metadata about a person. # Output only. Metadata about the person.
10217 &quot;linkedPeopleResourceNames&quot;: [ # Output only. Resource names of people linked to this resource.
10218 &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -070010219 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070010220 &quot;objectType&quot;: &quot;A String&quot;, # Output only. **DEPRECATED** (Please use
10221 # `person.metadata.sources.profileMetadata.objectType` instead)
10222 #
10223 # The type of the person object.
10224 &quot;previousResourceNames&quot;: [ # Output only. Any former resource names this person has had. Populated only for
10225 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
10226 # that include a sync token.
10227 #
10228 # The resource name may change when adding or removing fields that link a
10229 # contact and profile such as a verified email, verified phone number, or
10230 # profile URL.
10231 &quot;A String&quot;,
10232 ],
10233 &quot;deleted&quot;: True or False, # Output only. True if the person resource has been deleted. Populated only for
10234 # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
10235 # that include a sync token.
10236 &quot;sources&quot;: [ # The sources of data for the person.
10237 { # The source of a field.
10238 &quot;profileMetadata&quot;: { # The metadata about a profile. # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -070010239 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070010240 # Metadata about a source of type PROFILE.
10241 &quot;userTypes&quot;: [ # Output only. The user types.
10242 &quot;A String&quot;,
10243 ],
10244 &quot;objectType&quot;: &quot;A String&quot;, # Output only. The profile object type.
10245 },
10246 &quot;type&quot;: &quot;A String&quot;, # The source type.
10247 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -070010248 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070010249 # Last update timestamp of this source.
10250 &quot;etag&quot;: &quot;A String&quot;, # **Only populated in `person.metadata.sources`.**
Bu Sun Kim65020912020-05-20 12:08:20 -070010251 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070010252 # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
10253 # source. Used for web cache validation.
10254 &quot;id&quot;: &quot;A String&quot;, # The unique identifier within the source type generated by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -070010255 },
10256 ],
10257 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070010258 },
Dan O'Mearadd494642020-05-01 07:42:23 -070010259 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070010260</div>
10261
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -080010262</body></html>