google-api-client 0.41.1 → 0.43.0

data/generated/google/apis/osconfig_v1beta/classes.rb

@@ -503,6 +503,12 @@ module Google
         # @return [Google::Apis::OsconfigV1beta::PatchConfig]
         attr_accessor :patch_config
       
+        # Patch rollout configuration specifications. Contains details on the
+        # concurrency control when applying patch(es) to all targeted VMs.
+        # Corresponds to the JSON property `rollout`
+        # @return [Google::Apis::OsconfigV1beta::PatchRollout]
+        attr_accessor :rollout
+      
         def initialize(**args)
            update!(**args)
         end
@@ -515,6 +521,34 @@ module Google
           @duration = args[:duration] if args.key?(:duration)
           @instance_filter = args[:instance_filter] if args.key?(:instance_filter)
           @patch_config = args[:patch_config] if args.key?(:patch_config)
+          @rollout = args[:rollout] if args.key?(:rollout)
+        end
+      end
+      
+      # Message encapsulating a value that can be either absolute ("fixed") or
+      # relative ("percent") to a value.
+      class FixedOrPercent
+        include Google::Apis::Core::Hashable
+      
+        # Specifies a fixed value.
+        # Corresponds to the JSON property `fixed`
+        # @return [Fixnum]
+        attr_accessor :fixed
+      
+        # Specifies the relative value defined as a percentage, which will be
+        # multiplied by a reference value.
+        # Corresponds to the JSON property `percent`
+        # @return [Fixnum]
+        attr_accessor :percent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fixed = args[:fixed] if args.key?(:fixed)
+          @percent = args[:percent] if args.key?(:percent)
         end
       end
       
@@ -1095,8 +1129,14 @@ module Google
         # @return [Google::Apis::OsconfigV1beta::RecurringSchedule]
         attr_accessor :recurring_schedule
       
+        # Patch rollout configuration specifications. Contains details on the
+        # concurrency control when applying patch(es) to all targeted VMs.
+        # Corresponds to the JSON property `rollout`
+        # @return [Google::Apis::OsconfigV1beta::PatchRollout]
+        attr_accessor :rollout
+      
         # Output only. Time the patch deployment was last updated. Timestamp is in
-        # [RFC3339]("https://www.ietf.org/rfc/rfc3339.txt) text format.
+        # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -1116,6 +1156,7 @@ module Google
           @one_time_schedule = args[:one_time_schedule] if args.key?(:one_time_schedule)
           @patch_config = args[:patch_config] if args.key?(:patch_config)
           @recurring_schedule = args[:recurring_schedule] if args.key?(:recurring_schedule)
+          @rollout = args[:rollout] if args.key?(:rollout)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
@@ -1148,7 +1189,7 @@ module Google
         attr_accessor :instance_name_prefixes
       
         # Targets any of the VM instances specified. Instances are specified by their
-        # URI in the form `zones/[ZONE]/instances/[INSTANCE_NAME],
+        # URI in the form `zones/[ZONE]/instances/[INSTANCE_NAME]`,
         # `projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]`, or
         # `https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/
         # instances/[INSTANCE_NAME]`
@@ -1282,6 +1323,12 @@ module Google
         # @return [Float]
         attr_accessor :percent_complete
       
+        # Patch rollout configuration specifications. Contains details on the
+        # concurrency control when applying patch(es) to all targeted VMs.
+        # Corresponds to the JSON property `rollout`
+        # @return [Google::Apis::OsconfigV1beta::PatchRollout]
+        attr_accessor :rollout
+      
         # The current state of the PatchJob.
         # Corresponds to the JSON property `state`
         # @return [String]
@@ -1310,6 +1357,7 @@ module Google
           @patch_config = args[:patch_config] if args.key?(:patch_config)
           @patch_deployment = args[:patch_deployment] if args.key?(:patch_deployment)
           @percent_complete = args[:percent_complete] if args.key?(:percent_complete)
+          @rollout = args[:rollout] if args.key?(:rollout)
           @state = args[:state] if args.key?(:state)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
@@ -1471,6 +1519,33 @@ module Google
         end
       end
       
+      # Patch rollout configuration specifications. Contains details on the
+      # concurrency control when applying patch(es) to all targeted VMs.
+      class PatchRollout
+        include Google::Apis::Core::Hashable
+      
+        # Message encapsulating a value that can be either absolute ("fixed") or
+        # relative ("percent") to a value.
+        # Corresponds to the JSON property `disruptionBudget`
+        # @return [Google::Apis::OsconfigV1beta::FixedOrPercent]
+        attr_accessor :disruption_budget
+      
+        # Mode of the patch rollout.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disruption_budget = args[:disruption_budget] if args.key?(:disruption_budget)
+          @mode = args[:mode] if args.key?(:mode)
+        end
+      end
+      
       # Sets the time for recurring patch deployments.
       class RecurringSchedule
         include Google::Apis::Core::Hashable

data/generated/google/apis/osconfig_v1beta/representations.rb

@@ -106,6 +106,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class FixedOrPercent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GcsObject
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -226,6 +232,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PatchRollout
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RecurringSchedule
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -490,6 +502,16 @@ module Google
       
           property :patch_config, as: 'patchConfig', class: Google::Apis::OsconfigV1beta::PatchConfig, decorator: Google::Apis::OsconfigV1beta::PatchConfig::Representation
       
+          property :rollout, as: 'rollout', class: Google::Apis::OsconfigV1beta::PatchRollout, decorator: Google::Apis::OsconfigV1beta::PatchRollout::Representation
+      
+        end
+      end
+      
+      class FixedOrPercent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :fixed, as: 'fixed'
+          property :percent, as: 'percent'
         end
       end
       
@@ -656,6 +678,8 @@ module Google
       
           property :recurring_schedule, as: 'recurringSchedule', class: Google::Apis::OsconfigV1beta::RecurringSchedule, decorator: Google::Apis::OsconfigV1beta::RecurringSchedule::Representation
       
+          property :rollout, as: 'rollout', class: Google::Apis::OsconfigV1beta::PatchRollout, decorator: Google::Apis::OsconfigV1beta::PatchRollout::Representation
+      
           property :update_time, as: 'updateTime'
         end
       end
@@ -697,6 +721,8 @@ module Google
       
           property :patch_deployment, as: 'patchDeployment'
           property :percent_complete, as: 'percentComplete'
+          property :rollout, as: 'rollout', class: Google::Apis::OsconfigV1beta::PatchRollout, decorator: Google::Apis::OsconfigV1beta::PatchRollout::Representation
+      
           property :state, as: 'state'
           property :update_time, as: 'updateTime'
         end
@@ -734,6 +760,15 @@ module Google
         end
       end
       
+      class PatchRollout
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :disruption_budget, as: 'disruptionBudget', class: Google::Apis::OsconfigV1beta::FixedOrPercent, decorator: Google::Apis::OsconfigV1beta::FixedOrPercent::Representation
+      
+          property :mode, as: 'mode'
+        end
+      end
+      
       class RecurringSchedule
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/pagespeedonline_v5.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://developers.google.com/speed/docs/insights/v5/about
     module PagespeedonlineV5
       VERSION = 'V5'
-      REVISION = '20200608'
+      REVISION = '20200721'
 
       # Associate you with your personal info on Google
       PENID = 'openid'

data/generated/google/apis/people_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/people/
     module PeopleV1
       VERSION = 'V1'
-      REVISION = '20200624'
+      REVISION = '20200730'
 
       # See, edit, download, and permanently delete your contacts
       AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts'

data/generated/google/apis/people_v1/classes.rb

@@ -54,8 +54,8 @@ module Google
         # @return [String]
         attr_accessor :formatted_type
       
-        # The unstructured value of the address. If this is not set by the user it
-        # will be automatically constructed from structured values.
+        # The unstructured value of the address. If this is not set by the user it will
+        # be automatically constructed from structured values.
         # Corresponds to the JSON property `formattedValue`
         # @return [String]
         attr_accessor :formatted_value
@@ -86,10 +86,7 @@ module Google
         attr_accessor :street_address
       
         # The type of the address. The type can be custom or one of these predefined
-        # values:
-        # * `home`
-        # * `work`
-        # * `other`
+        # values: * `home` * `work` * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -191,19 +188,19 @@ module Google
       end
       
       # A person's birthday. At least one of the `date` and `text` fields are
-      # specified. The `date` and `text` fields typically represent the same
-      # date, but are not guaranteed to.
+      # specified. The `date` and `text` fields typically represent the same date, but
+      # are not guaranteed to.
       class Birthday
         include Google::Apis::Core::Hashable
       
         # Represents a whole or partial calendar date, e.g. a birthday. The time of day
         # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent:
-        # * A full date, with non-zero year, month and day values
-        # * A month and day value, with a zero year, e.g. an anniversary
-        # * A year on its own, with zero month and day values
-        # * A year and month value, with a zero day, e.g. a credit card expiration date
-        # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
+        # date, with non-zero year, month and day values * A month and day value, with a
+        # zero year, e.g. an anniversary * A year on its own, with zero month and day
+        # values * A year and month value, with a zero day, e.g. a credit card
+        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
+        # Timestamp`.
         # Corresponds to the JSON property `date`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :date
@@ -230,8 +227,7 @@ module Google
         end
       end
       
-      # **DEPRECATED**: No data will be returned
-      # A person's bragging rights.
+      # **DEPRECATED**: No data will be returned A person's bragging rights.
       class BraggingRights
         include Google::Apis::Core::Hashable
       
@@ -256,19 +252,58 @@ module Google
         end
       end
       
+      # A person's calendar URL.
+      class CalendarUrl
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The type of the calendar URL translated and formatted in the
+        # viewer's account locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedType`
+        # @return [String]
+        attr_accessor :formatted_type
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The type of the calendar URL. The type can be custom or one of these
+        # predefined values: * `home` * `freeBusy` * `work`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The calendar URL.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @type = args[:type] if args.key?(:type)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
       # A contact group.
       class ContactGroup
         include Google::Apis::Core::Hashable
       
-        # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
-        # resource. Used for web cache validation.
+        # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the resource.
+        # Used for web cache validation.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
         # Output only. The name translated and formatted in the viewer's account locale
-        # or the `Accept-Language` HTTP header locale for system groups names.
-        # Group names set by the owner are the same as name.
+        # or the `Accept-Language` HTTP header locale for system groups names. Group
+        # names set by the owner are the same as name.
         # Corresponds to the JSON property `formattedName`
         # @return [String]
         attr_accessor :formatted_name
@@ -279,17 +314,15 @@ module Google
         attr_accessor :group_type
       
         # Output only. The total number of contacts in the group irrespective of max
-        # members in
-        # specified in the request.
+        # members in specified in the request.
         # Corresponds to the JSON property `memberCount`
         # @return [Fixnum]
         attr_accessor :member_count
       
         # Output only. The list of contact person resource names that are members of the
-        # contact
-        # group. The field is not populated for LIST requests and can only be updated
-        # through the
-        # [ModifyContactGroupMembers](/people/api/rest/v1/contactgroups/members/modify).
+        # contact group. The field is not populated for LIST requests and can only be
+        # updated through the [ModifyContactGroupMembers](/people/api/rest/v1/
+        # contactgroups/members/modify).
         # Corresponds to the JSON property `memberResourceNames`
         # @return [Array<String>]
         attr_accessor :member_resource_names
@@ -299,8 +332,8 @@ module Google
         # @return [Google::Apis::PeopleV1::ContactGroupMetadata]
         attr_accessor :metadata
       
-        # The contact group name set by the group owner or a system provided name
-        # for system groups.
+        # The contact group name set by the group owner or a system provided name for
+        # system groups.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -338,11 +371,11 @@ module Google
         attr_accessor :contact_group_id
       
         # The resource name for the contact group, assigned by the server. An ASCII
-        # string, in the form of `contactGroups/`contact_group_id``.
-        # Only contact_group_resource_name can be used for modifying memberships.
-        # Any contact group membership can be removed, but only user group or
-        # "myContacts" or "starred" system groups memberships can be added. A
-        # contact must always have at least one contact group membership.
+        # string, in the form of `contactGroups/`contact_group_id``. Only
+        # contact_group_resource_name can be used for modifying memberships. Any contact
+        # group membership can be removed, but only user group or "myContacts" or "
+        # starred" system groups memberships can be added. A contact must always have at
+        # least one contact group membership.
         # Corresponds to the JSON property `contactGroupResourceName`
         # @return [String]
         attr_accessor :contact_group_resource_name
@@ -363,9 +396,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. True if the contact group resource has been deleted. Populated
-        # only for
-        # [`ListContactGroups`](/people/api/rest/v1/contactgroups/list) requests
-        # that include a sync token.
+        # only for [`ListContactGroups`](/people/api/rest/v1/contactgroups/list)
+        # requests that include a sync token.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
@@ -401,12 +433,12 @@ module Google
         # @return [String]
         attr_accessor :requested_resource_name
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::PeopleV1::Status]
         attr_accessor :status
@@ -428,52 +460,25 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. A field mask to restrict which fields are copied into the new
-        # contact.
-        # Valid values are:
-        # * emailAddresses
-        # * names
-        # * phoneNumbers
+        # contact. Valid values are: * emailAddresses * names * phoneNumbers
         # Corresponds to the JSON property `copyMask`
         # @return [String]
         attr_accessor :copy_mask
       
         # Optional. A field mask to restrict which fields on the person are returned.
-        # Multiple
-        # fields can be specified by separating them with commas. Defaults to the
-        # copy mask with metadata and membership fields if not set. Valid values are:
-        # * addresses
-        # * ageRanges
-        # * biographies
-        # * birthdays
-        # * coverPhotos
-        # * emailAddresses
-        # * events
-        # * genders
-        # * imClients
-        # * interests
-        # * locales
-        # * memberships
-        # * metadata
-        # * names
-        # * nicknames
-        # * occupations
-        # * organizations
-        # * phoneNumbers
-        # * photos
-        # * relations
-        # * residences
-        # * sipAddresses
-        # * skills
-        # * urls
-        # * userDefined
+        # Multiple fields can be specified by separating them with commas. Defaults to
+        # the copy mask with metadata and membership fields if not set. Valid values are:
+        # * addresses * ageRanges * biographies * birthdays * calendarUrls *
+        # coverPhotos * emailAddresses * events * externalIds * genders * imClients *
+        # interests * locales * memberships * metadata * miscKeywords * names *
+        # nicknames * occupations * organizations * phoneNumbers * photos * relations *
+        # residences * sipAddresses * skills * urls * userDefined
         # Corresponds to the JSON property `readMask`
         # @return [String]
         attr_accessor :read_mask
       
-        # Optional. A mask of what source types to return. Defaults to
-        # ReadSourceType.CONTACT and
-        # ReadSourceType.PROFILE if not
-        # set.
+        # Optional. A mask of what source types to return. Defaults to ReadSourceType.
+        # CONTACT and ReadSourceType.PROFILE if not set.
         # Corresponds to the JSON property `sources`
         # @return [Array<String>]
         attr_accessor :sources
@@ -490,13 +495,13 @@ module Google
         end
       end
       
-      # A person's cover photo. A large image shown on the person's
-      # profile page that represents who they are or what they care about.
+      # A person's cover photo. A large image shown on the person's profile page that
+      # represents who they are or what they care about.
       class CoverPhoto
         include Google::Apis::Core::Hashable
       
-        # True if the cover photo is the default cover photo;
-        # false if the cover photo is a user-provided cover photo.
+        # True if the cover photo is the default cover photo; false if the cover photo
+        # is a user-provided cover photo.
         # Corresponds to the JSON property `default`
         # @return [Boolean]
         attr_accessor :default
@@ -545,30 +550,29 @@ module Google
       
       # Represents a whole or partial calendar date, e.g. a birthday. The time of day
       # and time zone are either specified elsewhere or are not significant. The date
-      # is relative to the Proleptic Gregorian Calendar. This can represent:
-      # * A full date, with non-zero year, month and day values
-      # * A month and day value, with a zero year, e.g. an anniversary
-      # * A year on its own, with zero month and day values
-      # * A year and month value, with a zero day, e.g. a credit card expiration date
-      # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+      # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
+      # date, with non-zero year, month and day values * A month and day value, with a
+      # zero year, e.g. an anniversary * A year on its own, with zero month and day
+      # values * A year and month value, with a zero day, e.g. a credit card
+      # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
+      # Timestamp`.
       class Date
         include Google::Apis::Core::Hashable
       
-        # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
-        # if specifying a year by itself or a year and month where the day is not
+        # Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if
+        # specifying a year by itself or a year and month where the day is not
         # significant.
         # Corresponds to the JSON property `day`
         # @return [Fixnum]
         attr_accessor :day
       
-        # Month of year. Must be from 1 to 12, or 0 if specifying a year without a
-        # month and day.
+        # Month of year. Must be from 1 to 12, or 0 if specifying a year without a month
+        # and day.
         # Corresponds to the JSON property `month`
         # @return [Fixnum]
         attr_accessor :month
       
-        # Year of date. Must be from 1 to 9999, or 0 if specifying a date without
-        # a year.
+        # Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year.
         # Corresponds to the JSON property `year`
         # @return [Fixnum]
         attr_accessor :year
@@ -590,10 +594,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Information about a person merged from various data sources such as the
-        # authenticated user's contacts and profile data.
-        # Most fields can have multiple items. The items in a field have no guaranteed
-        # order, but each non-empty field is guaranteed to have exactly one field with
-        # `metadata.primary` set to true.
+        # authenticated user's contacts and profile data. Most fields can have multiple
+        # items. The items in a field have no guaranteed order, but each non-empty field
+        # is guaranteed to have exactly one field with `metadata.primary` set to true.
         # Corresponds to the JSON property `person`
         # @return [Google::Apis::PeopleV1::Person]
         attr_accessor :person
@@ -649,10 +652,7 @@ module Google
         attr_accessor :metadata
       
         # The type of the email address. The type can be custom or one of these
-        # predefined values:
-        # * `home`
-        # * `work`
-        # * `other`
+        # predefined values: * `home` * `work` * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -676,13 +676,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -701,18 +699,18 @@ module Google
       
         # Represents a whole or partial calendar date, e.g. a birthday. The time of day
         # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent:
-        # * A full date, with non-zero year, month and day values
-        # * A month and day value, with a zero year, e.g. an anniversary
-        # * A year on its own, with zero month and day values
-        # * A year and month value, with a zero day, e.g. a credit card expiration date
-        # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
+        # date, with non-zero year, month and day values * A month and day value, with a
+        # zero year, e.g. an anniversary * A year on its own, with zero month and day
+        # values * A year and month value, with a zero day, e.g. a credit card
+        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
+        # Timestamp`.
         # Corresponds to the JSON property `date`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :date
       
-        # Output only. The type of the event translated and formatted in the
-        # viewer's account locale or the `Accept-Language` HTTP header locale.
+        # Output only. The type of the event translated and formatted in the viewer's
+        # account locale or the `Accept-Language` HTTP header locale.
         # Corresponds to the JSON property `formattedType`
         # @return [String]
         attr_accessor :formatted_type
@@ -723,9 +721,7 @@ module Google
         attr_accessor :metadata
       
         # The type of the event. The type can be custom or one of these predefined
-        # values:
-        # * `anniversary`
-        # * `other`
+        # values: * `anniversary` * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -743,6 +739,45 @@ module Google
         end
       end
       
+      # An identifier from an external entity related to the person.
+      class ExternalId
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The type of the event translated and formatted in the viewer's
+        # account locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedType`
+        # @return [String]
+        attr_accessor :formatted_type
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The type of the external ID. The type can be custom or one of these predefined
+        # values: * `account` * `customer` * `loginId` * `network` * `organization`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The value of the external ID.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @type = args[:type] if args.key?(:type)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Metadata about a field.
       class FieldMetadata
         include Google::Apis::Core::Hashable
@@ -760,9 +795,8 @@ module Google
         attr_accessor :source
       
         # Output only. True if the field is verified; false if the field is unverified.
-        # A
-        # verified field is typically a name, email address, phone number, or
-        # website that has been confirmed to be owned by the person.
+        # A verified field is typically a name, email address, phone number, or website
+        # that has been confirmed to be owned by the person.
         # Corresponds to the JSON property `verified`
         # @return [Boolean]
         attr_accessor :verified
@@ -809,19 +843,15 @@ module Google
       class Gender
         include Google::Apis::Core::Hashable
       
-        # The type of pronouns that should be used to address the person. The value
-        # can be custom or one of these predefined values:
-        # * `male`
-        # * `female`
-        # * `other`
+        # The type of pronouns that should be used to address the person. The value can
+        # be custom or one of these predefined values: * `male` * `female` * `other`
         # Corresponds to the JSON property `addressMeAs`
         # @return [String]
         attr_accessor :address_me_as
       
         # Output only. The value of the gender translated and formatted in the viewer's
-        # account
-        # locale or the `Accept-Language` HTTP header locale. Unspecified or custom
-        # value are not localized.
+        # account locale or the `Accept-Language` HTTP header locale. Unspecified or
+        # custom value are not localized.
         # Corresponds to the JSON property `formattedValue`
         # @return [String]
         attr_accessor :formatted_value
@@ -831,11 +861,8 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The gender for the person. The gender can be custom or one of these
-        # predefined values:
-        # * `male`
-        # * `female`
-        # * `unspecified`
+        # The gender for the person. The gender can be custom or one of these predefined
+        # values: * `male` * `female` * `unspecified`
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -882,8 +909,8 @@ module Google
         # @return [String]
         attr_accessor :formatted_protocol
       
-        # Output only. The type of the IM client translated and formatted in the
-        # viewer's account locale or the `Accept-Language` HTTP header locale.
+        # Output only. The type of the IM client translated and formatted in the viewer'
+        # s account locale or the `Accept-Language` HTTP header locale.
         # Corresponds to the JSON property `formattedType`
         # @return [String]
         attr_accessor :formatted_type
@@ -894,25 +921,14 @@ module Google
         attr_accessor :metadata
       
         # The protocol of the IM client. The protocol can be custom or one of these
-        # predefined values:
-        # * `aim`
-        # * `msn`
-        # * `yahoo`
-        # * `skype`
-        # * `qq`
-        # * `googleTalk`
-        # * `icq`
-        # * `jabber`
-        # * `netMeeting`
+        # predefined values: * `aim` * `msn` * `yahoo` * `skype` * `qq` * `googleTalk` *
+        # `icq` * `jabber` * `netMeeting`
         # Corresponds to the JSON property `protocol`
         # @return [String]
         attr_accessor :protocol
       
-        # The type of the IM client. The type can be custom or one of these
-        # predefined values:
-        # * `home`
-        # * `work`
-        # * `other`
+        # The type of the IM client. The type can be custom or one of these predefined
+        # values: * `home` * `work` * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -971,15 +987,14 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Person>]
         attr_accessor :connections
       
-        # A token, which can be sent as `page_token` to retrieve the next page.
-        # If this field is omitted, there are no subsequent pages.
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # A token, which can be sent as `sync_token` to retrieve changes since the
-        # last request. Request must set `request_sync_token` to return the sync
-        # token.
+        # A token, which can be sent as `sync_token` to retrieve changes since the last
+        # request. Request must set `request_sync_token` to return the sync token.
         # Corresponds to the JSON property `nextSyncToken`
         # @return [String]
         attr_accessor :next_sync_token
@@ -989,8 +1004,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :total_items
       
-        # **DEPRECATED** (Please use totalItems)
-        # The total number of people in the list without pagination.
+        # **DEPRECATED** (Please use totalItems) The total number of people in the list
+        # without pagination.
         # Corresponds to the JSON property `totalPeople`
         # @return [Fixnum]
         attr_accessor :total_people
@@ -1013,8 +1028,7 @@ module Google
       class ListContactGroupsResponse
         include Google::Apis::Core::Hashable
       
-        # The list of contact groups. Members of the contact groups are not
-        # populated.
+        # The list of contact groups. Members of the contact groups are not populated.
         # Corresponds to the JSON property `contactGroups`
         # @return [Array<Google::Apis::PeopleV1::ContactGroup>]
         attr_accessor :contact_groups
@@ -1051,15 +1065,14 @@ module Google
       class ListDirectoryPeopleResponse
         include Google::Apis::Core::Hashable
       
-        # A token, which can be sent as `page_token` to retrieve the next page.
-        # If this field is omitted, there are no subsequent pages.
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # A token, which can be sent as `sync_token` to retrieve changes since the
-        # last request. Request must set `request_sync_token` to return the sync
-        # token.
+        # A token, which can be sent as `sync_token` to retrieve changes since the last
+        # request. Request must set `request_sync_token` to return the sync token.
         # Corresponds to the JSON property `nextSyncToken`
         # @return [String]
         attr_accessor :next_sync_token
@@ -1085,22 +1098,21 @@ module Google
       class ListOtherContactsResponse
         include Google::Apis::Core::Hashable
       
-        # A token, which can be sent as `page_token` to retrieve the next page.
-        # If this field is omitted, there are no subsequent pages.
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # A token, which can be sent as `sync_token` to retrieve changes since the
-        # last request. Request must set `request_sync_token` to return the sync
-        # token.
+        # A token, which can be sent as `sync_token` to retrieve changes since the last
+        # request. Request must set `request_sync_token` to return the sync token.
         # Corresponds to the JSON property `nextSyncToken`
         # @return [String]
         attr_accessor :next_sync_token
       
         # The list of "Other contacts" returned as Person resources. "Other contacts"
-        # support a limited subset of fields. See
-        # ListOtherContactsRequest.request_mask for more detailed information.
+        # support a limited subset of fields. See ListOtherContactsRequest.request_mask
+        # for more detailed information.
         # Corresponds to the JSON property `otherContacts`
         # @return [Array<Google::Apis::PeopleV1::Person>]
         attr_accessor :other_contacts
@@ -1126,8 +1138,8 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
-        # language tag representing the locale.
+        # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47) language tag
+        # representing the locale.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1175,20 +1187,58 @@ module Google
         end
       end
       
+      # A person's miscellaneous keyword.
+      class MiscKeyword
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The type of the miscellaneous keyword translated and formatted in
+        # the viewer's account locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedType`
+        # @return [String]
+        attr_accessor :formatted_type
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The miscellaneous keyword type.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The value of the miscellaneous keyword.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @type = args[:type] if args.key?(:type)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # A request to modify an existing contact group's members. Contacts can be
-      # removed from any group but they can only be added to a user group or
-      # "myContacts" or "starred" system groups.
+      # removed from any group but they can only be added to a user group or "
+      # myContacts" or "starred" system groups.
       class ModifyContactGroupMembersRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. The resource names of the contact people to add in the form of
-        # `people/`person_id``.
+        # Optional. The resource names of the contact people to add in the form of `
+        # people/`person_id``.
         # Corresponds to the JSON property `resourceNamesToAdd`
         # @return [Array<String>]
         attr_accessor :resource_names_to_add
       
-        # Optional. The resource names of the contact people to remove in the form of
-        # `people/`person_id``.
+        # Optional. The resource names of the contact people to remove in the form of `
+        # people/`person_id``.
         # Corresponds to the JSON property `resourceNamesToRemove`
         # @return [Array<String>]
         attr_accessor :resource_names_to_remove
@@ -1208,8 +1258,8 @@ module Google
       class ModifyContactGroupMembersResponse
         include Google::Apis::Core::Hashable
       
-        # The contact people resource names that cannot be removed from their
-        # last contact group.
+        # The contact people resource names that cannot be removed from their last
+        # contact group.
         # Corresponds to the JSON property `canNotRemoveLastContactGroupResourceNames`
         # @return [Array<String>]
         attr_accessor :can_not_remove_last_contact_group_resource_names
@@ -1241,8 +1291,8 @@ module Google
         attr_accessor :display_name
       
         # Output only. The display name with the last name first formatted according to
-        # the locale specified by the viewer's account or the
-        # `Accept-Language` HTTP header.
+        # the locale specified by the viewer's account or the `Accept-Language` HTTP
+        # header.
         # Corresponds to the JSON property `displayNameLastFirst`
         # @return [String]
         attr_accessor :display_name_last_first
@@ -1392,13 +1442,12 @@ module Google
         end
       end
       
-      # A person's past or current organization. Overlapping date ranges are
-      # permitted.
+      # A person's past or current organization. Overlapping date ranges are permitted.
       class Organization
         include Google::Apis::Core::Hashable
       
-        # True if the organization is the person's current organization;
-        # false if the organization is a past organization.
+        # True if the organization is the person's current organization; false if the
+        # organization is a past organization.
         # Corresponds to the JSON property `current`
         # @return [Boolean]
         attr_accessor :current
@@ -1409,20 +1458,19 @@ module Google
         # @return [String]
         attr_accessor :department
       
-        # The domain name associated with the organization; for example,
-        # `google.com`.
+        # The domain name associated with the organization; for example, `google.com`.
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
       
         # Represents a whole or partial calendar date, e.g. a birthday. The time of day
         # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent:
-        # * A full date, with non-zero year, month and day values
-        # * A month and day value, with a zero year, e.g. an anniversary
-        # * A year on its own, with zero month and day values
-        # * A year and month value, with a zero day, e.g. a credit card expiration date
-        # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
+        # date, with non-zero year, month and day values * A month and day value, with a
+        # zero year, e.g. an anniversary * A year on its own, with zero month and day
+        # values * A year and month value, with a zero day, e.g. a credit card
+        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
+        # Timestamp`.
         # Corresponds to the JSON property `endDate`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :end_date
@@ -1460,12 +1508,12 @@ module Google
       
         # Represents a whole or partial calendar date, e.g. a birthday. The time of day
         # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent:
-        # * A full date, with non-zero year, month and day values
-        # * A month and day value, with a zero year, e.g. an anniversary
-        # * A year on its own, with zero month and day values
-        # * A year and month value, with a zero day, e.g. a credit card expiration date
-        # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.
+        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
+        # date, with non-zero year, month and day values * A month and day value, with a
+        # zero year, e.g. an anniversary * A year on its own, with zero month and day
+        # values * A year and month value, with a zero day, e.g. a credit card
+        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
+        # Timestamp`.
         # Corresponds to the JSON property `startDate`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :start_date
@@ -1481,10 +1529,8 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # The type of the organization. The type can be custom or  one of these
-        # predefined values:
-        # * `work`
-        # * `school`
+        # The type of the organization. The type can be custom or one of these
+        # predefined values: * `work` * `school`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1513,10 +1559,9 @@ module Google
       end
       
       # Information about a person merged from various data sources such as the
-      # authenticated user's contacts and profile data.
-      # Most fields can have multiple items. The items in a field have no guaranteed
-      # order, but each non-empty field is guaranteed to have exactly one field with
-      # `metadata.primary` set to true.
+      # authenticated user's contacts and profile data. Most fields can have multiple
+      # items. The items in a field have no guaranteed order, but each non-empty field
+      # is guaranteed to have exactly one field with `metadata.primary` set to true.
       class Person
         include Google::Apis::Core::Hashable
       
@@ -1525,8 +1570,8 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Address>]
         attr_accessor :addresses
       
-        # Output only. **DEPRECATED** (Please use `person.ageRanges` instead)
-        # The person's age range.
+        # Output only. **DEPRECATED** (Please use `person.ageRanges` instead) The person'
+        # s age range.
         # Corresponds to the JSON property `ageRange`
         # @return [String]
         attr_accessor :age_range
@@ -1536,22 +1581,26 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::AgeRangeType>]
         attr_accessor :age_ranges
       
-        # The person's biographies.
+        # The person's biographies. This field is a singleton for contact sources.
         # Corresponds to the JSON property `biographies`
         # @return [Array<Google::Apis::PeopleV1::Biography>]
         attr_accessor :biographies
       
-        # The person's birthdays.
+        # The person's birthdays. This field is a singleton for contact sources.
         # Corresponds to the JSON property `birthdays`
         # @return [Array<Google::Apis::PeopleV1::Birthday>]
         attr_accessor :birthdays
       
-        # **DEPRECATED**: No data will be returned
-        # The person's bragging rights.
+        # **DEPRECATED**: No data will be returned The person's bragging rights.
         # Corresponds to the JSON property `braggingRights`
         # @return [Array<Google::Apis::PeopleV1::BraggingRights>]
         attr_accessor :bragging_rights
       
+        # The person's calendar URLs.
+        # Corresponds to the JSON property `calendarUrls`
+        # @return [Array<Google::Apis::PeopleV1::CalendarUrl>]
+        attr_accessor :calendar_urls
+      
         # Output only. The person's cover photos.
         # Corresponds to the JSON property `coverPhotos`
         # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
@@ -1562,8 +1611,8 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::EmailAddress>]
         attr_accessor :email_addresses
       
-        # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
-        # resource. Used for web cache validation.
+        # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the resource.
+        # Used for web cache validation.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -1573,12 +1622,17 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Event>]
         attr_accessor :events
       
+        # The person's external IDs.
+        # Corresponds to the JSON property `externalIds`
+        # @return [Array<Google::Apis::PeopleV1::ExternalId>]
+        attr_accessor :external_ids
+      
         # The person's file-ases.
         # Corresponds to the JSON property `fileAses`
         # @return [Array<Google::Apis::PeopleV1::FileAs>]
         attr_accessor :file_ases
       
-        # The person's genders.
+        # The person's genders. This field is a singleton for contact sources.
         # Corresponds to the JSON property `genders`
         # @return [Array<Google::Apis::PeopleV1::Gender>]
         attr_accessor :genders
@@ -1608,7 +1662,12 @@ module Google
         # @return [Google::Apis::PeopleV1::PersonMetadata]
         attr_accessor :metadata
       
-        # The person's names.
+        # The person's miscellaneous keywords.
+        # Corresponds to the JSON property `miscKeywords`
+        # @return [Array<Google::Apis::PeopleV1::MiscKeyword>]
+        attr_accessor :misc_keywords
+      
+        # The person's names. This field is a singleton for contact sources.
         # Corresponds to the JSON property `names`
         # @return [Array<Google::Apis::PeopleV1::Name>]
         attr_accessor :names
@@ -1643,14 +1702,14 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Relation>]
         attr_accessor :relations
       
-        # Output only. **DEPRECATED**: No data will be returned
-        # The person's relationship interests.
+        # Output only. **DEPRECATED**: No data will be returned The person's
+        # relationship interests.
         # Corresponds to the JSON property `relationshipInterests`
         # @return [Array<Google::Apis::PeopleV1::RelationshipInterest>]
         attr_accessor :relationship_interests
       
-        # Output only. **DEPRECATED**: No data will be returned
-        # The person's relationship statuses.
+        # Output only. **DEPRECATED**: No data will be returned The person's
+        # relationship statuses.
         # Corresponds to the JSON property `relationshipStatuses`
         # @return [Array<Google::Apis::PeopleV1::RelationshipStatus>]
         attr_accessor :relationship_statuses
@@ -1660,9 +1719,8 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Residence>]
         attr_accessor :residences
       
-        # The resource name for the person, assigned by the server. An ASCII string
-        # with a max length of 27 characters, in the form of
-        # `people/`person_id``.
+        # The resource name for the person, assigned by the server. An ASCII string with
+        # a max length of 27 characters, in the form of `people/`person_id``.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
@@ -1677,8 +1735,7 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Skill>]
         attr_accessor :skills
       
-        # Output only. **DEPRECATED**: No data will be returned
-        # The person's taglines.
+        # Output only. **DEPRECATED**: No data will be returned The person's taglines.
         # Corresponds to the JSON property `taglines`
         # @return [Array<Google::Apis::PeopleV1::Tagline>]
         attr_accessor :taglines
@@ -1705,10 +1762,12 @@ module Google
           @biographies = args[:biographies] if args.key?(:biographies)
           @birthdays = args[:birthdays] if args.key?(:birthdays)
           @bragging_rights = args[:bragging_rights] if args.key?(:bragging_rights)
+          @calendar_urls = args[:calendar_urls] if args.key?(:calendar_urls)
           @cover_photos = args[:cover_photos] if args.key?(:cover_photos)
           @email_addresses = args[:email_addresses] if args.key?(:email_addresses)
           @etag = args[:etag] if args.key?(:etag)
           @events = args[:events] if args.key?(:events)
+          @external_ids = args[:external_ids] if args.key?(:external_ids)
           @file_ases = args[:file_ases] if args.key?(:file_ases)
           @genders = args[:genders] if args.key?(:genders)
           @im_clients = args[:im_clients] if args.key?(:im_clients)
@@ -1716,6 +1775,7 @@ module Google
           @locales = args[:locales] if args.key?(:locales)
           @memberships = args[:memberships] if args.key?(:memberships)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @misc_keywords = args[:misc_keywords] if args.key?(:misc_keywords)
           @names = args[:names] if args.key?(:names)
           @nicknames = args[:nicknames] if args.key?(:nicknames)
           @occupations = args[:occupations] if args.key?(:occupations)
@@ -1739,9 +1799,9 @@ module Google
       class PersonMetadata
         include Google::Apis::Core::Hashable
       
-        # Output only. 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.
+        # Output only. 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.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
@@ -1752,19 +1812,17 @@ module Google
         # @return [Array<String>]
         attr_accessor :linked_people_resource_names
       
-        # Output only. **DEPRECATED** (Please use
-        # `person.metadata.sources.profileMetadata.objectType` instead)
-        # The type of the person object.
+        # Output only. **DEPRECATED** (Please use `person.metadata.sources.
+        # profileMetadata.objectType` instead) The type of the person object.
         # Corresponds to the JSON property `objectType`
         # @return [String]
         attr_accessor :object_type
       
         # Output only. 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.
+        # 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.
         # Corresponds to the JSON property `previousResourceNames`
         # @return [Array<String>]
         attr_accessor :previous_resource_names
@@ -1792,37 +1850,34 @@ module Google
       class PersonResponse
         include Google::Apis::Core::Hashable
       
-        # **DEPRECATED** (Please use status instead)
-        # [HTTP 1.1 status code]
-        # (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
+        # **DEPRECATED** (Please use status instead) [HTTP 1.1 status code] (http://www.
+        # w3.org/Protocols/rfc2616/rfc2616-sec10.html).
         # Corresponds to the JSON property `httpStatusCode`
         # @return [Fixnum]
         attr_accessor :http_status_code
       
         # Information about a person merged from various data sources such as the
-        # authenticated user's contacts and profile data.
-        # Most fields can have multiple items. The items in a field have no guaranteed
-        # order, but each non-empty field is guaranteed to have exactly one field with
-        # `metadata.primary` set to true.
+        # authenticated user's contacts and profile data. Most fields can have multiple
+        # items. The items in a field have no guaranteed order, but each non-empty field
+        # is guaranteed to have exactly one field with `metadata.primary` set to true.
         # Corresponds to the JSON property `person`
         # @return [Google::Apis::PeopleV1::Person]
         attr_accessor :person
       
-        # The original requested resource name. May be different than the resource
-        # name on the returned person.
-        # The resource name can change when adding or removing fields that link a
-        # contact and profile such as a verified email, verified phone number, or a
-        # profile URL.
+        # The original requested resource name. May be different than the resource name
+        # on the returned person. The resource name can change when adding or removing
+        # fields that link a contact and profile such as a verified email, verified
+        # phone number, or a profile URL.
         # Corresponds to the JSON property `requestedResourceName`
         # @return [String]
         attr_accessor :requested_resource_name
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `status`
         # @return [Google::Apis::PeopleV1::Status]
         attr_accessor :status
@@ -1844,9 +1899,8 @@ module Google
       class PhoneNumber
         include Google::Apis::Core::Hashable
       
-        # Output only. The canonicalized [ITU-T
-        # E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
-        # form of the phone number.
+        # Output only. The canonicalized [ITU-T E.164](https://law.resource.org/pub/us/
+        # cfr/ibr/004/itu-t.E.164.1.2008.pdf) form of the phone number.
         # Corresponds to the JSON property `canonicalForm`
         # @return [String]
         attr_accessor :canonical_form
@@ -1863,19 +1917,9 @@ module Google
         attr_accessor :metadata
       
         # The type of the phone number. The type can be custom or one of these
-        # predefined values:
-        # * `home`
-        # * `work`
-        # * `mobile`
-        # * `homeFax`
-        # * `workFax`
-        # * `otherFax`
-        # * `pager`
-        # * `workMobile`
-        # * `workPager`
-        # * `main`
-        # * `googleVoice`
-        # * `other`
+        # predefined values: * `home` * `work` * `mobile` * `homeFax` * `workFax` * `
+        # otherFax` * `pager` * `workMobile` * `workPager` * `main` * `googleVoice` * `
+        # other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1899,13 +1943,13 @@ module Google
         end
       end
       
-      # A person's photo. A picture shown next to the person's name to
-      # help others recognize the person.
+      # A person's photo. A picture shown next to the person's name to help others
+      # recognize the person.
       class Photo
         include Google::Apis::Core::Hashable
       
-        # True if the photo is a default photo;
-        # false if the photo is a user-provided photo.
+        # True if the photo is a default photo; false if the photo is a user-provided
+        # photo.
         # Corresponds to the JSON property `default`
         # @return [Boolean]
         attr_accessor :default
@@ -1918,9 +1962,8 @@ module Google
       
         # The URL of the photo. You can change the desired size by appending a query
         # parameter `sz=`size`` at the end of the url, where `size` is the size in
-        # pixels. Example:
-        # https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/
-        # 00gzXvDBYqw/s100/photo.jpg?sz=50
+        # pixels. Example: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/
+        # AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -1983,21 +2026,9 @@ module Google
         attr_accessor :person
       
         # The person's relation to the other person. The type can be custom or one of
-        # these predefined values:
-        # * `spouse`
-        # * `child`
-        # * `mother`
-        # * `father`
-        # * `parent`
-        # * `brother`
-        # * `sister`
-        # * `friend`
-        # * `relative`
-        # * `domesticPartner`
-        # * `manager`
-        # * `assistant`
-        # * `referredBy`
-        # * `partner`
+        # these predefined values: * `spouse` * `child` * `mother` * `father` * `parent`
+        # * `brother` * `sister` * `friend` * `relative` * `domesticPartner` * `manager`
+        # * `assistant` * `referredBy` * `partner`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2015,14 +2046,13 @@ module Google
         end
       end
       
-      # **DEPRECATED**: No data will be returned
-      # A person's relationship interest .
+      # **DEPRECATED**: No data will be returned A person's relationship interest .
       class RelationshipInterest
         include Google::Apis::Core::Hashable
       
         # Output only. The value of the relationship interest translated and formatted
-        # in the viewer's account locale or the locale specified in the
-        # Accept-Language HTTP header.
+        # in the viewer's account locale or the locale specified in the Accept-Language
+        # HTTP header.
         # Corresponds to the JSON property `formattedValue`
         # @return [String]
         attr_accessor :formatted_value
@@ -2032,12 +2062,9 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The kind of relationship the person is looking for. The value can be custom
-        # or one of these predefined values:
-        # * `friend`
-        # * `date`
-        # * `relationship`
-        # * `networking`
+        # The kind of relationship the person is looking for. The value can be custom or
+        # one of these predefined values: * `friend` * `date` * `relationship` * `
+        # networking`
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2054,8 +2081,7 @@ module Google
         end
       end
       
-      # **DEPRECATED**: No data will be returned
-      # A person's relationship status.
+      # **DEPRECATED**: No data will be returned A person's relationship status.
       class RelationshipStatus
         include Google::Apis::Core::Hashable
       
@@ -2070,17 +2096,10 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The relationship status. The value can be custom or one of these
-        # predefined values:
-        # * `single`
-        # * `inARelationship`
-        # * `engaged`
-        # * `married`
-        # * `itsComplicated`
-        # * `openRelationship`
-        # * `widowed`
-        # * `inDomesticPartnership`
-        # * `inCivilUnion`
+        # The relationship status. The value can be custom or one of these predefined
+        # values: * `single` * `inARelationship` * `engaged` * `married` * `
+        # itsComplicated` * `openRelationship` * `widowed` * `inDomesticPartnership` * `
+        # inCivilUnion`
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2101,8 +2120,8 @@ module Google
       class Residence
         include Google::Apis::Core::Hashable
       
-        # True if the residence is the person's current residence;
-        # false if the residence is a past residence.
+        # True if the residence is the person's current residence; false if the
+        # residence is a past residence.
         # Corresponds to the JSON property `current`
         # @return [Boolean]
         attr_accessor :current
@@ -2135,8 +2154,8 @@ module Google
       class SearchDirectoryPeopleResponse
         include Google::Apis::Core::Hashable
       
-        # A token, which can be sent as `page_token` to retrieve the next page.
-        # If this field is omitted, there are no subsequent pages.
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2180,18 +2199,13 @@ module Google
         attr_accessor :metadata
       
         # The type of the SIP address. The type can be custom or or one of these
-        # predefined values:
-        # * `home`
-        # * `work`
-        # * `mobile`
-        # * `other`
+        # predefined values: * `home` * `work` * `mobile` * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # The SIP address in the
-        # [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#section-19.1) SIP URI
-        # format.
+        # The SIP address in the [RFC 3261 19.1](https://tools.ietf.org/html/rfc3261#
+        # section-19.1) SIP URI format.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -2238,9 +2252,8 @@ module Google
       class Source
         include Google::Apis::Core::Hashable
       
-        # **Only populated in `person.metadata.sources`.**
-        # The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
-        # source. Used for web cache validation.
+        # **Only populated in `person.metadata.sources`.** The [HTTP entity tag](https://
+        # en.wikipedia.org/wiki/HTTP_ETag) of the source. Used for web cache validation.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -2260,8 +2273,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Output only. **Only populated in `person.metadata.sources`.**
-        # Last update timestamp of this source.
+        # Output only. **Only populated in `person.metadata.sources`.** Last update
+        # timestamp of this source.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -2280,12 +2293,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -2294,15 +2307,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -2319,8 +2332,8 @@ module Google
         end
       end
       
-      # **DEPRECATED**: No data will be returned
-      # A brief one-line description of the person.
+      # **DEPRECATED**: No data will be returned A brief one-line description of the
+      # person.
       class Tagline
         include Google::Apis::Core::Hashable
       
@@ -2345,8 +2358,8 @@ module Google
         end
       end
       
-      # A request to update an existing user contact group. All updated fields will
-      # be replaced.
+      # A request to update an existing user contact group. All updated fields will be
+      # replaced.
       class UpdateContactGroupRequest
         include Google::Apis::Core::Hashable
       
@@ -2365,40 +2378,19 @@ module Google
         end
       end
       
-      # A request to update an existing contact's photo.
-      # All requests must have a valid photo format: JPEG or PNG.
+      # A request to update an existing contact's photo. All requests must have a
+      # valid photo format: JPEG or PNG.
       class UpdateContactPhotoRequest
         include Google::Apis::Core::Hashable
       
         # Optional. A field mask to restrict which fields on the person are returned.
-        # Multiple
-        # fields can be specified by separating them with commas. Defaults to empty
-        # if not set, which will skip the post mutate get. Valid values are:
-        # * addresses
-        # * ageRanges
-        # * biographies
-        # * birthdays
-        # * coverPhotos
-        # * emailAddresses
-        # * events
-        # * genders
-        # * imClients
-        # * interests
-        # * locales
-        # * memberships
-        # * metadata
-        # * names
-        # * nicknames
-        # * occupations
-        # * organizations
-        # * phoneNumbers
-        # * photos
-        # * relations
-        # * residences
-        # * sipAddresses
-        # * skills
-        # * urls
-        # * userDefined
+        # Multiple fields can be specified by separating them with commas. Defaults to
+        # empty if not set, which will skip the post mutate get. Valid values are: *
+        # addresses * ageRanges * biographies * birthdays * calendarUrls * coverPhotos *
+        # emailAddresses * events * externalIds * genders * imClients * interests *
+        # locales * memberships * metadata * miscKeywords * names * nicknames *
+        # occupations * organizations * phoneNumbers * photos * relations * residences *
+        # sipAddresses * skills * urls * userDefined
         # Corresponds to the JSON property `personFields`
         # @return [String]
         attr_accessor :person_fields
@@ -2409,10 +2401,8 @@ module Google
         # @return [String]
         attr_accessor :photo_bytes
       
-        # Optional. A mask of what source types to return. Defaults to
-        # ReadSourceType.CONTACT and
-        # ReadSourceType.PROFILE if not
-        # set.
+        # Optional. A mask of what source types to return. Defaults to ReadSourceType.
+        # CONTACT and ReadSourceType.PROFILE if not set.
         # Corresponds to the JSON property `sources`
         # @return [Array<String>]
         attr_accessor :sources
@@ -2434,10 +2424,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Information about a person merged from various data sources such as the
-        # authenticated user's contacts and profile data.
-        # Most fields can have multiple items. The items in a field have no guaranteed
-        # order, but each non-empty field is guaranteed to have exactly one field with
-        # `metadata.primary` set to true.
+        # authenticated user's contacts and profile data. Most fields can have multiple
+        # items. The items in a field have no guaranteed order, but each non-empty field
+        # is guaranteed to have exactly one field with `metadata.primary` set to true.
         # Corresponds to the JSON property `person`
         # @return [Google::Apis::PeopleV1::Person]
         attr_accessor :person
@@ -2467,17 +2456,9 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The type of the URL. The type can be custom or one of these predefined
-        # values:
-        # * `home`
-        # * `work`
-        # * `blog`
-        # * `profile`
-        # * `homePage`
-        # * `ftp`
-        # * `reservations`
-        # * `appInstallPage`: website for a Google+ application.
-        # * `other`
+        # The type of the URL. The type can be custom or one of these predefined values:
+        # * `home` * `work` * `blog` * `profile` * `homePage` * `ftp` * `reservations` *
+        # `appInstallPage`: website for a Google+ application. * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type