google-api-client 0.43.0 → 0.48.0

data/generated/google/apis/oslogin_v1beta/service.rb

@@ -47,8 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Retrieves the profile information used for logging in to a virtual machine
-        # on Google Compute Engine.
+        # Retrieves the profile information used for logging in to a virtual machine on
+        # Google Compute Engine.
         # @param [String] name
         #   Required. The unique ID for the user in format `users/`user``.
         # @param [String] project_id
@@ -85,8 +85,8 @@ module Google
         end
         
         # Adds an SSH public key and returns the profile information. Default POSIX
-        # account information is set when no username and UID exist as part of the
-        # login profile.
+        # account information is set when no username and UID exist as part of the login
+        # profile.
         # @param [String] parent
         #   The unique ID for the user in format `users/`user``.
         # @param [Google::Apis::OsloginV1beta::SshPublicKey] ssh_public_key_object
@@ -125,9 +125,8 @@ module Google
         # Deletes a POSIX account.
         # @param [String] name
         #   Required. A reference to the POSIX account to update. POSIX accounts are
-        #   identified
-        #   by the project ID they are associated with. A reference to the POSIX
-        #   account is in format `users/`user`/projects/`project``.
+        #   identified by the project ID they are associated with. A reference to the
+        #   POSIX account is in format `users/`user`/projects/`project``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -158,9 +157,8 @@ module Google
         # Deletes an SSH public key.
         # @param [String] name
         #   Required. The fingerprint of the public key to update. Public keys are
-        #   identified by
-        #   their SHA-256 fingerprint. The fingerprint of the public key is in format
-        #   `users/`user`/sshPublicKeys/`fingerprint``.
+        #   identified by their SHA-256 fingerprint. The fingerprint of the public key is
+        #   in format `users/`user`/sshPublicKeys/`fingerprint``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -191,9 +189,8 @@ module Google
         # Retrieves an SSH public key.
         # @param [String] name
         #   Required. The fingerprint of the public key to retrieve. Public keys are
-        #   identified
-        #   by their SHA-256 fingerprint. The fingerprint of the public key is in
-        #   format `users/`user`/sshPublicKeys/`fingerprint``.
+        #   identified by their SHA-256 fingerprint. The fingerprint of the public key is
+        #   in format `users/`user`/sshPublicKeys/`fingerprint``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -225,9 +222,8 @@ module Google
         # supports patch semantics.
         # @param [String] name
         #   Required. The fingerprint of the public key to update. Public keys are
-        #   identified by
-        #   their SHA-256 fingerprint. The fingerprint of the public key is in format
-        #   `users/`user`/sshPublicKeys/`fingerprint``.
+        #   identified by their SHA-256 fingerprint. The fingerprint of the public key is
+        #   in format `users/`user`/sshPublicKeys/`fingerprint``.
         # @param [Google::Apis::OsloginV1beta::SshPublicKey] ssh_public_key_object
         # @param [String] update_mask
         #   Mask to control which fields get updated. Updates all if not present.

data/generated/google/apis/oslogin_v1beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/compute/docs/oslogin/
     module OsloginV1beta
       VERSION = 'V1beta'
-      REVISION = '20200215'
+      REVISION = '20200810'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -55,8 +55,7 @@ module Google
       end
       
       # A proportion of data in the total distribution, bucketed by a min/max
-      # percentage. Each bucket's range is bounded by min <= x < max, In
-      # millisecond.
+      # percentage. Each bucket's range is bounded by min <= x < max, In millisecond.
       class Bucket
         include Google::Apis::Core::Hashable
       
@@ -159,8 +158,7 @@ module Google
       class ConfigSettings
         include Google::Apis::Core::Hashable
       
-        # How Lighthouse was run, e.g. from the Chrome extension or from the npm
-        # module.
+        # How Lighthouse was run, e.g. from the Chrome extension or from the npm module.
         # Corresponds to the JSON property `channel`
         # @return [String]
         attr_accessor :channel
@@ -277,9 +275,9 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # A numeric value that has a meaning specific to the audit, e.g. the number
-        # of nodes in the DOM or the timestamp of a specific load event. More
-        # information can be found in the audit details, if present.
+        # A numeric value that has a meaning specific to the audit, e.g. the number of
+        # nodes in the DOM or the timestamp of a specific load event. More information
+        # can be found in the audit details, if present.
         # Corresponds to the JSON property `numericValue`
         # @return [Float]
         attr_accessor :numeric_value
@@ -348,8 +346,8 @@ module Google
         # @return [String]
         attr_accessor :manual_description
       
-        # The overall score of the category, the weighted average of all its audits.
-        # (The category's score, can be null.)
+        # The overall score of the category, the weighted average of all its audits. (
+        # The category's score, can be null.)
         # Corresponds to the JSON property `score`
         # @return [Object]
         attr_accessor :score
@@ -428,7 +426,7 @@ module Google
         # @return [String]
         attr_accessor :requested_url
       
-        # List of all run warnings in the LHR.  Will always output to at least `[]`.
+        # List of all run warnings in the LHR. Will always output to at least `[]`.
         # Corresponds to the JSON property `runWarnings`
         # @return [Array<Object>]
         attr_accessor :run_warnings
@@ -491,7 +489,7 @@ module Google
         # @return [String]
         attr_accessor :initial_url
       
-        # The map of <metrics, data>.
+        # The map of .
         # Corresponds to the JSON property `metrics`
         # @return [Hash<String,Google::Apis::PagespeedonlineV5::UserPageLoadMetricV5>]
         attr_accessor :metrics
@@ -535,8 +533,8 @@ module Google
         # @return [String]
         attr_accessor :captcha_result
       
-        # Canonicalized and final URL for the document, after following page
-        # redirects (if any).
+        # Canonicalized and final URL for the document, after following page redirects (
+        # if any).
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -642,14 +640,12 @@ module Google
         # @return [String]
         attr_accessor :lab_data_title
       
-        # The disclaimer shown under performance explaning that the network can
-        # vary.
+        # The disclaimer shown under performance explaning that the network can vary.
         # Corresponds to the JSON property `lsPerformanceCategoryDescription`
         # @return [String]
         attr_accessor :ls_performance_category_description
       
-        # The heading shown above a list of audits that were not computerd in the
-        # run.
+        # The heading shown above a list of audits that were not computerd in the run.
         # Corresponds to the JSON property `manualAuditsGroupTitle`
         # @return [String]
         attr_accessor :manual_audits_group_title
@@ -659,8 +655,7 @@ module Google
         # @return [String]
         attr_accessor :not_applicable_audits_group_title
       
-        # The heading for the estimated page load savings opportunity of an
-        # audit.
+        # The heading for the estimated page load savings opportunity of an audit.
         # Corresponds to the JSON property `opportunityResourceColumnLabel`
         # @return [String]
         attr_accessor :opportunity_resource_column_label
@@ -680,8 +675,8 @@ module Google
         # @return [String]
         attr_accessor :scorescale_label
       
-        # The label shown preceding important warnings that may have invalidated
-        # an entire report.
+        # The label shown preceding important warnings that may have invalidated an
+        # entire report.
         # Corresponds to the JSON property `toplevelWarningsMessage`
         # @return [String]
         attr_accessor :toplevel_warnings_message
@@ -831,9 +826,8 @@ module Google
         # @return [String]
         attr_accessor :metric_id
       
-        # We use this field to store certain percentile value for this metric.
-        # For v4, this field contains pc50.
-        # For v5, this field contains pc90.
+        # We use this field to store certain percentile value for this metric. For v4,
+        # this field contains pc50. For v5, this field contains pc90.
         # Corresponds to the JSON property `percentile`
         # @return [Fixnum]
         attr_accessor :percentile

data/generated/google/apis/pagespeedonline_v5/service.rb

@@ -23,7 +23,7 @@ module Google
       # PageSpeed Insights API
       #
       # The PageSpeed Insights API lets you analyze the performance of your website
-      #  with a simple API.  It offers tailored suggestions for how you can optimize
+      #  with a simple API. It offers tailored suggestions for how you can optimize
       #  your site, and lets you easily integrate PageSpeed Insights analysis into your
       #  development tools and workflow.
       #
@@ -61,10 +61,9 @@ module Google
         # @param [String] locale
         #   The locale used to localize formatted results
         # @param [String] strategy
-        #   The analysis strategy (desktop or mobile) to use, and desktop is the
-        #   default
+        #   The analysis strategy (desktop or mobile) to use, and desktop is the default
         # @param [String] url
-        #   The URL to fetch and analyze
+        #   Required. The URL to fetch and analyze
         # @param [String] utm_campaign
         #   Campaign name for analytics.
         # @param [String] utm_source

data/generated/google/apis/pagespeedonline_v5.rb

@@ -21,14 +21,14 @@ module Google
     # PageSpeed Insights API
     #
     # The PageSpeed Insights API lets you analyze the performance of your website
-    # with a simple API.  It offers tailored suggestions for how you can optimize
+    # with a simple API. It offers tailored suggestions for how you can optimize
     # your site, and lets you easily integrate PageSpeed Insights analysis into your
     # development tools and workflow.
     #
     # @see https://developers.google.com/speed/docs/insights/v5/about
     module PagespeedonlineV5
       VERSION = 'V5'
-      REVISION = '20200721'
+      REVISION = '20200813'
 
       # Associate you with your personal info on Google
       PENID = 'openid'

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

@@ -193,14 +193,14 @@ module Google
       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`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as 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
@@ -291,6 +291,38 @@ module Google
         end
       end
       
+      # Arbitrary client data that is populated by clients. Duplicate keys and values
+      # are allowed.
+      class ClientData
+        include Google::Apis::Core::Hashable
+      
+        # The client specified key of the client data.
+        # Corresponds to the JSON property `key`
+        # @return [String]
+        attr_accessor :key
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The client specified value of the client data.
+        # 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)
+          @key = args[:key] if args.key?(:key)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # A contact group.
       class ContactGroup
         include Google::Apis::Core::Hashable
@@ -468,17 +500,17 @@ module Google
         # 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 * calendarUrls *
-        # coverPhotos * emailAddresses * events * externalIds * genders * imClients *
-        # interests * locales * memberships * metadata * miscKeywords * names *
-        # nicknames * occupations * organizations * phoneNumbers * photos * relations *
-        # residences * sipAddresses * skills * urls * userDefined
+        # * addresses * ageRanges * biographies * birthdays * calendarUrls * clientData
+        # * coverPhotos * emailAddresses * events * externalIds * genders * imClients *
+        # interests * locales * locations * memberships * metadata * miscKeywords *
+        # names * nicknames * occupations * organizations * phoneNumbers * photos *
+        # relations * 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
+        # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
         # Corresponds to the JSON property `sources`
         # @return [Array<String>]
         attr_accessor :sources
@@ -548,31 +580,31 @@ module Google
         end
       end
       
-      # 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`.
+      # Represents a whole or partial calendar date, such as a birthday. The time of
+      # day and time zone are either specified elsewhere or are insignificant. The
+      # date is relative to the Gregorian Calendar. This can represent one of the
+      # following: * A full date, with non-zero year, month, and day values * A month
+      # and day value, with a zero year, such as an anniversary * A year on its own,
+      # with zero month and day values * A year and month value, with a zero day, such
+      # as 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
-        # significant.
+        # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to
+        # specify a year by itself or a year and month where the day isn't significant.
         # 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
+        # Month of a year. Must be from 1 to 12, or 0 to specify 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 the date. Must be from 1 to 9999, or 0 to specify a date without a
+        # year.
         # Corresponds to the JSON property `year`
         # @return [Fixnum]
         attr_accessor :year
@@ -697,14 +729,14 @@ module Google
       class Event
         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`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as 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
@@ -994,7 +1026,8 @@ module Google
         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.
+        # request. Request must set `request_sync_token` to return the sync token. When
+        # the response is paginated, only the last page will contain `nextSyncToken`.
         # Corresponds to the JSON property `nextSyncToken`
         # @return [String]
         attr_accessor :next_sync_token
@@ -1155,6 +1188,69 @@ module Google
         end
       end
       
+      # A person's location.
+      class Location
+        include Google::Apis::Core::Hashable
+      
+        # The building identifier.
+        # Corresponds to the JSON property `buildingId`
+        # @return [String]
+        attr_accessor :building_id
+      
+        # Whether the location is the current location.
+        # Corresponds to the JSON property `current`
+        # @return [Boolean]
+        attr_accessor :current
+        alias_method :current?, :current
+      
+        # The individual desk location.
+        # Corresponds to the JSON property `deskCode`
+        # @return [String]
+        attr_accessor :desk_code
+      
+        # The floor name or number.
+        # Corresponds to the JSON property `floor`
+        # @return [String]
+        attr_accessor :floor
+      
+        # The floor section in `floor_name`.
+        # Corresponds to the JSON property `floorSection`
+        # @return [String]
+        attr_accessor :floor_section
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The type of the location. The type can be custom or one of these predefined
+        # values: * `desk` * `grewUp`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The free-form value of the location.
+        # 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)
+          @building_id = args[:building_id] if args.key?(:building_id)
+          @current = args[:current] if args.key?(:current)
+          @desk_code = args[:desk_code] if args.key?(:desk_code)
+          @floor = args[:floor] if args.key?(:floor)
+          @floor_section = args[:floor_section] if args.key?(:floor_section)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @type = args[:type] if args.key?(:type)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # A person's membership in a group. Only contact group memberships can be
       # modified.
       class Membership
@@ -1463,14 +1559,14 @@ module Google
         # @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`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as 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
@@ -1506,14 +1602,14 @@ module Google
         # @return [String]
         attr_accessor :phonetic_name
       
-        # 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`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as 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
@@ -1601,6 +1697,11 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::CalendarUrl>]
         attr_accessor :calendar_urls
       
+        # The person's client data.
+        # Corresponds to the JSON property `clientData`
+        # @return [Array<Google::Apis::PeopleV1::ClientData>]
+        attr_accessor :client_data
+      
         # Output only. The person's cover photos.
         # Corresponds to the JSON property `coverPhotos`
         # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
@@ -1652,6 +1753,11 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Locale>]
         attr_accessor :locales
       
+        # The person's locations.
+        # Corresponds to the JSON property `locations`
+        # @return [Array<Google::Apis::PeopleV1::Location>]
+        attr_accessor :locations
+      
         # The person's group memberships.
         # Corresponds to the JSON property `memberships`
         # @return [Array<Google::Apis::PeopleV1::Membership>]
@@ -1714,7 +1820,8 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::RelationshipStatus>]
         attr_accessor :relationship_statuses
       
-        # The person's residences.
+        # **DEPRECATED**: (Please use `person.locations` instead) The person's
+        # residences.
         # Corresponds to the JSON property `residences`
         # @return [Array<Google::Apis::PeopleV1::Residence>]
         attr_accessor :residences
@@ -1763,6 +1870,7 @@ module Google
           @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)
+          @client_data = args[:client_data] if args.key?(:client_data)
           @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)
@@ -1773,6 +1881,7 @@ module Google
           @im_clients = args[:im_clients] if args.key?(:im_clients)
           @interests = args[:interests] if args.key?(:interests)
           @locales = args[:locales] if args.key?(:locales)
+          @locations = args[:locations] if args.key?(:locations)
           @memberships = args[:memberships] if args.key?(:memberships)
           @metadata = args[:metadata] if args.key?(:metadata)
           @misc_keywords = args[:misc_keywords] if args.key?(:misc_keywords)
@@ -2116,7 +2225,8 @@ module Google
         end
       end
       
-      # A person's past or current residence.
+      # **DEPRECATED**: Please use `person.locations` instead. A person's past or
+      # current residence.
       class Residence
         include Google::Apis::Core::Hashable
       
@@ -2386,11 +2496,11 @@ module Google
         # 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 * calendarUrls * coverPhotos *
-        # emailAddresses * events * externalIds * genders * imClients * interests *
-        # locales * memberships * metadata * miscKeywords * names * nicknames *
-        # occupations * organizations * phoneNumbers * photos * relations * residences *
-        # sipAddresses * skills * urls * userDefined
+        # addresses * ageRanges * biographies * birthdays * calendarUrls * clientData *
+        # coverPhotos * emailAddresses * events * externalIds * genders * imClients *
+        # interests * locales * locations * memberships * metadata * miscKeywords *
+        # names * nicknames * occupations * organizations * phoneNumbers * photos *
+        # relations * sipAddresses * skills * urls * userDefined
         # Corresponds to the JSON property `personFields`
         # @return [String]
         attr_accessor :person_fields
@@ -2401,8 +2511,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
+        # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
         # Corresponds to the JSON property `sources`
         # @return [Array<String>]
         attr_accessor :sources
@@ -2458,7 +2568,7 @@ module Google
       
         # 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`
+        # `appInstallPage`: website for a Currents application. * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type