Regen docs (#373)
diff --git a/docs/dyn/people_v1.people.html b/docs/dyn/people_v1.people.html
index 4eaa5e0..b8331d2 100644
--- a/docs/dyn/people_v1.people.html
+++ b/docs/dyn/people_v1.people.html
@@ -232,6 +232,24 @@
{ # A person's phone number.
"formattedType": "A String", # The read-only type of the phone number translated and formatted in the
# viewer's account locale or the the `Accept-Language` HTTP header locale.
+ "canonicalForm": "A String", # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
+ # form of the phone number.
+ "type": "A String", # The type of the phone number. The type can be custom or predefined.
+ # Possible values include, but are not limited to, the following:
+ #
+ # * `home`
+ # * `work`
+ # * `mobile`
+ # * `homeFax`
+ # * `workFax`
+ # * `otherFax`
+ # * `pager`
+ # * `workMobile`
+ # * `workPager`
+ # * `main`
+ # * `googleVoice`
+ # * `other`
+ "value": "A String", # The phone number.
"metadata": { # Metadata about a field. # Metadata about the phone number.
"source": { # The source of a field. # The source of the field.
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -249,24 +267,6 @@
"primary": True or False, # True if the field is the primary field; false if the field is a secondary
# field.
},
- "type": "A String", # The type of the phone number. The type can be custom or predefined.
- # Possible values include, but are not limited to, the following:
- #
- # * `home`
- # * `work`
- # * `mobile`
- # * `homeFax`
- # * `workFax`
- # * `otherFax`
- # * `pager`
- # * `workMobile`
- # * `workPager`
- # * `main`
- # * `googleVoice`
- # * `other`
- "value": "A String", # The phone number.
- "canonicalForm": "A String", # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
- # form of the phone number.
},
],
"names": [ # The person's names.
@@ -341,11 +341,11 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"text": "A String", # A free-form string representing the user's birthday.
"metadata": { # Metadata about a field. # Metadata about the birthday.
@@ -370,23 +370,8 @@
"relations": [ # The person's relations.
{ # A person's relation to another person.
"person": "A String", # The name of the other person this relation refers to.
- "metadata": { # Metadata about a field. # Metadata about the relation.
- "source": { # The source of a field. # The source of the field.
- "etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
- # source. Used for web cache validation. Only populated in
- # person.metadata.sources.
- "type": "A String", # The source type.
- "id": "A String", # The unique identifier within the source type generated by the server.
- "profileMetadata": { # The read-only metadata about a profile. # Metadata about a source of type PROFILE.
- "objectType": "A String", # The profile object type.
- },
- },
- "verified": True or False, # True if the field is verified; false if the field is unverified. A
- # verified field is typically a name, email address, phone number, or
- # website that has been confirmed to be owned by the person.
- "primary": True or False, # True if the field is the primary field; false if the field is a secondary
- # field.
- },
+ "formattedType": "A String", # The type of the relation translated and formatted in the viewer's account
+ # locale or the locale specified in the Accept-Language HTTP header.
"type": "A String", # The person's relation to the other person. The type can be custom or predefined.
# Possible values include, but are not limited to, the following values:
#
@@ -404,8 +389,23 @@
# * `assistant`
# * `referredBy`
# * `partner`
- "formattedType": "A String", # The type of the relation translated and formatted in the viewer's account
- # locale or the locale specified in the Accept-Language HTTP header.
+ "metadata": { # Metadata about a field. # Metadata about the relation.
+ "source": { # The source of a field. # The source of the field.
+ "etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
+ # source. Used for web cache validation. Only populated in
+ # person.metadata.sources.
+ "type": "A String", # The source type.
+ "id": "A String", # The unique identifier within the source type generated by the server.
+ "profileMetadata": { # The read-only metadata about a profile. # Metadata about a source of type PROFILE.
+ "objectType": "A String", # The profile object type.
+ },
+ },
+ "verified": True or False, # True if the field is verified; false if the field is unverified. A
+ # verified field is typically a name, email address, phone number, or
+ # website that has been confirmed to be owned by the person.
+ "primary": True or False, # True if the field is the primary field; false if the field is a secondary
+ # field.
+ },
},
],
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -520,11 +520,11 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"formattedType": "A String", # The read-only type of the event translated and formatted in the
# viewer's account locale or the `Accept-Language` HTTP header locale.
@@ -553,15 +553,9 @@
},
],
"metadata": { # The read-only metadata about a person. # Metadata about the person.
- "previousResourceNames": [ # Any former resource names this person has had. Populated only for
+ "deleted": True or False, # True if the person resource has been deleted. Populated only for
# [`connections.list`](/people/api/rest/v1/people.connections/list) requests
# that include a sync token.
- #
- # The resource name may change when adding or removing fields that link a
- # contact and profile such as a verified email, verified phone number, or
- # profile URL.
- "A String",
- ],
"sources": [ # The sources of data for the person.
{ # The source of a field.
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -577,9 +571,15 @@
"linkedPeopleResourceNames": [ # Resource names of people linked to this resource.
"A String",
],
- "deleted": True or False, # True if the person resource has been deleted. Populated only for
+ "previousResourceNames": [ # Any former resource names this person has had. Populated only for
# [`connections.list`](/people/api/rest/v1/people.connections/list) requests
# that include a sync token.
+ #
+ # The resource name may change when adding or removing fields that link a
+ # contact and profile such as a verified email, verified phone number, or
+ # profile URL.
+ "A String",
+ ],
"objectType": "A String", # DEPRECATED(Please read person.metadata.sources.profile_metadata instead).
# The type of the person object.
},
@@ -735,8 +735,19 @@
"organizations": [ # The person's past or current organizations.
{ # A person's past or current organization. Overlapping date ranges are
# permitted.
- "formattedType": "A String", # The read-only type of the organization translated and formatted in the
- # viewer's account locale or the `Accept-Language` HTTP header locale.
+ "startDate": { # Represents a whole calendar date, for example a date of birth. The time # The start date when the person joined the organization.
+ # of day and time zone are either specified elsewhere or are not
+ # significant. The date is relative to the
+ # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).
+ # The day may be 0 to represent a year and month where the day is not
+ # significant. The year may be 0 to represent a month and day independent
+ # of year; for example, anniversary date.
+ "month": 42, # Month of year. Must be from 1 to 12.
+ "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+ # if specifying a year/month where the day is not significant.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
+ },
"domain": "A String", # The domain name associated with the organization; for example, `google.com`.
"endDate": { # Represents a whole calendar date, for example a date of birth. The time # The end date when the person left the organization.
# of day and time zone are either specified elsewhere or are not
@@ -745,19 +756,14 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"name": "A String", # The name of the organization.
"title": "A String", # The person's job title at the organization.
- "type": "A String", # The type of the organization. The type can be custom or predefined.
- # Possible values include, but are not limited to, the following:
- #
- # * `work`
- # * `school`
"symbol": "A String", # The symbol associated with the organization; for example, a stock ticker
# symbol, abbreviation, or acronym.
"current": True or False, # True if the organization is the person's current organization;
@@ -765,19 +771,13 @@
"jobDescription": "A String", # The person's job description at the organization.
"location": "A String", # The location of the organization office the person works at.
"department": "A String", # The person's department at the organization.
- "startDate": { # Represents a whole calendar date, for example a date of birth. The time # The start date when the person joined the organization.
- # of day and time zone are either specified elsewhere or are not
- # significant. The date is relative to the
- # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).
- # The day may be 0 to represent a year and month where the day is not
- # significant. The year may be 0 to represent a month and day independent
- # of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
- "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
- # if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
- },
+ "formattedType": "A String", # The read-only type of the organization translated and formatted in the
+ # viewer's account locale or the `Accept-Language` HTTP header locale.
+ "type": "A String", # The type of the organization. The type can be custom or predefined.
+ # Possible values include, but are not limited to, the following:
+ #
+ # * `work`
+ # * `school`
"phoneticName": "A String", # The phonetic name of the organization.
"metadata": { # Metadata about a field. # Metadata about the organization.
"source": { # The source of a field. # The source of the field.
@@ -946,14 +946,14 @@
],
"emailAddresses": [ # The person's email addresses.
{ # A person's email address.
+ "formattedType": "A String", # The read-only type of the email address translated and formatted in the
+ # viewer's account locale or the `Accept-Language` HTTP header locale.
"type": "A String", # The type of the email address. The type can be custom or predefined.
# Possible values include, but are not limited to, the following:
#
# * `home`
# * `work`
# * `other`
- "formattedType": "A String", # The read-only type of the email address translated and formatted in the
- # viewer's account locale or the `Accept-Language` HTTP header locale.
"displayName": "A String", # The display name of the email.
"value": "A String", # The email address.
"metadata": { # Metadata about a field. # Metadata about the email address.
@@ -1132,6 +1132,24 @@
{ # A person's phone number.
"formattedType": "A String", # The read-only type of the phone number translated and formatted in the
# viewer's account locale or the the `Accept-Language` HTTP header locale.
+ "canonicalForm": "A String", # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
+ # form of the phone number.
+ "type": "A String", # The type of the phone number. The type can be custom or predefined.
+ # Possible values include, but are not limited to, the following:
+ #
+ # * `home`
+ # * `work`
+ # * `mobile`
+ # * `homeFax`
+ # * `workFax`
+ # * `otherFax`
+ # * `pager`
+ # * `workMobile`
+ # * `workPager`
+ # * `main`
+ # * `googleVoice`
+ # * `other`
+ "value": "A String", # The phone number.
"metadata": { # Metadata about a field. # Metadata about the phone number.
"source": { # The source of a field. # The source of the field.
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -1149,24 +1167,6 @@
"primary": True or False, # True if the field is the primary field; false if the field is a secondary
# field.
},
- "type": "A String", # The type of the phone number. The type can be custom or predefined.
- # Possible values include, but are not limited to, the following:
- #
- # * `home`
- # * `work`
- # * `mobile`
- # * `homeFax`
- # * `workFax`
- # * `otherFax`
- # * `pager`
- # * `workMobile`
- # * `workPager`
- # * `main`
- # * `googleVoice`
- # * `other`
- "value": "A String", # The phone number.
- "canonicalForm": "A String", # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
- # form of the phone number.
},
],
"names": [ # The person's names.
@@ -1241,11 +1241,11 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"text": "A String", # A free-form string representing the user's birthday.
"metadata": { # Metadata about a field. # Metadata about the birthday.
@@ -1270,23 +1270,8 @@
"relations": [ # The person's relations.
{ # A person's relation to another person.
"person": "A String", # The name of the other person this relation refers to.
- "metadata": { # Metadata about a field. # Metadata about the relation.
- "source": { # The source of a field. # The source of the field.
- "etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
- # source. Used for web cache validation. Only populated in
- # person.metadata.sources.
- "type": "A String", # The source type.
- "id": "A String", # The unique identifier within the source type generated by the server.
- "profileMetadata": { # The read-only metadata about a profile. # Metadata about a source of type PROFILE.
- "objectType": "A String", # The profile object type.
- },
- },
- "verified": True or False, # True if the field is verified; false if the field is unverified. A
- # verified field is typically a name, email address, phone number, or
- # website that has been confirmed to be owned by the person.
- "primary": True or False, # True if the field is the primary field; false if the field is a secondary
- # field.
- },
+ "formattedType": "A String", # The type of the relation translated and formatted in the viewer's account
+ # locale or the locale specified in the Accept-Language HTTP header.
"type": "A String", # The person's relation to the other person. The type can be custom or predefined.
# Possible values include, but are not limited to, the following values:
#
@@ -1304,8 +1289,23 @@
# * `assistant`
# * `referredBy`
# * `partner`
- "formattedType": "A String", # The type of the relation translated and formatted in the viewer's account
- # locale or the locale specified in the Accept-Language HTTP header.
+ "metadata": { # Metadata about a field. # Metadata about the relation.
+ "source": { # The source of a field. # The source of the field.
+ "etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
+ # source. Used for web cache validation. Only populated in
+ # person.metadata.sources.
+ "type": "A String", # The source type.
+ "id": "A String", # The unique identifier within the source type generated by the server.
+ "profileMetadata": { # The read-only metadata about a profile. # Metadata about a source of type PROFILE.
+ "objectType": "A String", # The profile object type.
+ },
+ },
+ "verified": True or False, # True if the field is verified; false if the field is unverified. A
+ # verified field is typically a name, email address, phone number, or
+ # website that has been confirmed to be owned by the person.
+ "primary": True or False, # True if the field is the primary field; false if the field is a secondary
+ # field.
+ },
},
],
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -1420,11 +1420,11 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"formattedType": "A String", # The read-only type of the event translated and formatted in the
# viewer's account locale or the `Accept-Language` HTTP header locale.
@@ -1453,15 +1453,9 @@
},
],
"metadata": { # The read-only metadata about a person. # Metadata about the person.
- "previousResourceNames": [ # Any former resource names this person has had. Populated only for
+ "deleted": True or False, # True if the person resource has been deleted. Populated only for
# [`connections.list`](/people/api/rest/v1/people.connections/list) requests
# that include a sync token.
- #
- # The resource name may change when adding or removing fields that link a
- # contact and profile such as a verified email, verified phone number, or
- # profile URL.
- "A String",
- ],
"sources": [ # The sources of data for the person.
{ # The source of a field.
"etag": "A String", # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
@@ -1477,9 +1471,15 @@
"linkedPeopleResourceNames": [ # Resource names of people linked to this resource.
"A String",
],
- "deleted": True or False, # True if the person resource has been deleted. Populated only for
+ "previousResourceNames": [ # Any former resource names this person has had. Populated only for
# [`connections.list`](/people/api/rest/v1/people.connections/list) requests
# that include a sync token.
+ #
+ # The resource name may change when adding or removing fields that link a
+ # contact and profile such as a verified email, verified phone number, or
+ # profile URL.
+ "A String",
+ ],
"objectType": "A String", # DEPRECATED(Please read person.metadata.sources.profile_metadata instead).
# The type of the person object.
},
@@ -1635,8 +1635,19 @@
"organizations": [ # The person's past or current organizations.
{ # A person's past or current organization. Overlapping date ranges are
# permitted.
- "formattedType": "A String", # The read-only type of the organization translated and formatted in the
- # viewer's account locale or the `Accept-Language` HTTP header locale.
+ "startDate": { # Represents a whole calendar date, for example a date of birth. The time # The start date when the person joined the organization.
+ # of day and time zone are either specified elsewhere or are not
+ # significant. The date is relative to the
+ # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).
+ # The day may be 0 to represent a year and month where the day is not
+ # significant. The year may be 0 to represent a month and day independent
+ # of year; for example, anniversary date.
+ "month": 42, # Month of year. Must be from 1 to 12.
+ "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+ # if specifying a year/month where the day is not significant.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
+ },
"domain": "A String", # The domain name associated with the organization; for example, `google.com`.
"endDate": { # Represents a whole calendar date, for example a date of birth. The time # The end date when the person left the organization.
# of day and time zone are either specified elsewhere or are not
@@ -1645,19 +1656,14 @@
# The day may be 0 to represent a year and month where the day is not
# significant. The year may be 0 to represent a month and day independent
# of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
+ "month": 42, # Month of year. Must be from 1 to 12.
"day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
# if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
+ "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+ # a year.
},
"name": "A String", # The name of the organization.
"title": "A String", # The person's job title at the organization.
- "type": "A String", # The type of the organization. The type can be custom or predefined.
- # Possible values include, but are not limited to, the following:
- #
- # * `work`
- # * `school`
"symbol": "A String", # The symbol associated with the organization; for example, a stock ticker
# symbol, abbreviation, or acronym.
"current": True or False, # True if the organization is the person's current organization;
@@ -1665,19 +1671,13 @@
"jobDescription": "A String", # The person's job description at the organization.
"location": "A String", # The location of the organization office the person works at.
"department": "A String", # The person's department at the organization.
- "startDate": { # Represents a whole calendar date, for example a date of birth. The time # The start date when the person joined the organization.
- # of day and time zone are either specified elsewhere or are not
- # significant. The date is relative to the
- # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).
- # The day may be 0 to represent a year and month where the day is not
- # significant. The year may be 0 to represent a month and day independent
- # of year; for example, anniversary date.
- "year": 42, # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
- # a year.
- "day": 42, # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
- # if specifying a year/month where the day is not significant.
- "month": 42, # Month of year. Must be from 1 to 12.
- },
+ "formattedType": "A String", # The read-only type of the organization translated and formatted in the
+ # viewer's account locale or the `Accept-Language` HTTP header locale.
+ "type": "A String", # The type of the organization. The type can be custom or predefined.
+ # Possible values include, but are not limited to, the following:
+ #
+ # * `work`
+ # * `school`
"phoneticName": "A String", # The phonetic name of the organization.
"metadata": { # Metadata about a field. # Metadata about the organization.
"source": { # The source of a field. # The source of the field.
@@ -1846,14 +1846,14 @@
],
"emailAddresses": [ # The person's email addresses.
{ # A person's email address.
+ "formattedType": "A String", # The read-only type of the email address translated and formatted in the
+ # viewer's account locale or the `Accept-Language` HTTP header locale.
"type": "A String", # The type of the email address. The type can be custom or predefined.
# Possible values include, but are not limited to, the following:
#
# * `home`
# * `work`
# * `other`
- "formattedType": "A String", # The read-only type of the email address translated and formatted in the
- # viewer's account locale or the `Accept-Language` HTTP header locale.
"displayName": "A String", # The display name of the email.
"value": "A String", # The email address.
"metadata": { # Metadata about a field. # Metadata about the email address.