google-api-client 0.13.2 → 0.13.3

data/generated/google/apis/people_v1.rb

@@ -25,34 +25,34 @@ module Google
     # @see https://developers.google.com/people/
     module PeopleV1
       VERSION = 'V1'
-      REVISION = '20170711'
-
-      # View your basic profile info
-      AUTH_USERINFO_PROFILE = 'https://www.googleapis.com/auth/userinfo.profile'
-
-      # View your email addresses
-      AUTH_USER_EMAILS_READ = 'https://www.googleapis.com/auth/user.emails.read'
+      REVISION = '20170823'
 
       # Manage your contacts
       AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts'
 
+      # View your contacts
+      AUTH_CONTACTS_READONLY = 'https://www.googleapis.com/auth/contacts.readonly'
+
+      # Know the list of people in your circles, your age range, and language
+      AUTH_PLUS_LOGIN = 'https://www.googleapis.com/auth/plus.login'
+
       # View your street addresses
       AUTH_USER_ADDRESSES_READ = 'https://www.googleapis.com/auth/user.addresses.read'
 
+      # View your complete date of birth
+      AUTH_USER_BIRTHDAY_READ = 'https://www.googleapis.com/auth/user.birthday.read'
+
+      # View your email addresses
+      AUTH_USER_EMAILS_READ = 'https://www.googleapis.com/auth/user.emails.read'
+
       # View your phone numbers
       AUTH_USER_PHONENUMBERS_READ = 'https://www.googleapis.com/auth/user.phonenumbers.read'
 
       # View your email address
       AUTH_USERINFO_EMAIL = 'https://www.googleapis.com/auth/userinfo.email'
 
-      # View your contacts
-      AUTH_CONTACTS_READONLY = 'https://www.googleapis.com/auth/contacts.readonly'
-
-      # View your complete date of birth
-      AUTH_USER_BIRTHDAY_READ = 'https://www.googleapis.com/auth/user.birthday.read'
-
-      # Know the list of people in your circles, your age range, and language
-      AUTH_PLUS_LOGIN = 'https://www.googleapis.com/auth/plus.login'
+      # View your basic profile info
+      AUTH_USERINFO_PROFILE = 'https://www.googleapis.com/auth/userinfo.profile'
     end
   end
 end

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

@@ -22,35 +22,77 @@ module Google
   module Apis
     module PeopleV1
       
-      # A person's read-only relationship status.
-      class RelationshipStatus
+      # A person's physical address. May be a P.O. box or street address. All fields
+      # are optional.
+      class Address
         include Google::Apis::Core::Hashable
       
+        # The city of the address.
+        # Corresponds to the JSON property `city`
+        # @return [String]
+        attr_accessor :city
+      
+        # The country of the address.
+        # Corresponds to the JSON property `country`
+        # @return [String]
+        attr_accessor :country
+      
+        # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
+        # code of the address.
+        # Corresponds to the JSON property `countryCode`
+        # @return [String]
+        attr_accessor :country_code
+      
+        # The extended address of the address; for example, the apartment number.
+        # Corresponds to the JSON property `extendedAddress`
+        # @return [String]
+        attr_accessor :extended_address
+      
+        # The read-only type of the address 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
+      
+        # 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
+      
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The relationship status. The value can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `single`
-        # * `inARelationship`
-        # * `engaged`
-        # * `married`
-        # * `itsComplicated`
-        # * `openRelationship`
-        # * `widowed`
-        # * `inDomesticPartnership`
-        # * `inCivilUnion`
-        # Corresponds to the JSON property `value`
+        # The P.O. box of the address.
+        # Corresponds to the JSON property `poBox`
         # @return [String]
-        attr_accessor :value
+        attr_accessor :po_box
       
-        # The read-only value of the relationship status translated and formatted in
-        # the viewer's account locale or the `Accept-Language` HTTP header locale.
-        # Corresponds to the JSON property `formattedValue`
+        # The postal code of the address.
+        # Corresponds to the JSON property `postalCode`
         # @return [String]
-        attr_accessor :formatted_value
+        attr_accessor :postal_code
+      
+        # The region of the address; for example, the state or province.
+        # Corresponds to the JSON property `region`
+        # @return [String]
+        attr_accessor :region
+      
+        # The street address.
+        # Corresponds to the JSON property `streetAddress`
+        # @return [String]
+        attr_accessor :street_address
+      
+        # The type of the address. The type can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `home`
+        # * `work`
+        # * `other`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
       
         def initialize(**args)
            update!(**args)
@@ -58,20 +100,29 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
+          @city = args[:city] if args.key?(:city)
+          @country = args[:country] if args.key?(:country)
+          @country_code = args[:country_code] if args.key?(:country_code)
+          @extended_address = args[:extended_address] if args.key?(:extended_address)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
           @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @po_box = args[:po_box] if args.key?(:po_box)
+          @postal_code = args[:postal_code] if args.key?(:postal_code)
+          @region = args[:region] if args.key?(:region)
+          @street_address = args[:street_address] if args.key?(:street_address)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
-      # A person's bragging rights.
-      class BraggingRights
+      # A person's age range.
+      class AgeRangeType
         include Google::Apis::Core::Hashable
       
-        # The bragging rights; for example, `climbed mount everest`.
-        # Corresponds to the JSON property `value`
+        # The age range.
+        # Corresponds to the JSON property `ageRange`
         # @return [String]
-        attr_accessor :value
+        attr_accessor :age_range
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
@@ -84,83 +135,66 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @value = args[:value] if args.key?(:value)
+          @age_range = args[:age_range] if args.key?(:age_range)
           @metadata = args[:metadata] if args.key?(:metadata)
         end
       end
       
-      # A person's past or current organization. Overlapping date ranges are
-      # permitted.
-      class Organization
+      # The response to a batch get contact groups request.
+      class BatchGetContactGroupsResponse
         include Google::Apis::Core::Hashable
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
-      
-        # The location of the organization office the person works at.
-        # Corresponds to the JSON property `location`
-        # @return [String]
-        attr_accessor :location
+        # The list of responses for each requested contact group resource.
+        # Corresponds to the JSON property `responses`
+        # @return [Array<Google::Apis::PeopleV1::ContactGroupResponse>]
+        attr_accessor :responses
       
-        # The person's job title at the organization.
-        # Corresponds to the JSON property `title`
-        # @return [String]
-        attr_accessor :title
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # 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
-        alias_method :current?, :current
+        # Update properties of this object
+        def update!(**args)
+          @responses = args[:responses] if args.key?(:responses)
+        end
+      end
       
-        # Represents a whole calendar date, for example a date of birth. The time
-        # of day and time zone are either specified elsewhere or are not
-        # significant. The date is relative to the
-        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
-        # Proleptic_Gregorian_calendar).
-        # The day may be 0 to represent a year and month where the day is not
-        # significant. The year may be 0 to represent a month and day independent
-        # of year; for example, anniversary date.
-        # Corresponds to the JSON property `startDate`
-        # @return [Google::Apis::PeopleV1::Date]
-        attr_accessor :start_date
+      # A person's short biography.
+      class Biography
+        include Google::Apis::Core::Hashable
       
-        # The read-only type of the organization translated and formatted in the
-        # viewer's account locale or the `Accept-Language` HTTP header locale.
-        # Corresponds to the JSON property `formattedType`
+        # The content type of the biography.
+        # Corresponds to the JSON property `contentType`
         # @return [String]
-        attr_accessor :formatted_type
+        attr_accessor :content_type
       
-        # The domain name associated with the organization; for example, `google.com`.
-        # Corresponds to the JSON property `domain`
-        # @return [String]
-        attr_accessor :domain
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-        # The person's department at the organization.
-        # Corresponds to the JSON property `department`
+        # The short biography.
+        # Corresponds to the JSON property `value`
         # @return [String]
-        attr_accessor :department
+        attr_accessor :value
       
-        # The type of the organization. The type can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `work`
-        # * `school`
-        # Corresponds to the JSON property `type`
-        # @return [String]
-        attr_accessor :type
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # The phonetic name of the organization.
-        # Corresponds to the JSON property `phoneticName`
-        # @return [String]
-        attr_accessor :phonetic_name
+        # Update properties of this object
+        def update!(**args)
+          @content_type = args[:content_type] if args.key?(:content_type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
       
-        # The person's job description at the organization.
-        # Corresponds to the JSON property `jobDescription`
-        # @return [String]
-        attr_accessor :job_description
+      # 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.
+      class Birthday
+        include Google::Apis::Core::Hashable
       
         # Represents a whole calendar date, for example a date of birth. The time
         # of day and time zone are either specified elsewhere or are not
@@ -170,20 +204,19 @@ module Google
         # The day may be 0 to represent a year and month where the day is not
         # significant. The year may be 0 to represent a month and day independent
         # of year; for example, anniversary date.
-        # Corresponds to the JSON property `endDate`
+        # Corresponds to the JSON property `date`
         # @return [Google::Apis::PeopleV1::Date]
-        attr_accessor :end_date
+        attr_accessor :date
       
-        # The symbol associated with the organization; for example, a stock ticker
-        # symbol, abbreviation, or acronym.
-        # Corresponds to the JSON property `symbol`
-        # @return [String]
-        attr_accessor :symbol
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-        # The name of the organization.
-        # Corresponds to the JSON property `name`
+        # A free-form string representing the user's birthday.
+        # Corresponds to the JSON property `text`
         # @return [String]
-        attr_accessor :name
+        attr_accessor :text
       
         def initialize(**args)
            update!(**args)
@@ -191,72 +224,89 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @date = args[:date] if args.key?(:date)
           @metadata = args[:metadata] if args.key?(:metadata)
-          @location = args[:location] if args.key?(:location)
-          @title = args[:title] if args.key?(:title)
-          @current = args[:current] if args.key?(:current)
-          @start_date = args[:start_date] if args.key?(:start_date)
-          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
-          @domain = args[:domain] if args.key?(:domain)
-          @department = args[:department] if args.key?(:department)
-          @type = args[:type] if args.key?(:type)
-          @phonetic_name = args[:phonetic_name] if args.key?(:phonetic_name)
-          @job_description = args[:job_description] if args.key?(:job_description)
-          @end_date = args[:end_date] if args.key?(:end_date)
-          @symbol = args[:symbol] if args.key?(:symbol)
-          @name = args[:name] if args.key?(:name)
+          @text = args[:text] if args.key?(:text)
         end
       end
       
-      # A person's age range.
-      class AgeRangeType
+      # A person's bragging rights.
+      class BraggingRights
         include Google::Apis::Core::Hashable
       
-        # The age range.
-        # Corresponds to the JSON property `ageRange`
-        # @return [String]
-        attr_accessor :age_range
-      
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
+        # The bragging rights; for example, `climbed mount everest`.
+        # 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)
-          @age_range = args[:age_range] if args.key?(:age_range)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # The response to a list contact groups request.
-      class ListContactGroupsResponse
+      # A contact group.
+      class ContactGroup
         include Google::Apis::Core::Hashable
       
-        # The token that can be used to retrieve changes since the last request.
-        # Corresponds to the JSON property `nextSyncToken`
+        # 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 :next_sync_token
+        attr_accessor :etag
       
-        # The total number of items in the list without pagination.
-        # Corresponds to the JSON property `totalItems`
+        # The read-only 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.
+        # Corresponds to the JSON property `formattedName`
+        # @return [String]
+        attr_accessor :formatted_name
+      
+        # The read-only contact group type.
+        # Corresponds to the JSON property `groupType`
+        # @return [String]
+        attr_accessor :group_type
+      
+        # The total number of contacts in the group irrespective of max members in
+        # specified in the request.
+        # Corresponds to the JSON property `memberCount`
         # @return [Fixnum]
-        attr_accessor :total_items
+        attr_accessor :member_count
       
-        # 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
+        # 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).
+        # Corresponds to the JSON property `memberResourceNames`
+        # @return [Array<String>]
+        attr_accessor :member_resource_names
       
-        # The token that can be used to retrieve the next page of results.
-        # Corresponds to the JSON property `nextPageToken`
+        # The read-only metadata about a contact group.
+        # Corresponds to the JSON property `metadata`
+        # @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.
+        # Corresponds to the JSON property `name`
         # @return [String]
-        attr_accessor :next_page_token
+        attr_accessor :name
+      
+        # The resource name for the contact group, assigned by the server. An ASCII
+        # string, in the form of `contactGroups/`<var>contact_group_id</var>.
+        # Corresponds to the JSON property `resourceName`
+        # @return [String]
+        attr_accessor :resource_name
       
         def initialize(**args)
            update!(**args)
@@ -264,25 +314,82 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
-          @total_items = args[:total_items] if args.key?(:total_items)
-          @contact_groups = args[:contact_groups] if args.key?(:contact_groups)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @etag = args[:etag] if args.key?(:etag)
+          @formatted_name = args[:formatted_name] if args.key?(:formatted_name)
+          @group_type = args[:group_type] if args.key?(:group_type)
+          @member_count = args[:member_count] if args.key?(:member_count)
+          @member_resource_names = args[:member_resource_names] if args.key?(:member_resource_names)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
         end
       end
       
-      # The response for a single person
-      class PersonResponse
+      # A Google contact group membership.
+      class ContactGroupMembership
         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.
-        # Corresponds to the JSON property `person`
-        # @return [Google::Apis::PeopleV1::Person]
-        attr_accessor :person
+        # The contact group ID for the contact group membership. The contact group
+        # ID can be custom or predefined. Possible values include, but are not
+        # limited to, the following:
+        # *  `myContacts`
+        # *  `starred`
+        # *  A numerical ID for user-created groups.
+        # Corresponds to the JSON property `contactGroupId`
+        # @return [String]
+        attr_accessor :contact_group_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @contact_group_id = args[:contact_group_id] if args.key?(:contact_group_id)
+        end
+      end
+      
+      # The read-only metadata about a contact group.
+      class ContactGroupMetadata
+        include Google::Apis::Core::Hashable
+      
+        # 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.
+        # Corresponds to the JSON property `deleted`
+        # @return [Boolean]
+        attr_accessor :deleted
+        alias_method :deleted?, :deleted
+      
+        # The time the group was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deleted = args[:deleted] if args.key?(:deleted)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # The response for a specific contact group.
+      class ContactGroupResponse
+        include Google::Apis::Core::Hashable
+      
+        # A contact group.
+        # Corresponds to the JSON property `contactGroup`
+        # @return [Google::Apis::PeopleV1::ContactGroup]
+        attr_accessor :contact_group
+      
+        # The original requested resource name.
+        # 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
@@ -327,102 +434,60 @@ module Google
         # @return [Google::Apis::PeopleV1::Status]
         attr_accessor :status
       
-        # **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
-      
-        # 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
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @person = args[:person] if args.key?(:person)
-          @status = args[:status] if args.key?(:status)
-          @http_status_code = args[:http_status_code] if args.key?(:http_status_code)
+          @contact_group = args[:contact_group] if args.key?(:contact_group)
           @requested_resource_name = args[:requested_resource_name] if args.key?(:requested_resource_name)
+          @status = args[:status] if args.key?(:status)
         end
       end
       
-      # A person's relation to another person.
-      class Relation
+      # A person's read-only 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
       
-        # The type of the relation translated and formatted in the viewer's account
-        # locale or the locale specified in the Accept-Language HTTP header.
-        # Corresponds to the JSON property `formattedType`
-        # @return [String]
-        attr_accessor :formatted_type
-      
-        # The name of the other person this relation refers to.
-        # Corresponds to the JSON property `person`
-        # @return [String]
-        attr_accessor :person
-      
-        # The person's relation to the other person. The type can be custom or
-        # predefined.
-        # Possible values include, but are not limited to, the following values:
-        # * `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
+        # 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
+        alias_method :default?, :default
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
+        # The URL of the cover photo.
+        # 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)
-          @person = args[:person] if args.key?(:person)
-          @type = args[:type] if args.key?(:type)
+          @default = args[:default] if args.key?(:default)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @url = args[:url] if args.key?(:url)
         end
       end
       
-      # A person's occupation.
-      class Occupation
+      # A request to create a new contact group.
+      class CreateContactGroupRequest
         include Google::Apis::Core::Hashable
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
-      
-        # The occupation; for example, `carpenter`.
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
+        # A contact group.
+        # Corresponds to the JSON property `contactGroup`
+        # @return [Google::Apis::PeopleV1::ContactGroup]
+        attr_accessor :contact_group
       
         def initialize(**args)
            update!(**args)
@@ -430,63 +495,37 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
+          @contact_group = args[:contact_group] if args.key?(:contact_group)
         end
       end
       
-      # A contact group.
-      class ContactGroup
+      # Represents a whole calendar date, for example a date of birth. The time
+      # of day and time zone are either specified elsewhere or are not
+      # significant. The date is relative to the
+      # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
+      # Proleptic_Gregorian_calendar).
+      # The day may be 0 to represent a year and month where the day is not
+      # significant. The year may be 0 to represent a month and day independent
+      # of year; for example, anniversary date.
+      class Date
         include Google::Apis::Core::Hashable
       
-        # The resource name for the contact group, assigned by the server. An ASCII
-        # string, in the form of `contactGroups/<contact_group_id>`.
-        # Corresponds to the JSON property `resourceName`
-        # @return [String]
-        attr_accessor :resource_name
-      
-        # 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
-      
-        # The read-only contact group type.
-        # Corresponds to the JSON property `groupType`
-        # @return [String]
-        attr_accessor :group_type
-      
-        # The read-only 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.
-        # Corresponds to the JSON property `formattedName`
-        # @return [String]
-        attr_accessor :formatted_name
-      
-        # 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).
-        # Corresponds to the JSON property `memberResourceNames`
-        # @return [Array<String>]
-        attr_accessor :member_resource_names
-      
-        # 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
+        # Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+        # if specifying a year/month where the day is not significant.
+        # Corresponds to the JSON property `day`
+        # @return [Fixnum]
+        attr_accessor :day
       
-        # The read-only metadata about a contact group.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::ContactGroupMetadata]
-        attr_accessor :metadata
+        # Month of year. Must be from 1 to 12.
+        # Corresponds to the JSON property `month`
+        # @return [Fixnum]
+        attr_accessor :month
       
-        # The total number of contacts in the group irrespective of max members in
-        # specified in the request.
-        # Corresponds to the JSON property `memberCount`
+        # 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 :member_count
+        attr_accessor :year
       
         def initialize(**args)
            update!(**args)
@@ -494,177 +533,133 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @resource_name = args[:resource_name] if args.key?(:resource_name)
-          @etag = args[:etag] if args.key?(:etag)
-          @group_type = args[:group_type] if args.key?(:group_type)
-          @formatted_name = args[:formatted_name] if args.key?(:formatted_name)
-          @member_resource_names = args[:member_resource_names] if args.key?(:member_resource_names)
-          @name = args[:name] if args.key?(:name)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @member_count = args[:member_count] if args.key?(:member_count)
+          @day = args[:day] if args.key?(:day)
+          @month = args[:month] if args.key?(:month)
+          @year = args[:year] if args.key?(:year)
         end
       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.
-      class Person
+      # A Google Apps Domain membership.
+      class DomainMembership
         include Google::Apis::Core::Hashable
       
-        # The person's names.
-        # Corresponds to the JSON property `names`
-        # @return [Array<Google::Apis::PeopleV1::Name>]
-        attr_accessor :names
-      
-        # The person's relations.
-        # Corresponds to the JSON property `relations`
-        # @return [Array<Google::Apis::PeopleV1::Relation>]
-        attr_accessor :relations
+        # True if the person is in the viewer's Google Apps domain.
+        # Corresponds to the JSON property `inViewerDomain`
+        # @return [Boolean]
+        attr_accessor :in_viewer_domain
+        alias_method :in_viewer_domain?, :in_viewer_domain
       
-        # The person's occupations.
-        # Corresponds to the JSON property `occupations`
-        # @return [Array<Google::Apis::PeopleV1::Occupation>]
-        attr_accessor :occupations
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # The person's email addresses.
-        # Corresponds to the JSON property `emailAddresses`
-        # @return [Array<Google::Apis::PeopleV1::EmailAddress>]
-        attr_accessor :email_addresses
+        # Update properties of this object
+        def update!(**args)
+          @in_viewer_domain = args[:in_viewer_domain] if args.key?(:in_viewer_domain)
+        end
+      end
       
-        # The person's past or current organizations.
-        # Corresponds to the JSON property `organizations`
-        # @return [Array<Google::Apis::PeopleV1::Organization>]
-        attr_accessor :organizations
+      # A person's email address.
+      class EmailAddress
+        include Google::Apis::Core::Hashable
       
-        # 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`
+        # The display name of the email.
+        # Corresponds to the JSON property `displayName`
         # @return [String]
-        attr_accessor :etag
+        attr_accessor :display_name
       
-        # The person's bragging rights.
-        # Corresponds to the JSON property `braggingRights`
-        # @return [Array<Google::Apis::PeopleV1::BraggingRights>]
-        attr_accessor :bragging_rights
+        # The read-only type of the email address 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
       
-        # The read-only metadata about a person.
+        # Metadata about a field.
         # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::PersonMetadata]
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The person's residences.
-        # Corresponds to the JSON property `residences`
-        # @return [Array<Google::Apis::PeopleV1::Residence>]
-        attr_accessor :residences
-      
-        # The person's genders.
-        # Corresponds to the JSON property `genders`
-        # @return [Array<Google::Apis::PeopleV1::Gender>]
-        attr_accessor :genders
-      
-        # The person's interests.
-        # Corresponds to the JSON property `interests`
-        # @return [Array<Google::Apis::PeopleV1::Interest>]
-        attr_accessor :interests
+        # The type of the email address. The type can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `home`
+        # * `work`
+        # * `other`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
       
-        # 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`
+        # The email address.
+        # Corresponds to the JSON property `value`
         # @return [String]
-        attr_accessor :resource_name
+        attr_accessor :value
       
-        # The person's biographies.
-        # Corresponds to the JSON property `biographies`
-        # @return [Array<Google::Apis::PeopleV1::Biography>]
-        attr_accessor :biographies
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # The person's skills.
-        # Corresponds to the JSON property `skills`
-        # @return [Array<Google::Apis::PeopleV1::Skill>]
-        attr_accessor :skills
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @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
       
-        # The person's read-only relationship statuses.
-        # Corresponds to the JSON property `relationshipStatuses`
-        # @return [Array<Google::Apis::PeopleV1::RelationshipStatus>]
-        attr_accessor :relationship_statuses
+      # 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
       
-        # The person's read-only photos.
-        # Corresponds to the JSON property `photos`
-        # @return [Array<Google::Apis::PeopleV1::Photo>]
-        attr_accessor :photos
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # **DEPRECATED** (Please use `person.ageRanges` instead)**
-        # The person's read-only age range.
-        # Corresponds to the JSON property `ageRange`
-        # @return [String]
-        attr_accessor :age_range
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
       
-        # The person's read-only taglines.
-        # Corresponds to the JSON property `taglines`
-        # @return [Array<Google::Apis::PeopleV1::Tagline>]
-        attr_accessor :taglines
+      # An event related to the person.
+      class Event
+        include Google::Apis::Core::Hashable
       
-        # The person's read-only age ranges.
-        # Corresponds to the JSON property `ageRanges`
-        # @return [Array<Google::Apis::PeopleV1::AgeRangeType>]
-        attr_accessor :age_ranges
+        # Represents a whole calendar date, for example a date of birth. The time
+        # of day and time zone are either specified elsewhere or are not
+        # significant. The date is relative to the
+        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
+        # Proleptic_Gregorian_calendar).
+        # The day may be 0 to represent a year and month where the day is not
+        # significant. The year may be 0 to represent a month and day independent
+        # of year; for example, anniversary date.
+        # Corresponds to the JSON property `date`
+        # @return [Google::Apis::PeopleV1::Date]
+        attr_accessor :date
       
-        # The person's street addresses.
-        # Corresponds to the JSON property `addresses`
-        # @return [Array<Google::Apis::PeopleV1::Address>]
-        attr_accessor :addresses
+        # The read-only 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
       
-        # The person's events.
-        # Corresponds to the JSON property `events`
-        # @return [Array<Google::Apis::PeopleV1::Event>]
-        attr_accessor :events
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-        # The person's read-only group memberships.
-        # Corresponds to the JSON property `memberships`
-        # @return [Array<Google::Apis::PeopleV1::Membership>]
-        attr_accessor :memberships
-      
-        # The person's phone numbers.
-        # Corresponds to the JSON property `phoneNumbers`
-        # @return [Array<Google::Apis::PeopleV1::PhoneNumber>]
-        attr_accessor :phone_numbers
-      
-        # The person's read-only cover photos.
-        # Corresponds to the JSON property `coverPhotos`
-        # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
-        attr_accessor :cover_photos
-      
-        # The person's instant messaging clients.
-        # Corresponds to the JSON property `imClients`
-        # @return [Array<Google::Apis::PeopleV1::ImClient>]
-        attr_accessor :im_clients
-      
-        # The person's birthdays.
-        # Corresponds to the JSON property `birthdays`
-        # @return [Array<Google::Apis::PeopleV1::Birthday>]
-        attr_accessor :birthdays
-      
-        # The person's locale preferences.
-        # Corresponds to the JSON property `locales`
-        # @return [Array<Google::Apis::PeopleV1::Locale>]
-        attr_accessor :locales
-      
-        # The person's read-only relationship interests.
-        # Corresponds to the JSON property `relationshipInterests`
-        # @return [Array<Google::Apis::PeopleV1::RelationshipInterest>]
-        attr_accessor :relationship_interests
-      
-        # The person's associated URLs.
-        # Corresponds to the JSON property `urls`
-        # @return [Array<Google::Apis::PeopleV1::Url>]
-        attr_accessor :urls
-      
-        # The person's nicknames.
-        # Corresponds to the JSON property `nicknames`
-        # @return [Array<Google::Apis::PeopleV1::Nickname>]
-        attr_accessor :nicknames
+        # The type of the event. The type can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `anniversary`
+        # * `other`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
       
         def initialize(**args)
            update!(**args)
@@ -672,74 +667,36 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @names = args[:names] if args.key?(:names)
-          @relations = args[:relations] if args.key?(:relations)
-          @occupations = args[:occupations] if args.key?(:occupations)
-          @email_addresses = args[:email_addresses] if args.key?(:email_addresses)
-          @organizations = args[:organizations] if args.key?(:organizations)
-          @etag = args[:etag] if args.key?(:etag)
-          @bragging_rights = args[:bragging_rights] if args.key?(:bragging_rights)
+          @date = args[:date] if args.key?(:date)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
           @metadata = args[:metadata] if args.key?(:metadata)
-          @residences = args[:residences] if args.key?(:residences)
-          @genders = args[:genders] if args.key?(:genders)
-          @interests = args[:interests] if args.key?(:interests)
-          @resource_name = args[:resource_name] if args.key?(:resource_name)
-          @biographies = args[:biographies] if args.key?(:biographies)
-          @skills = args[:skills] if args.key?(:skills)
-          @relationship_statuses = args[:relationship_statuses] if args.key?(:relationship_statuses)
-          @photos = args[:photos] if args.key?(:photos)
-          @age_range = args[:age_range] if args.key?(:age_range)
-          @taglines = args[:taglines] if args.key?(:taglines)
-          @age_ranges = args[:age_ranges] if args.key?(:age_ranges)
-          @addresses = args[:addresses] if args.key?(:addresses)
-          @events = args[:events] if args.key?(:events)
-          @memberships = args[:memberships] if args.key?(:memberships)
-          @phone_numbers = args[:phone_numbers] if args.key?(:phone_numbers)
-          @cover_photos = args[:cover_photos] if args.key?(:cover_photos)
-          @im_clients = args[:im_clients] if args.key?(:im_clients)
-          @birthdays = args[:birthdays] if args.key?(:birthdays)
-          @locales = args[:locales] if args.key?(:locales)
-          @relationship_interests = args[:relationship_interests] if args.key?(:relationship_interests)
-          @urls = args[:urls] if args.key?(:urls)
-          @nicknames = args[:nicknames] if args.key?(:nicknames)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
-      # A request to update an existing contact group. Only the name can be updated.
-      class UpdateContactGroupRequest
+      # Metadata about a field.
+      class FieldMetadata
         include Google::Apis::Core::Hashable
       
-        # A contact group.
-        # Corresponds to the JSON property `contactGroup`
-        # @return [Google::Apis::PeopleV1::ContactGroup]
-        attr_accessor :contact_group
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @contact_group = args[:contact_group] if args.key?(:contact_group)
-        end
-      end
+        # True if the field is the primary field; false if the field is a secondary
+        # field.
+        # Corresponds to the JSON property `primary`
+        # @return [Boolean]
+        attr_accessor :primary
+        alias_method :primary?, :primary
       
-      # The read-only metadata about a contact group.
-      class ContactGroupMetadata
-        include Google::Apis::Core::Hashable
+        # The source of a field.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::PeopleV1::Source]
+        attr_accessor :source
       
-        # 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.
-        # Corresponds to the JSON property `deleted`
+        # 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.
+        # Corresponds to the JSON property `verified`
         # @return [Boolean]
-        attr_accessor :deleted
-        alias_method :deleted?, :deleted
-      
-        # The time the group was last updated.
-        # Corresponds to the JSON property `updateTime`
-        # @return [String]
-        attr_accessor :update_time
+        attr_accessor :verified
+        alias_method :verified?, :verified
       
         def initialize(**args)
            update!(**args)
@@ -747,28 +704,34 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @deleted = args[:deleted] if args.key?(:deleted)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @primary = args[:primary] if args.key?(:primary)
+          @source = args[:source] if args.key?(:source)
+          @verified = args[:verified] if args.key?(:verified)
         end
       end
       
-      # A person's past or current residence.
-      class Residence
+      # A person's gender.
+      class Gender
         include Google::Apis::Core::Hashable
       
-        # 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
-        alias_method :current?, :current
+        # The read-only value of the gender translated and formatted in the viewer's
+        # account locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedValue`
+        # @return [String]
+        attr_accessor :formatted_value
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The address of the residence.
+        # The gender for the person. The gender can be custom or predefined.
+        # Possible values include, but are not limited to, the
+        # following:
+        # * `male`
+        # * `female`
+        # * `other`
+        # * `unknown`
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -779,46 +742,80 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @current = args[:current] if args.key?(:current)
+          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
           @metadata = args[:metadata] if args.key?(:metadata)
           @value = args[:value] if args.key?(:value)
         end
       end
       
-      # An event related to the person.
-      class Event
+      # 
+      class GetPeopleResponse
         include Google::Apis::Core::Hashable
       
-        # Represents a whole calendar date, for example a date of birth. The time
-        # of day and time zone are either specified elsewhere or are not
-        # significant. The date is relative to the
-        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
-        # Proleptic_Gregorian_calendar).
-        # The day may be 0 to represent a year and month where the day is not
-        # significant. The year may be 0 to represent a month and day independent
-        # of year; for example, anniversary date.
-        # Corresponds to the JSON property `date`
-        # @return [Google::Apis::PeopleV1::Date]
-        attr_accessor :date
+        # The response for each requested resource name.
+        # Corresponds to the JSON property `responses`
+        # @return [Array<Google::Apis::PeopleV1::PersonResponse>]
+        attr_accessor :responses
       
-        # The read-only type of the event translated and formatted in the
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @responses = args[:responses] if args.key?(:responses)
+        end
+      end
+      
+      # A person's instant messaging client.
+      class ImClient
+        include Google::Apis::Core::Hashable
+      
+        # The read-only protocol of the IM client formatted in the viewer's account
+        # locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedProtocol`
+        # @return [String]
+        attr_accessor :formatted_protocol
+      
+        # The read-only 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
       
-        # The type of the event. The type can be custom or predefined.
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The protocol of the IM client. The protocol can be custom or predefined.
         # Possible values include, but are not limited to, the following:
-        # * `anniversary`
+        # * `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 predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `home`
+        # * `work`
         # * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # The user name used in the IM client.
+        # Corresponds to the JSON property `username`
+        # @return [String]
+        attr_accessor :username
       
         def initialize(**args)
            update!(**args)
@@ -826,21 +823,28 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @date = args[:date] if args.key?(:date)
+          @formatted_protocol = args[:formatted_protocol] if args.key?(:formatted_protocol)
           @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
-          @type = args[:type] if args.key?(:type)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @protocol = args[:protocol] if args.key?(:protocol)
+          @type = args[:type] if args.key?(:type)
+          @username = args[:username] if args.key?(:username)
         end
       end
       
-      # The response to a modify contact group members request.
-      class ModifyContactGroupMembersResponse
+      # One of the person's interests.
+      class Interest
         include Google::Apis::Core::Hashable
       
-        # The contact people resource names that were not found.
-        # Corresponds to the JSON property `notFoundResourceNames`
-        # @return [Array<String>]
-        attr_accessor :not_found_resource_names
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The interest; for example, `stargazing`.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -848,23 +852,40 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @not_found_resource_names = args[:not_found_resource_names] if args.key?(:not_found_resource_names)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # The read-only metadata about a profile.
-      class ProfileMetadata
+      # 
+      class ListConnectionsResponse
         include Google::Apis::Core::Hashable
       
-        # The user types.
-        # Corresponds to the JSON property `userTypes`
-        # @return [Array<String>]
-        attr_accessor :user_types
-      
-        # The profile object type.
-        # Corresponds to the JSON property `objectType`
+        # The list of people that the requestor is connected to.
+        # Corresponds to the JSON property `connections`
+        # @return [Array<Google::Apis::PeopleV1::Person>]
+        attr_accessor :connections
+      
+        # The token that can be used to retrieve the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
         # @return [String]
-        attr_accessor :object_type
+        attr_accessor :next_page_token
+      
+        # The token that can be used to retrieve changes since the last request.
+        # Corresponds to the JSON property `nextSyncToken`
+        # @return [String]
+        attr_accessor :next_sync_token
+      
+        # The total number of items in the list without pagination.
+        # Corresponds to the JSON property `totalItems`
+        # @return [Fixnum]
+        attr_accessor :total_items
+      
+        # **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
       
         def initialize(**args)
            update!(**args)
@@ -872,33 +893,63 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @user_types = args[:user_types] if args.key?(:user_types)
-          @object_type = args[:object_type] if args.key?(:object_type)
+          @connections = args[:connections] if args.key?(:connections)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
+          @total_items = args[:total_items] if args.key?(:total_items)
+          @total_people = args[:total_people] if args.key?(:total_people)
         end
       end
       
-      # A person's gender.
-      class Gender
+      # The response to a list contact groups request.
+      class ListContactGroupsResponse
         include Google::Apis::Core::Hashable
       
-        # The read-only value of the gender translated and formatted in the viewer's
-        # account locale or the `Accept-Language` HTTP header locale.
-        # Corresponds to the JSON property `formattedValue`
+        # 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
+      
+        # The token that can be used to retrieve the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
         # @return [String]
-        attr_accessor :formatted_value
+        attr_accessor :next_page_token
+      
+        # The token that can be used to retrieve changes since the last request.
+        # Corresponds to the JSON property `nextSyncToken`
+        # @return [String]
+        attr_accessor :next_sync_token
+      
+        # The total number of items in the list without pagination.
+        # Corresponds to the JSON property `totalItems`
+        # @return [Fixnum]
+        attr_accessor :total_items
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @contact_groups = args[:contact_groups] if args.key?(:contact_groups)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
+          @total_items = args[:total_items] if args.key?(:total_items)
+        end
+      end
+      
+      # A person's locale preference.
+      class Locale
+        include Google::Apis::Core::Hashable
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The gender for the person. The gender can be custom or predefined.
-        # Possible values include, but are not limited to, the
-        # following:
-        # * `male`
-        # * `female`
-        # * `other`
-        # * `unknown`
+        # 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
@@ -909,59 +960,57 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
           @metadata = args[:metadata] if args.key?(:metadata)
           @value = args[:value] if args.key?(:value)
         end
       end
       
-      # A person's read-only cover photo. A large image shown on the person's
-      # profile page that represents who they are or what they care about.
-      class CoverPhoto
+      # A person's read-only membership in a group.
+      class Membership
         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.
-        # Corresponds to the JSON property `default`
-        # @return [Boolean]
-        attr_accessor :default
-        alias_method :default?, :default
+        # A Google contact group membership.
+        # Corresponds to the JSON property `contactGroupMembership`
+        # @return [Google::Apis::PeopleV1::ContactGroupMembership]
+        attr_accessor :contact_group_membership
+      
+        # A Google Apps Domain membership.
+        # Corresponds to the JSON property `domainMembership`
+        # @return [Google::Apis::PeopleV1::DomainMembership]
+        attr_accessor :domain_membership
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The URL of the cover photo.
-        # 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)
-          @default = args[:default] if args.key?(:default)
+          @contact_group_membership = args[:contact_group_membership] if args.key?(:contact_group_membership)
+          @domain_membership = args[:domain_membership] if args.key?(:domain_membership)
           @metadata = args[:metadata] if args.key?(:metadata)
-          @url = args[:url] if args.key?(:url)
         end
       end
       
-      # One of the person's interests.
-      class Interest
+      # A request to modify an existing contact group's members.
+      class ModifyContactGroupMembersRequest
         include Google::Apis::Core::Hashable
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # The resource names of the contact people to add in the form of in the form
+        # `people/`<var>person_id</var>.
+        # Corresponds to the JSON property `resourceNamesToAdd`
+        # @return [Array<String>]
+        attr_accessor :resource_names_to_add
       
-        # The interest; for example, `stargazing`.
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
+        # The resource names of the contact people to remove in the form of in the
+        # form of `people/`<var>person_id</var>.
+        # Corresponds to the JSON property `resourceNamesToRemove`
+        # @return [Array<String>]
+        attr_accessor :resource_names_to_remove
       
         def initialize(**args)
            update!(**args)
@@ -969,29 +1018,19 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
+          @resource_names_to_add = args[:resource_names_to_add] if args.key?(:resource_names_to_add)
+          @resource_names_to_remove = args[:resource_names_to_remove] if args.key?(:resource_names_to_remove)
         end
       end
       
-      # A person's nickname.
-      class Nickname
+      # The response to a modify contact group members request.
+      class ModifyContactGroupMembersResponse
         include Google::Apis::Core::Hashable
       
-        # The type of the nickname.
-        # Corresponds to the JSON property `type`
-        # @return [String]
-        attr_accessor :type
-      
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
-      
-        # The nickname.
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
+        # The contact people resource names that were not found.
+        # Corresponds to the JSON property `notFoundResourceNames`
+        # @return [Array<String>]
+        attr_accessor :not_found_resource_names
       
         def initialize(**args)
            update!(**args)
@@ -999,45 +1038,86 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @type = args[:type] if args.key?(:type)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
+          @not_found_resource_names = args[:not_found_resource_names] if args.key?(:not_found_resource_names)
         end
       end
       
-      # A person's email address.
-      class EmailAddress
+      # A person's name. If the name is a mononym, the family name is empty.
+      class Name
         include Google::Apis::Core::Hashable
       
-        # The display name of the email.
+        # The read-only display name formatted according to the locale specified by
+        # the viewer's account or the `Accept-Language` HTTP header.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The type of the email address. The type can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `home`
-        # * `work`
-        # * `other`
-        # Corresponds to the JSON property `type`
+        # The read-only display name with the last name first formatted according to
+        # the locale specified by the viewer's account or the
+        # `Accept-Language` HTTP header.
+        # Corresponds to the JSON property `displayNameLastFirst`
         # @return [String]
-        attr_accessor :type
+        attr_accessor :display_name_last_first
+      
+        # The family name.
+        # Corresponds to the JSON property `familyName`
+        # @return [String]
+        attr_accessor :family_name
+      
+        # The given name.
+        # Corresponds to the JSON property `givenName`
+        # @return [String]
+        attr_accessor :given_name
+      
+        # The honorific prefixes, such as `Mrs.` or `Dr.`
+        # Corresponds to the JSON property `honorificPrefix`
+        # @return [String]
+        attr_accessor :honorific_prefix
+      
+        # The honorific suffixes, such as `Jr.`
+        # Corresponds to the JSON property `honorificSuffix`
+        # @return [String]
+        attr_accessor :honorific_suffix
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The email address.
-        # Corresponds to the JSON property `value`
+        # The middle name(s).
+        # Corresponds to the JSON property `middleName`
         # @return [String]
-        attr_accessor :value
+        attr_accessor :middle_name
       
-        # The read-only type of the email address translated and formatted in the
-        # viewer's account locale or the `Accept-Language` HTTP header locale.
-        # Corresponds to the JSON property `formattedType`
+        # The family name spelled as it sounds.
+        # Corresponds to the JSON property `phoneticFamilyName`
         # @return [String]
-        attr_accessor :formatted_type
+        attr_accessor :phonetic_family_name
+      
+        # The full name spelled as it sounds.
+        # Corresponds to the JSON property `phoneticFullName`
+        # @return [String]
+        attr_accessor :phonetic_full_name
+      
+        # The given name spelled as it sounds.
+        # Corresponds to the JSON property `phoneticGivenName`
+        # @return [String]
+        attr_accessor :phonetic_given_name
+      
+        # The honorific prefixes spelled as they sound.
+        # Corresponds to the JSON property `phoneticHonorificPrefix`
+        # @return [String]
+        attr_accessor :phonetic_honorific_prefix
+      
+        # The honorific suffixes spelled as they sound.
+        # Corresponds to the JSON property `phoneticHonorificSuffix`
+        # @return [String]
+        attr_accessor :phonetic_honorific_suffix
+      
+        # The middle name(s) spelled as they sound.
+        # Corresponds to the JSON property `phoneticMiddleName`
+        # @return [String]
+        attr_accessor :phonetic_middle_name
       
         def initialize(**args)
            update!(**args)
@@ -1046,15 +1126,24 @@ module Google
         # Update properties of this object
         def update!(**args)
           @display_name = args[:display_name] if args.key?(:display_name)
-          @type = args[:type] if args.key?(:type)
+          @display_name_last_first = args[:display_name_last_first] if args.key?(:display_name_last_first)
+          @family_name = args[:family_name] if args.key?(:family_name)
+          @given_name = args[:given_name] if args.key?(:given_name)
+          @honorific_prefix = args[:honorific_prefix] if args.key?(:honorific_prefix)
+          @honorific_suffix = args[:honorific_suffix] if args.key?(:honorific_suffix)
           @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
-          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @middle_name = args[:middle_name] if args.key?(:middle_name)
+          @phonetic_family_name = args[:phonetic_family_name] if args.key?(:phonetic_family_name)
+          @phonetic_full_name = args[:phonetic_full_name] if args.key?(:phonetic_full_name)
+          @phonetic_given_name = args[:phonetic_given_name] if args.key?(:phonetic_given_name)
+          @phonetic_honorific_prefix = args[:phonetic_honorific_prefix] if args.key?(:phonetic_honorific_prefix)
+          @phonetic_honorific_suffix = args[:phonetic_honorific_suffix] if args.key?(:phonetic_honorific_suffix)
+          @phonetic_middle_name = args[:phonetic_middle_name] if args.key?(:phonetic_middle_name)
         end
       end
       
-      # A skill that the person has.
-      class Skill
+      # A person's nickname.
+      class Nickname
         include Google::Apis::Core::Hashable
       
         # Metadata about a field.
@@ -1062,7 +1151,12 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The skill; for example, `underwater basket weaving`.
+        # The type of the nickname.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The nickname.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1074,52 +1168,13 @@ module Google
         # Update properties of this object
         def update!(**args)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @type = args[:type] if args.key?(:type)
           @value = args[:value] if args.key?(:value)
         end
       end
       
-      # Represents a whole calendar date, for example a date of birth. The time
-      # of day and time zone are either specified elsewhere or are not
-      # significant. The date is relative to the
-      # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
-      # Proleptic_Gregorian_calendar).
-      # The day may be 0 to represent a year and month where the day is not
-      # significant. The year may be 0 to represent a month and day independent
-      # of year; for example, anniversary date.
-      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/month where the day is not significant.
-        # Corresponds to the JSON property `day`
-        # @return [Fixnum]
-        attr_accessor :day
-      
-        # 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
-      
-        # Month of year. Must be from 1 to 12.
-        # Corresponds to the JSON property `month`
-        # @return [Fixnum]
-        attr_accessor :month
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @day = args[:day] if args.key?(:day)
-          @year = args[:year] if args.key?(:year)
-          @month = args[:month] if args.key?(:month)
-        end
-      end
-      
-      # A read-only brief one-line description of the person.
-      class Tagline
+      # A person's occupation.
+      class Occupation
         include Google::Apis::Core::Hashable
       
         # Metadata about a field.
@@ -1127,7 +1182,7 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The tagline.
+        # The occupation; for example, `carpenter`.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1143,82 +1198,101 @@ module Google
         end
       end
       
-      # A person's name. If the name is a mononym, the family name is empty.
-      class Name
+      # A person's past or current organization. Overlapping date ranges are
+      # permitted.
+      class Organization
         include Google::Apis::Core::Hashable
       
-        # The full name spelled as it sounds.
-        # Corresponds to the JSON property `phoneticFullName`
-        # @return [String]
-        attr_accessor :phonetic_full_name
+        # 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
+        alias_method :current?, :current
       
-        # The read-only display name with the last name first formatted according to
-        # the locale specified by the viewer's account or the
-        # <code>Accept-Language</code> HTTP header.
-        # Corresponds to the JSON property `displayNameLastFirst`
+        # The person's department at the organization.
+        # Corresponds to the JSON property `department`
         # @return [String]
-        attr_accessor :display_name_last_first
+        attr_accessor :department
       
-        # The read-only display name formatted according to the locale specified by
-        # the viewer's account or the <code>Accept-Language</code> HTTP header.
-        # Corresponds to the JSON property `displayName`
+        # The domain name associated with the organization; for example, `google.com`.
+        # Corresponds to the JSON property `domain`
         # @return [String]
-        attr_accessor :display_name
+        attr_accessor :domain
       
-        # The honorific suffixes, such as `Jr.`
-        # Corresponds to the JSON property `honorificSuffix`
-        # @return [String]
-        attr_accessor :honorific_suffix
+        # Represents a whole calendar date, for example a date of birth. The time
+        # of day and time zone are either specified elsewhere or are not
+        # significant. The date is relative to the
+        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
+        # Proleptic_Gregorian_calendar).
+        # The day may be 0 to represent a year and month where the day is not
+        # significant. The year may be 0 to represent a month and day independent
+        # of year; for example, anniversary date.
+        # Corresponds to the JSON property `endDate`
+        # @return [Google::Apis::PeopleV1::Date]
+        attr_accessor :end_date
       
-        # The honorific prefixes, such as `Mrs.` or `Dr.`
-        # Corresponds to the JSON property `honorificPrefix`
+        # The read-only type of the organization 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 :honorific_prefix
+        attr_accessor :formatted_type
       
-        # The honorific suffixes spelled as they sound.
-        # Corresponds to the JSON property `phoneticHonorificSuffix`
+        # The person's job description at the organization.
+        # Corresponds to the JSON property `jobDescription`
         # @return [String]
-        attr_accessor :phonetic_honorific_suffix
+        attr_accessor :job_description
       
-        # The given name.
-        # Corresponds to the JSON property `givenName`
+        # The location of the organization office the person works at.
+        # Corresponds to the JSON property `location`
         # @return [String]
-        attr_accessor :given_name
+        attr_accessor :location
       
-        # The middle name(s).
-        # Corresponds to the JSON property `middleName`
-        # @return [String]
-        attr_accessor :middle_name
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-        # The honorific prefixes spelled as they sound.
-        # Corresponds to the JSON property `phoneticHonorificPrefix`
+        # The name of the organization.
+        # Corresponds to the JSON property `name`
         # @return [String]
-        attr_accessor :phonetic_honorific_prefix
+        attr_accessor :name
       
-        # The given name spelled as it sounds.
-        # Corresponds to the JSON property `phoneticGivenName`
+        # The phonetic name of the organization.
+        # Corresponds to the JSON property `phoneticName`
         # @return [String]
-        attr_accessor :phonetic_given_name
+        attr_accessor :phonetic_name
       
-        # The family name spelled as it sounds.
-        # Corresponds to the JSON property `phoneticFamilyName`
-        # @return [String]
-        attr_accessor :phonetic_family_name
+        # Represents a whole calendar date, for example a date of birth. The time
+        # of day and time zone are either specified elsewhere or are not
+        # significant. The date is relative to the
+        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
+        # Proleptic_Gregorian_calendar).
+        # The day may be 0 to represent a year and month where the day is not
+        # significant. The year may be 0 to represent a month and day independent
+        # of year; for example, anniversary date.
+        # Corresponds to the JSON property `startDate`
+        # @return [Google::Apis::PeopleV1::Date]
+        attr_accessor :start_date
       
-        # The family name.
-        # Corresponds to the JSON property `familyName`
+        # The symbol associated with the organization; for example, a stock ticker
+        # symbol, abbreviation, or acronym.
+        # Corresponds to the JSON property `symbol`
         # @return [String]
-        attr_accessor :family_name
+        attr_accessor :symbol
       
-        # The middle name(s) spelled as they sound.
-        # Corresponds to the JSON property `phoneticMiddleName`
+        # The person's job title at the organization.
+        # Corresponds to the JSON property `title`
         # @return [String]
-        attr_accessor :phonetic_middle_name
+        attr_accessor :title
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # The type of the organization. The type can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `work`
+        # * `school`
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
       
         def initialize(**args)
            update!(**args)
@@ -1226,356 +1300,184 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @phonetic_full_name = args[:phonetic_full_name] if args.key?(:phonetic_full_name)
-          @display_name_last_first = args[:display_name_last_first] if args.key?(:display_name_last_first)
-          @display_name = args[:display_name] if args.key?(:display_name)
-          @honorific_suffix = args[:honorific_suffix] if args.key?(:honorific_suffix)
-          @honorific_prefix = args[:honorific_prefix] if args.key?(:honorific_prefix)
-          @phonetic_honorific_suffix = args[:phonetic_honorific_suffix] if args.key?(:phonetic_honorific_suffix)
-          @given_name = args[:given_name] if args.key?(:given_name)
-          @middle_name = args[:middle_name] if args.key?(:middle_name)
-          @phonetic_honorific_prefix = args[:phonetic_honorific_prefix] if args.key?(:phonetic_honorific_prefix)
-          @phonetic_given_name = args[:phonetic_given_name] if args.key?(:phonetic_given_name)
-          @phonetic_family_name = args[:phonetic_family_name] if args.key?(:phonetic_family_name)
-          @family_name = args[:family_name] if args.key?(:family_name)
-          @phonetic_middle_name = args[:phonetic_middle_name] if args.key?(:phonetic_middle_name)
+          @current = args[:current] if args.key?(:current)
+          @department = args[:department] if args.key?(:department)
+          @domain = args[:domain] if args.key?(:domain)
+          @end_date = args[:end_date] if args.key?(:end_date)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @job_description = args[:job_description] if args.key?(:job_description)
+          @location = args[:location] if args.key?(:location)
           @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @phonetic_name = args[:phonetic_name] if args.key?(:phonetic_name)
+          @start_date = args[:start_date] if args.key?(:start_date)
+          @symbol = args[:symbol] if args.key?(:symbol)
+          @title = args[:title] if args.key?(:title)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
-      # A person's locale preference.
-      class Locale
+      # 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.
+      class Person
         include Google::Apis::Core::Hashable
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # The person's street addresses.
+        # Corresponds to the JSON property `addresses`
+        # @return [Array<Google::Apis::PeopleV1::Address>]
+        attr_accessor :addresses
       
-        # The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
-        # language tag representing the locale.
-        # Corresponds to the JSON property `value`
+        # **DEPRECATED** (Please use `person.ageRanges` instead)**
+        # The person's read-only age range.
+        # Corresponds to the JSON property `ageRange`
         # @return [String]
-        attr_accessor :value
-      
-        def initialize(**args)
-           update!(**args)
-        end
+        attr_accessor :age_range
       
-        # Update properties of this object
-        def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
-        end
-      end
+        # The person's read-only age ranges.
+        # Corresponds to the JSON property `ageRanges`
+        # @return [Array<Google::Apis::PeopleV1::AgeRangeType>]
+        attr_accessor :age_ranges
       
-      # 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
+        # The person's biographies.
+        # Corresponds to the JSON property `biographies`
+        # @return [Array<Google::Apis::PeopleV1::Biography>]
+        attr_accessor :biographies
       
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-        end
-      end
-      
-      # A person's short biography.
-      class Biography
-        include Google::Apis::Core::Hashable
-      
-        # The short biography.
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
-      
-        # The content type of the biography.
-        # Corresponds to the JSON property `contentType`
-        # @return [String]
-        attr_accessor :content_type
-      
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @value = args[:value] if args.key?(:value)
-          @content_type = args[:content_type] if args.key?(:content_type)
-          @metadata = args[:metadata] if args.key?(:metadata)
-        end
-      end
-      
-      # Metadata about a field.
-      class FieldMetadata
-        include Google::Apis::Core::Hashable
-      
-        # The source of a field.
-        # Corresponds to the JSON property `source`
-        # @return [Google::Apis::PeopleV1::Source]
-        attr_accessor :source
-      
-        # 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.
-        # Corresponds to the JSON property `verified`
-        # @return [Boolean]
-        attr_accessor :verified
-        alias_method :verified?, :verified
-      
-        # True if the field is the primary field; false if the field is a secondary
-        # field.
-        # Corresponds to the JSON property `primary`
-        # @return [Boolean]
-        attr_accessor :primary
-        alias_method :primary?, :primary
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @source = args[:source] if args.key?(:source)
-          @verified = args[:verified] if args.key?(:verified)
-          @primary = args[:primary] if args.key?(:primary)
-        end
-      end
-      
-      # A person's read-only relationship interest .
-      class RelationshipInterest
-        include Google::Apis::Core::Hashable
-      
-        # 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.
-        # Corresponds to the JSON property `formattedValue`
-        # @return [String]
-        attr_accessor :formatted_value
-      
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
-      
-        # The kind of relationship the person is looking for. The value can be custom
-        # or predefined. Possible values include, but are not limited to, the
-        # following values:
-        # * `friend`
-        # * `date`
-        # * `relationship`
-        # * `networking`
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
-      
-        def initialize(**args)
-           update!(**args)
-        end
+        # The person's birthdays.
+        # Corresponds to the JSON property `birthdays`
+        # @return [Array<Google::Apis::PeopleV1::Birthday>]
+        attr_accessor :birthdays
       
-        # Update properties of this object
-        def update!(**args)
-          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
-        end
-      end
+        # The person's bragging rights.
+        # Corresponds to the JSON property `braggingRights`
+        # @return [Array<Google::Apis::PeopleV1::BraggingRights>]
+        attr_accessor :bragging_rights
       
-      # The source of a field.
-      class Source
-        include Google::Apis::Core::Hashable
+        # The person's read-only cover photos.
+        # Corresponds to the JSON property `coverPhotos`
+        # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
+        attr_accessor :cover_photos
       
-        # The source type.
-        # Corresponds to the JSON property `type`
-        # @return [String]
-        attr_accessor :type
+        # The person's email addresses.
+        # Corresponds to the JSON property `emailAddresses`
+        # @return [Array<Google::Apis::PeopleV1::EmailAddress>]
+        attr_accessor :email_addresses
       
-        # **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.
+        # resource. Used for web cache validation.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # The unique identifier within the source type generated by the server.
-        # Corresponds to the JSON property `id`
-        # @return [String]
-        attr_accessor :id
-      
-        # The read-only metadata about a profile.
-        # Corresponds to the JSON property `profileMetadata`
-        # @return [Google::Apis::PeopleV1::ProfileMetadata]
-        attr_accessor :profile_metadata
-      
-        # **Only populated in `person.metadata.sources`.**
-        # Last update timestamp of this source.
-        # Corresponds to the JSON property `updateTime`
-        # @return [String]
-        attr_accessor :update_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @type = args[:type] if args.key?(:type)
-          @etag = args[:etag] if args.key?(:etag)
-          @id = args[:id] if args.key?(:id)
-          @profile_metadata = args[:profile_metadata] if args.key?(:profile_metadata)
-          @update_time = args[:update_time] if args.key?(:update_time)
-        end
-      end
+        # The person's events.
+        # Corresponds to the JSON property `events`
+        # @return [Array<Google::Apis::PeopleV1::Event>]
+        attr_accessor :events
       
-      # 
-      class GetPeopleResponse
-        include Google::Apis::Core::Hashable
+        # The person's genders.
+        # Corresponds to the JSON property `genders`
+        # @return [Array<Google::Apis::PeopleV1::Gender>]
+        attr_accessor :genders
       
-        # The response for each requested resource name.
-        # Corresponds to the JSON property `responses`
-        # @return [Array<Google::Apis::PeopleV1::PersonResponse>]
-        attr_accessor :responses
+        # The person's instant messaging clients.
+        # Corresponds to the JSON property `imClients`
+        # @return [Array<Google::Apis::PeopleV1::ImClient>]
+        attr_accessor :im_clients
       
-        def initialize(**args)
-           update!(**args)
-        end
+        # The person's interests.
+        # Corresponds to the JSON property `interests`
+        # @return [Array<Google::Apis::PeopleV1::Interest>]
+        attr_accessor :interests
       
-        # Update properties of this object
-        def update!(**args)
-          @responses = args[:responses] if args.key?(:responses)
-        end
-      end
+        # The person's locale preferences.
+        # Corresponds to the JSON property `locales`
+        # @return [Array<Google::Apis::PeopleV1::Locale>]
+        attr_accessor :locales
       
-      # A person's read-only photo. A picture shown next to the person's name to
-      # help others recognize the person.
-      class Photo
-        include Google::Apis::Core::Hashable
+        # The person's read-only group memberships.
+        # Corresponds to the JSON property `memberships`
+        # @return [Array<Google::Apis::PeopleV1::Membership>]
+        attr_accessor :memberships
       
-        # Metadata about a field.
+        # The read-only metadata about a person.
         # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        # @return [Google::Apis::PeopleV1::PersonMetadata]
         attr_accessor :metadata
       
-        # The URL of the photo. You can change the desired size by appending a query
-        # parameter `sz=<size>` at the end of the url. 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
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @url = args[:url] if args.key?(:url)
-        end
-      end
+        # The person's names.
+        # Corresponds to the JSON property `names`
+        # @return [Array<Google::Apis::PeopleV1::Name>]
+        attr_accessor :names
       
-      # A person's phone number.
-      class PhoneNumber
-        include Google::Apis::Core::Hashable
+        # The person's nicknames.
+        # Corresponds to the JSON property `nicknames`
+        # @return [Array<Google::Apis::PeopleV1::Nickname>]
+        attr_accessor :nicknames
       
-        # The read-only type of the phone number 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
+        # The person's occupations.
+        # Corresponds to the JSON property `occupations`
+        # @return [Array<Google::Apis::PeopleV1::Occupation>]
+        attr_accessor :occupations
       
-        # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/
-        # ibr/004/itu-t.E.164.1.2008.pdf)
-        # form of the phone number.
-        # Corresponds to the JSON property `canonicalForm`
-        # @return [String]
-        attr_accessor :canonical_form
+        # The person's past or current organizations.
+        # Corresponds to the JSON property `organizations`
+        # @return [Array<Google::Apis::PeopleV1::Organization>]
+        attr_accessor :organizations
       
-        # The type of the phone number. The type can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `home`
-        # * `work`
-        # * `mobile`
-        # * `homeFax`
-        # * `workFax`
-        # * `otherFax`
-        # * `pager`
-        # * `workMobile`
-        # * `workPager`
-        # * `main`
-        # * `googleVoice`
-        # * `other`
-        # Corresponds to the JSON property `type`
-        # @return [String]
-        attr_accessor :type
+        # The person's phone numbers.
+        # Corresponds to the JSON property `phoneNumbers`
+        # @return [Array<Google::Apis::PeopleV1::PhoneNumber>]
+        attr_accessor :phone_numbers
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # The person's read-only photos.
+        # Corresponds to the JSON property `photos`
+        # @return [Array<Google::Apis::PeopleV1::Photo>]
+        attr_accessor :photos
       
-        # The phone number.
-        # Corresponds to the JSON property `value`
-        # @return [String]
-        attr_accessor :value
+        # The person's relations.
+        # Corresponds to the JSON property `relations`
+        # @return [Array<Google::Apis::PeopleV1::Relation>]
+        attr_accessor :relations
       
-        def initialize(**args)
-           update!(**args)
-        end
+        # The person's read-only relationship interests.
+        # Corresponds to the JSON property `relationshipInterests`
+        # @return [Array<Google::Apis::PeopleV1::RelationshipInterest>]
+        attr_accessor :relationship_interests
       
-        # Update properties of this object
-        def update!(**args)
-          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
-          @canonical_form = args[:canonical_form] if args.key?(:canonical_form)
-          @type = args[:type] if args.key?(:type)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @value = args[:value] if args.key?(:value)
-        end
-      end
+        # The person's read-only relationship statuses.
+        # Corresponds to the JSON property `relationshipStatuses`
+        # @return [Array<Google::Apis::PeopleV1::RelationshipStatus>]
+        attr_accessor :relationship_statuses
       
-      # 
-      class ListConnectionsResponse
-        include Google::Apis::Core::Hashable
+        # The person's residences.
+        # Corresponds to the JSON property `residences`
+        # @return [Array<Google::Apis::PeopleV1::Residence>]
+        attr_accessor :residences
       
-        # The token that can be used to retrieve the next page of results.
-        # Corresponds to the JSON property `nextPageToken`
+        # 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/`<var>person_id</var>.
+        # Corresponds to the JSON property `resourceName`
         # @return [String]
-        attr_accessor :next_page_token
-      
-        # The total number of items in the list without pagination.
-        # Corresponds to the JSON property `totalItems`
-        # @return [Fixnum]
-        attr_accessor :total_items
+        attr_accessor :resource_name
       
-        # The token that can be used to retrieve changes since the last request.
-        # Corresponds to the JSON property `nextSyncToken`
-        # @return [String]
-        attr_accessor :next_sync_token
+        # The person's skills.
+        # Corresponds to the JSON property `skills`
+        # @return [Array<Google::Apis::PeopleV1::Skill>]
+        attr_accessor :skills
       
-        # The list of people that the requestor is connected to.
-        # Corresponds to the JSON property `connections`
-        # @return [Array<Google::Apis::PeopleV1::Person>]
-        attr_accessor :connections
+        # The person's read-only taglines.
+        # Corresponds to the JSON property `taglines`
+        # @return [Array<Google::Apis::PeopleV1::Tagline>]
+        attr_accessor :taglines
       
-        # **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
+        # The person's associated URLs.
+        # Corresponds to the JSON property `urls`
+        # @return [Array<Google::Apis::PeopleV1::Url>]
+        attr_accessor :urls
       
         def initialize(**args)
            update!(**args)
@@ -1583,41 +1485,77 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-          @total_items = args[:total_items] if args.key?(:total_items)
-          @next_sync_token = args[:next_sync_token] if args.key?(:next_sync_token)
-          @connections = args[:connections] if args.key?(:connections)
-          @total_people = args[:total_people] if args.key?(:total_people)
+          @addresses = args[:addresses] if args.key?(:addresses)
+          @age_range = args[:age_range] if args.key?(:age_range)
+          @age_ranges = args[:age_ranges] if args.key?(:age_ranges)
+          @biographies = args[:biographies] if args.key?(:biographies)
+          @birthdays = args[:birthdays] if args.key?(:birthdays)
+          @bragging_rights = args[:bragging_rights] if args.key?(:bragging_rights)
+          @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)
+          @genders = args[:genders] if args.key?(:genders)
+          @im_clients = args[:im_clients] if args.key?(:im_clients)
+          @interests = args[:interests] if args.key?(:interests)
+          @locales = args[:locales] if args.key?(:locales)
+          @memberships = args[:memberships] if args.key?(:memberships)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @names = args[:names] if args.key?(:names)
+          @nicknames = args[:nicknames] if args.key?(:nicknames)
+          @occupations = args[:occupations] if args.key?(:occupations)
+          @organizations = args[:organizations] if args.key?(:organizations)
+          @phone_numbers = args[:phone_numbers] if args.key?(:phone_numbers)
+          @photos = args[:photos] if args.key?(:photos)
+          @relations = args[:relations] if args.key?(:relations)
+          @relationship_interests = args[:relationship_interests] if args.key?(:relationship_interests)
+          @relationship_statuses = args[:relationship_statuses] if args.key?(:relationship_statuses)
+          @residences = args[:residences] if args.key?(:residences)
+          @resource_name = args[:resource_name] if args.key?(:resource_name)
+          @skills = args[:skills] if args.key?(:skills)
+          @taglines = args[:taglines] if args.key?(:taglines)
+          @urls = args[:urls] if args.key?(:urls)
         end
       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.
-      class Birthday
+      # The read-only metadata about a person.
+      class PersonMetadata
         include Google::Apis::Core::Hashable
       
-        # A free-form string representing the user's birthday.
-        # Corresponds to the JSON property `text`
-        # @return [String]
-        attr_accessor :text
+        # 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
+        alias_method :deleted?, :deleted
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # Resource names of people linked to this resource.
+        # Corresponds to the JSON property `linkedPeopleResourceNames`
+        # @return [Array<String>]
+        attr_accessor :linked_people_resource_names
       
-        # Represents a whole calendar date, for example a date of birth. The time
-        # of day and time zone are either specified elsewhere or are not
-        # significant. The date is relative to the
-        # [Proleptic Gregorian Calendar](https://en.wikipedia.org/wiki/
-        # Proleptic_Gregorian_calendar).
-        # The day may be 0 to represent a year and month where the day is not
-        # significant. The year may be 0 to represent a month and day independent
-        # of year; for example, anniversary date.
-        # Corresponds to the JSON property `date`
-        # @return [Google::Apis::PeopleV1::Date]
-        attr_accessor :date
+        # **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
+      
+        # 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.
+        # Corresponds to the JSON property `previousResourceNames`
+        # @return [Array<String>]
+        attr_accessor :previous_resource_names
+      
+        # The sources of data for the person.
+        # Corresponds to the JSON property `sources`
+        # @return [Array<Google::Apis::PeopleV1::Source>]
+        attr_accessor :sources
       
         def initialize(**args)
            update!(**args)
@@ -1625,20 +1563,85 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @text = args[:text] if args.key?(:text)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @date = args[:date] if args.key?(:date)
+          @deleted = args[:deleted] if args.key?(:deleted)
+          @linked_people_resource_names = args[:linked_people_resource_names] if args.key?(:linked_people_resource_names)
+          @object_type = args[:object_type] if args.key?(:object_type)
+          @previous_resource_names = args[:previous_resource_names] if args.key?(:previous_resource_names)
+          @sources = args[:sources] if args.key?(:sources)
         end
       end
       
-      # A request to create a new contact group.
-      class CreateContactGroupRequest
+      # The response for a single person
+      class PersonResponse
         include Google::Apis::Core::Hashable
       
-        # A contact group.
-        # Corresponds to the JSON property `contactGroup`
-        # @return [Google::Apis::PeopleV1::ContactGroup]
-        attr_accessor :contact_group
+        # **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.
+        # 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.
+        # 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). The error model is designed to be:
+        # - Simple to use and understand for most users
+        # - Flexible enough to meet unexpected needs
+        # # Overview
+        # The `Status` message contains three pieces of data: error code, error message,
+        # and error details. The error code should be an enum value of
+        # google.rpc.Code, but it may accept additional error codes if needed.  The
+        # error message should be a developer-facing English message that helps
+        # developers *understand* and *resolve* the error. If a localized user-facing
+        # error message is needed, put the localized message in the error details or
+        # localize it in the client. The optional error details may contain arbitrary
+        # information about the error. There is a predefined set of error detail types
+        # in the package `google.rpc` that can be used for common error conditions.
+        # # Language mapping
+        # The `Status` message is the logical representation of the error model, but it
+        # is not necessarily the actual wire format. When the `Status` message is
+        # exposed in different client libraries and different wire protocols, it can be
+        # mapped differently. For example, it will likely be mapped to some exceptions
+        # in Java, but more likely mapped to some error codes in C.
+        # # Other uses
+        # The error model and the `Status` message can be used in a variety of
+        # environments, either with or without APIs, to provide a
+        # consistent developer experience across different environments.
+        # Example uses of this error model include:
+        # - Partial errors. If a service needs to return partial errors to the client,
+        # it may embed the `Status` in the normal response to indicate the partial
+        # errors.
+        # - Workflow errors. A typical workflow has multiple steps. Each step may
+        # have a `Status` message for error reporting.
+        # - Batch operations. If a client uses batch request and batch response, the
+        # `Status` message should be used directly inside batch response, one for
+        # each error sub-response.
+        # - Asynchronous operations. If an API call embeds asynchronous operation
+        # results in its response, the status of those operations should be
+        # represented directly using the `Status` message.
+        # - Logging. If some API errors are stored in logs, the message `Status` could
+        # be used directly after any stripping needed for security/privacy reasons.
+        # Corresponds to the JSON property `status`
+        # @return [Google::Apis::PeopleV1::Status]
+        attr_accessor :status
       
         def initialize(**args)
            update!(**args)
@@ -1646,81 +1649,57 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @contact_group = args[:contact_group] if args.key?(:contact_group)
+          @http_status_code = args[:http_status_code] if args.key?(:http_status_code)
+          @person = args[:person] if args.key?(:person)
+          @requested_resource_name = args[:requested_resource_name] if args.key?(:requested_resource_name)
+          @status = args[:status] if args.key?(:status)
         end
       end
       
-      # A person's physical address. May be a P.O. box or street address. All fields
-      # are optional.
-      class Address
+      # A person's phone number.
+      class PhoneNumber
         include Google::Apis::Core::Hashable
       
-        # The postal code of the address.
-        # Corresponds to the JSON property `postalCode`
-        # @return [String]
-        attr_accessor :postal_code
-      
-        # The region of the address; for example, the state or province.
-        # Corresponds to the JSON property `region`
+        # The read-only canonicalized [ITU-T E.164](https://law.resource.org/pub/us/cfr/
+        # ibr/004/itu-t.E.164.1.2008.pdf)
+        # form of the phone number.
+        # Corresponds to the JSON property `canonicalForm`
         # @return [String]
-        attr_accessor :region
+        attr_accessor :canonical_form
       
-        # The street address.
-        # Corresponds to the JSON property `streetAddress`
+        # The read-only type of the phone number 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 :street_address
+        attr_accessor :formatted_type
       
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
-        # code of the address.
-        # Corresponds to the JSON property `countryCode`
-        # @return [String]
-        attr_accessor :country_code
-      
-        # The read-only type of the address 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
-      
-        # The city of the address.
-        # Corresponds to the JSON property `city`
-        # @return [String]
-        attr_accessor :city
-      
-        # 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
-      
-        # The country of the address.
-        # Corresponds to the JSON property `country`
-        # @return [String]
-        attr_accessor :country
-      
-        # The type of the address. The type can be custom or predefined.
+        # The type of the phone number. The type can be custom or predefined.
         # Possible values include, but are not limited to, the following:
         # * `home`
         # * `work`
+        # * `mobile`
+        # * `homeFax`
+        # * `workFax`
+        # * `otherFax`
+        # * `pager`
+        # * `workMobile`
+        # * `workPager`
+        # * `main`
+        # * `googleVoice`
         # * `other`
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # The extended address of the address; for example, the apartment number.
-        # Corresponds to the JSON property `extendedAddress`
-        # @return [String]
-        attr_accessor :extended_address
-      
-        # The P.O. box of the address.
-        # Corresponds to the JSON property `poBox`
+        # The phone number.
+        # Corresponds to the JSON property `value`
         # @return [String]
-        attr_accessor :po_box
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -1728,104 +1707,56 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @postal_code = args[:postal_code] if args.key?(:postal_code)
-          @region = args[:region] if args.key?(:region)
-          @street_address = args[:street_address] if args.key?(:street_address)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @country_code = args[:country_code] if args.key?(:country_code)
+          @canonical_form = args[:canonical_form] if args.key?(:canonical_form)
           @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
-          @city = args[:city] if args.key?(:city)
-          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
-          @country = args[:country] if args.key?(:country)
+          @metadata = args[:metadata] if args.key?(:metadata)
           @type = args[:type] if args.key?(:type)
-          @extended_address = args[:extended_address] if args.key?(:extended_address)
-          @po_box = args[:po_box] if args.key?(:po_box)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # A Google contact group membership.
-      class ContactGroupMembership
+      # A person's read-only photo. A picture shown next to the person's name to
+      # help others recognize the person.
+      class Photo
         include Google::Apis::Core::Hashable
       
-        # The contact group ID for the contact group membership. The contact group
-        # ID can be custom or predefined. Possible values include, but are not
-        # limited to, the following:
-        # *  `myContacts`
-        # *  `starred`
-        # *  A numerical ID for user-created groups.
-        # Corresponds to the JSON property `contactGroupId`
-        # @return [String]
-        attr_accessor :contact_group_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @contact_group_id = args[:contact_group_id] if args.key?(:contact_group_id)
-        end
-      end
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-      # 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). The error model is designed to be:
-      # - Simple to use and understand for most users
-      # - Flexible enough to meet unexpected needs
-      # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
-      # google.rpc.Code, but it may accept additional error codes if needed.  The
-      # error message should be a developer-facing English message that helps
-      # developers *understand* and *resolve* the error. If a localized user-facing
-      # error message is needed, put the localized message in the error details or
-      # localize it in the client. The optional error details may contain arbitrary
-      # information about the error. There is a predefined set of error detail types
-      # in the package `google.rpc` that can be used for common error conditions.
-      # # Language mapping
-      # The `Status` message is the logical representation of the error model, but it
-      # is not necessarily the actual wire format. When the `Status` message is
-      # exposed in different client libraries and different wire protocols, it can be
-      # mapped differently. For example, it will likely be mapped to some exceptions
-      # in Java, but more likely mapped to some error codes in C.
-      # # Other uses
-      # The error model and the `Status` message can be used in a variety of
-      # environments, either with or without APIs, to provide a
-      # consistent developer experience across different environments.
-      # Example uses of this error model include:
-      # - Partial errors. If a service needs to return partial errors to the client,
-      # it may embed the `Status` in the normal response to indicate the partial
-      # errors.
-      # - Workflow errors. A typical workflow has multiple steps. Each step may
-      # have a `Status` message for error reporting.
-      # - Batch operations. If a client uses batch request and batch response, the
-      # `Status` message should be used directly inside batch response, one for
-      # each error sub-response.
-      # - Asynchronous operations. If an API call embeds asynchronous operation
-      # results in its response, the status of those operations should be
-      # represented directly using the `Status` message.
-      # - Logging. If some API errors are stored in logs, the message `Status` could
-      # be used directly after any stripping needed for security/privacy reasons.
-      class Status
+        # The URL of the photo. You can change the desired size by appending a query
+        # parameter `sz=`<var>size</var> at the end of the url. 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
+      # The read-only metadata about a profile.
+      class ProfileMetadata
         include Google::Apis::Core::Hashable
       
-        # 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`
+        # The profile object type.
+        # Corresponds to the JSON property `objectType`
         # @return [String]
-        attr_accessor :message
-      
-        # 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
+        attr_accessor :object_type
       
-        # The status code, which should be an enum value of google.rpc.Code.
-        # Corresponds to the JSON property `code`
-        # @return [Fixnum]
-        attr_accessor :code
+        # The user types.
+        # Corresponds to the JSON property `userTypes`
+        # @return [Array<String>]
+        attr_accessor :user_types
       
         def initialize(**args)
            update!(**args)
@@ -1833,50 +1764,51 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @message = args[:message] if args.key?(:message)
-          @details = args[:details] if args.key?(:details)
-          @code = args[:code] if args.key?(:code)
+          @object_type = args[:object_type] if args.key?(:object_type)
+          @user_types = args[:user_types] if args.key?(:user_types)
         end
       end
       
-      # The read-only metadata about a person.
-      class PersonMetadata
+      # A person's relation to another person.
+      class Relation
         include Google::Apis::Core::Hashable
       
-        # 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.
-        # Corresponds to the JSON property `previousResourceNames`
-        # @return [Array<String>]
-        attr_accessor :previous_resource_names
-      
-        # The sources of data for the person.
-        # Corresponds to the JSON property `sources`
-        # @return [Array<Google::Apis::PeopleV1::Source>]
-        attr_accessor :sources
+        # The type of the relation translated and formatted in the viewer's account
+        # locale or the locale specified in the Accept-Language HTTP header.
+        # Corresponds to the JSON property `formattedType`
+        # @return [String]
+        attr_accessor :formatted_type
       
-        # 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
-        alias_method :deleted?, :deleted
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
       
-        # **DEPRECATED** (Please use
-        # `person.metadata.sources.profileMetadata.objectType` instead)
-        # The type of the person object.
-        # Corresponds to the JSON property `objectType`
+        # The name of the other person this relation refers to.
+        # Corresponds to the JSON property `person`
         # @return [String]
-        attr_accessor :object_type
+        attr_accessor :person
       
-        # Resource names of people linked to this resource.
-        # Corresponds to the JSON property `linkedPeopleResourceNames`
-        # @return [Array<String>]
-        attr_accessor :linked_people_resource_names
+        # The person's relation to the other person. The type can be custom or
+        # predefined.
+        # Possible values include, but are not limited to, the following values:
+        # * `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
       
         def initialize(**args)
            update!(**args)
@@ -1884,29 +1816,39 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @previous_resource_names = args[:previous_resource_names] if args.key?(:previous_resource_names)
-          @sources = args[:sources] if args.key?(:sources)
-          @deleted = args[:deleted] if args.key?(:deleted)
-          @object_type = args[:object_type] if args.key?(:object_type)
-          @linked_people_resource_names = args[:linked_people_resource_names] if args.key?(:linked_people_resource_names)
+          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @person = args[:person] if args.key?(:person)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
-      # A request to modify an existing contact group's members.
-      class ModifyContactGroupMembersRequest
+      # A person's read-only relationship interest .
+      class RelationshipInterest
         include Google::Apis::Core::Hashable
       
-        # The resource names of the contact people to add in the form of in the form
-        # `people/<person_id>`.
-        # Corresponds to the JSON property `resourceNamesToAdd`
-        # @return [Array<String>]
-        attr_accessor :resource_names_to_add
+        # 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.
+        # Corresponds to the JSON property `formattedValue`
+        # @return [String]
+        attr_accessor :formatted_value
       
-        # The resource names of the contact people to remove in the form of in the
-        # form of `people/<person_id>`.
-        # Corresponds to the JSON property `resourceNamesToRemove`
-        # @return [Array<String>]
-        attr_accessor :resource_names_to_remove
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The kind of relationship the person is looking for. The value can be custom
+        # or predefined. Possible values include, but are not limited to, the
+        # following values:
+        # * `friend`
+        # * `date`
+        # * `relationship`
+        # * `networking`
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -1914,67 +1856,74 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @resource_names_to_add = args[:resource_names_to_add] if args.key?(:resource_names_to_add)
-          @resource_names_to_remove = args[:resource_names_to_remove] if args.key?(:resource_names_to_remove)
+          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # The response for a specific contact group.
-      class ContactGroupResponse
+      # A person's read-only relationship status.
+      class RelationshipStatus
         include Google::Apis::Core::Hashable
       
-        # 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). The error model is designed to be:
-        # - Simple to use and understand for most users
-        # - Flexible enough to meet unexpected needs
-        # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
-        # google.rpc.Code, but it may accept additional error codes if needed.  The
-        # error message should be a developer-facing English message that helps
-        # developers *understand* and *resolve* the error. If a localized user-facing
-        # error message is needed, put the localized message in the error details or
-        # localize it in the client. The optional error details may contain arbitrary
-        # information about the error. There is a predefined set of error detail types
-        # in the package `google.rpc` that can be used for common error conditions.
-        # # Language mapping
-        # The `Status` message is the logical representation of the error model, but it
-        # is not necessarily the actual wire format. When the `Status` message is
-        # exposed in different client libraries and different wire protocols, it can be
-        # mapped differently. For example, it will likely be mapped to some exceptions
-        # in Java, but more likely mapped to some error codes in C.
-        # # Other uses
-        # The error model and the `Status` message can be used in a variety of
-        # environments, either with or without APIs, to provide a
-        # consistent developer experience across different environments.
-        # Example uses of this error model include:
-        # - Partial errors. If a service needs to return partial errors to the client,
-        # it may embed the `Status` in the normal response to indicate the partial
-        # errors.
-        # - Workflow errors. A typical workflow has multiple steps. Each step may
-        # have a `Status` message for error reporting.
-        # - Batch operations. If a client uses batch request and batch response, the
-        # `Status` message should be used directly inside batch response, one for
-        # each error sub-response.
-        # - Asynchronous operations. If an API call embeds asynchronous operation
-        # results in its response, the status of those operations should be
-        # represented directly using the `Status` message.
-        # - Logging. If some API errors are stored in logs, the message `Status` could
-        # be used directly after any stripping needed for security/privacy reasons.
-        # Corresponds to the JSON property `status`
-        # @return [Google::Apis::PeopleV1::Status]
-        attr_accessor :status
+        # The read-only value of the relationship status translated and formatted in
+        # the viewer's account locale or the `Accept-Language` HTTP header locale.
+        # Corresponds to the JSON property `formattedValue`
+        # @return [String]
+        attr_accessor :formatted_value
       
-        # The original requested resource name.
-        # Corresponds to the JSON property `requestedResourceName`
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The relationship status. The value can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `single`
+        # * `inARelationship`
+        # * `engaged`
+        # * `married`
+        # * `itsComplicated`
+        # * `openRelationship`
+        # * `widowed`
+        # * `inDomesticPartnership`
+        # * `inCivilUnion`
+        # Corresponds to the JSON property `value`
         # @return [String]
-        attr_accessor :requested_resource_name
+        attr_accessor :value
       
-        # A contact group.
-        # Corresponds to the JSON property `contactGroup`
-        # @return [Google::Apis::PeopleV1::ContactGroup]
-        attr_accessor :contact_group
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @formatted_value = args[:formatted_value] if args.key?(:formatted_value)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # A person's past or current residence.
+      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.
+        # Corresponds to the JSON property `current`
+        # @return [Boolean]
+        attr_accessor :current
+        alias_method :current?, :current
+      
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The address of the residence.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -1982,109 +1931,142 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @status = args[:status] if args.key?(:status)
-          @requested_resource_name = args[:requested_resource_name] if args.key?(:requested_resource_name)
-          @contact_group = args[:contact_group] if args.key?(:contact_group)
+          @current = args[:current] if args.key?(:current)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # A person's associated URLs.
-      class Url
+      # A skill that the person has.
+      class Skill
         include Google::Apis::Core::Hashable
       
-        # The type of the URL. The type can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `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
-      
         # Metadata about a field.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # The URL.
+        # The skill; for example, `underwater basket weaving`.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
       
-        # The read-only type of the 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
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @type = args[:type] if args.key?(:type)
           @metadata = args[:metadata] if args.key?(:metadata)
           @value = args[:value] if args.key?(:value)
-          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
         end
       end
       
-      # A person's instant messaging client.
-      class ImClient
+      # The source of a field.
+      class Source
         include Google::Apis::Core::Hashable
       
-        # Metadata about a field.
-        # Corresponds to the JSON property `metadata`
-        # @return [Google::Apis::PeopleV1::FieldMetadata]
-        attr_accessor :metadata
+        # **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
       
-        # The type of the IM client. The type can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `home`
-        # * `work`
-        # * `other`
+        # The unique identifier within the source type generated by the server.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The read-only metadata about a profile.
+        # Corresponds to the JSON property `profileMetadata`
+        # @return [Google::Apis::PeopleV1::ProfileMetadata]
+        attr_accessor :profile_metadata
+      
+        # The source type.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # The protocol of the IM client. The protocol can be custom or predefined.
-        # Possible values include, but are not limited to, the following:
-        # * `aim`
-        # * `msn`
-        # * `yahoo`
-        # * `skype`
-        # * `qq`
-        # * `googleTalk`
-        # * `icq`
-        # * `jabber`
-        # * `netMeeting`
-        # Corresponds to the JSON property `protocol`
+        # **Only populated in `person.metadata.sources`.**
+        # Last update timestamp of this source.
+        # Corresponds to the JSON property `updateTime`
         # @return [String]
-        attr_accessor :protocol
+        attr_accessor :update_time
       
-        # The user name used in the IM client.
-        # Corresponds to the JSON property `username`
-        # @return [String]
-        attr_accessor :username
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # The read-only protocol of the IM client formatted in the viewer's account
-        # locale or the `Accept-Language` HTTP header locale.
-        # Corresponds to the JSON property `formattedProtocol`
-        # @return [String]
-        attr_accessor :formatted_protocol
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @id = args[:id] if args.key?(:id)
+          @profile_metadata = args[:profile_metadata] if args.key?(:profile_metadata)
+          @type = args[:type] if args.key?(:type)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
       
-        # The read-only 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`
+      # 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). The error model is designed to be:
+      # - Simple to use and understand for most users
+      # - Flexible enough to meet unexpected needs
+      # # Overview
+      # The `Status` message contains three pieces of data: error code, error message,
+      # and error details. The error code should be an enum value of
+      # google.rpc.Code, but it may accept additional error codes if needed.  The
+      # error message should be a developer-facing English message that helps
+      # developers *understand* and *resolve* the error. If a localized user-facing
+      # error message is needed, put the localized message in the error details or
+      # localize it in the client. The optional error details may contain arbitrary
+      # information about the error. There is a predefined set of error detail types
+      # in the package `google.rpc` that can be used for common error conditions.
+      # # Language mapping
+      # The `Status` message is the logical representation of the error model, but it
+      # is not necessarily the actual wire format. When the `Status` message is
+      # exposed in different client libraries and different wire protocols, it can be
+      # mapped differently. For example, it will likely be mapped to some exceptions
+      # in Java, but more likely mapped to some error codes in C.
+      # # Other uses
+      # The error model and the `Status` message can be used in a variety of
+      # environments, either with or without APIs, to provide a
+      # consistent developer experience across different environments.
+      # Example uses of this error model include:
+      # - Partial errors. If a service needs to return partial errors to the client,
+      # it may embed the `Status` in the normal response to indicate the partial
+      # errors.
+      # - Workflow errors. A typical workflow has multiple steps. Each step may
+      # have a `Status` message for error reporting.
+      # - Batch operations. If a client uses batch request and batch response, the
+      # `Status` message should be used directly inside batch response, one for
+      # each error sub-response.
+      # - Asynchronous operations. If an API call embeds asynchronous operation
+      # results in its response, the status of those operations should be
+      # represented directly using the `Status` message.
+      # - Logging. If some API errors are stored in logs, the message `Status` could
+      # be used directly after any stripping needed for security/privacy reasons.
+      class Status
+        include Google::Apis::Core::Hashable
+      
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # 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.
+        # Corresponds to the JSON property `message`
         # @return [String]
-        attr_accessor :formatted_type
+        attr_accessor :message
       
         def initialize(**args)
            update!(**args)
@@ -2092,24 +2074,25 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @metadata = args[:metadata] if args.key?(:metadata)
-          @type = args[:type] if args.key?(:type)
-          @protocol = args[:protocol] if args.key?(:protocol)
-          @username = args[:username] if args.key?(:username)
-          @formatted_protocol = args[:formatted_protocol] if args.key?(:formatted_protocol)
-          @formatted_type = args[:formatted_type] if args.key?(:formatted_type)
+          @code = args[:code] if args.key?(:code)
+          @details = args[:details] if args.key?(:details)
+          @message = args[:message] if args.key?(:message)
         end
       end
       
-      # A Google Apps Domain membership.
-      class DomainMembership
+      # A read-only brief one-line description of the person.
+      class Tagline
         include Google::Apis::Core::Hashable
       
-        # True if the person is in the viewer's Google Apps domain.
-        # Corresponds to the JSON property `inViewerDomain`
-        # @return [Boolean]
-        attr_accessor :in_viewer_domain
-        alias_method :in_viewer_domain?, :in_viewer_domain
+        # Metadata about a field.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::PeopleV1::FieldMetadata]
+        attr_accessor :metadata
+      
+        # The tagline.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -2117,18 +2100,19 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @in_viewer_domain = args[:in_viewer_domain] if args.key?(:in_viewer_domain)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # The response to a batch get contact groups request.
-      class BatchGetContactGroupsResponse
+      # A request to update an existing contact group. Only the name can be updated.
+      class UpdateContactGroupRequest
         include Google::Apis::Core::Hashable
       
-        # The list of responses for each requested contact group resource.
-        # Corresponds to the JSON property `responses`
-        # @return [Array<Google::Apis::PeopleV1::ContactGroupResponse>]
-        attr_accessor :responses
+        # A contact group.
+        # Corresponds to the JSON property `contactGroup`
+        # @return [Google::Apis::PeopleV1::ContactGroup]
+        attr_accessor :contact_group
       
         def initialize(**args)
            update!(**args)
@@ -2136,28 +2120,44 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @responses = args[:responses] if args.key?(:responses)
+          @contact_group = args[:contact_group] if args.key?(:contact_group)
         end
       end
       
-      # A person's read-only membership in a group.
-      class Membership
+      # A person's associated URLs.
+      class Url
         include Google::Apis::Core::Hashable
       
+        # The read-only type of the 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
       
-        # A Google Apps Domain membership.
-        # Corresponds to the JSON property `domainMembership`
-        # @return [Google::Apis::PeopleV1::DomainMembership]
-        attr_accessor :domain_membership
+        # The type of the URL. The type can be custom or predefined.
+        # Possible values include, but are not limited to, the following:
+        # * `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
       
-        # A Google contact group membership.
-        # Corresponds to the JSON property `contactGroupMembership`
-        # @return [Google::Apis::PeopleV1::ContactGroupMembership]
-        attr_accessor :contact_group_membership
+        # The URL.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -2165,9 +2165,10 @@ module Google
       
         # 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)
-          @domain_membership = args[:domain_membership] if args.key?(:domain_membership)
-          @contact_group_membership = args[:contact_group_membership] if args.key?(:contact_group_membership)
+          @type = args[:type] if args.key?(:type)
+          @value = args[:value] if args.key?(:value)
         end
       end
     end