google-apis-people_v1 0.8.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e11b89a8e80ab4658833f8f1855258148de969889a371c59dd83b106de16c3c6
-  data.tar.gz: c9ec437b9581bff7fa9598cdae293949d983111407aa2cff051ad8cb5c616713
+  metadata.gz: 364e27c9c4f7b5a658554ccdc4d19346370f14bfcb0dcbdaf2d57d093a2a1d26
+  data.tar.gz: 158d7d594f94fdb1db990aa51869b7873b69fc5809bc12b64ae7bafdfd432d60
 SHA512:
-  metadata.gz: ecd81e4b3b43fea69662e880805a8d279a38d69cb8982f32d8ffe99f5f2c2b7dfb43707aad9a1471c729e6bd1367ddfd3cdf789106af851b3895f579a9e34cb4
-  data.tar.gz: 7235ccc06d0c40a475a614c41cc002fd10755dce99671dbb55f238db2a0036502a8736d3f19e568c19c83bf5126c86b1b6048b86f71fa440d2c7098fda5ecbbe
+  metadata.gz: 0aaef8be1d2fac55715dc34bcf00809b0541ebf577a027a41a926956551e109ce0d1ae57877040dbd76b668cb993bf2bce467ef443f4895f6b54034ff8e550f7
+  data.tar.gz: ca30bbcae67a6d76ff287a2dd3b7588059d8143040f8b3fdf89fe05fe243cf2b9bfd0d6542883866588ef046de3ed5708b879e7420f8b990810adebdacdcbcdd

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Release history for google-apis-people_v1
 
+### v0.13.0 (2021-06-19)
+
+* Regenerated from discovery document revision 20210617
+
+### v0.12.0 (2021-06-09)
+
+* Regenerated from discovery document revision 20210607
+* Regenerated using generator version 0.3.0
+
+### v0.11.0 (2021-05-28)
+
+* Regenerated from discovery document revision 20210526
+
+### v0.10.0 (2021-05-19)
+
+* Regenerated from discovery document revision 20210515
+
+### v0.9.0 (2021-04-21)
+
+* Regenerated from discovery document revision 20210419
+
 ### v0.8.0 (2021-03-31)
 
 * Regenerated from discovery document revision 20210330

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

@@ -831,11 +831,11 @@ module Google
         end
       end
       
-      # A G Suite Domain membership.
+      # A Google Workspace Domain membership.
       class DomainMembership
         include Google::Apis::Core::Hashable
       
-        # True if the person is in the viewer's G Suite domain.
+        # True if the person is in the viewer's Google Workspace domain.
         # Corresponds to the JSON property `inViewerDomain`
         # @return [Boolean]
         attr_accessor :in_viewer_domain
@@ -1364,6 +1364,11 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Person>]
         attr_accessor :other_contacts
       
+        # The total number of other contacts in the list without pagination.
+        # Corresponds to the JSON property `totalSize`
+        # @return [Fixnum]
+        attr_accessor :total_size
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1373,6 +1378,7 @@ module Google
           @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)
           @other_contacts = args[:other_contacts] if args.key?(:other_contacts)
+          @total_size = args[:total_size] if args.key?(:total_size)
         end
       end
       
@@ -1475,7 +1481,7 @@ module Google
         # @return [Google::Apis::PeopleV1::ContactGroupMembership]
         attr_accessor :contact_group_membership
       
-        # A G Suite Domain membership.
+        # A Google Workspace Domain membership.
         # Corresponds to the JSON property `domainMembership`
         # @return [Google::Apis::PeopleV1::DomainMembership]
         attr_accessor :domain_membership
@@ -1925,7 +1931,12 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
         attr_accessor :cover_photos
       
-        # The person's email addresses.
+        # The person's email addresses. For [`connections.list`](/people/api/rest/v1/
+        # people.connections/list), [`otherContacts.list`](/people/api/rest/v1/
+        # otherContacts/list), and [`people.listDirectoryPeople`](/people/api/rest/v1/
+        # people/listDirectoryPeople) the number of email addresses is limited to 100.
+        # If a Person has more email addresses the entire set can be obtained by calling
+        # ['people.get'](/people/api/rest/v1/people/get).
         # Corresponds to the JSON property `emailAddresses`
         # @return [Array<Google::Apis::PeopleV1::EmailAddress>]
         attr_accessor :email_addresses
@@ -2011,7 +2022,12 @@ module Google
         # @return [Array<Google::Apis::PeopleV1::Organization>]
         attr_accessor :organizations
       
-        # The person's phone numbers.
+        # The person's phone numbers. For [`connections.list`](/people/api/rest/v1/
+        # people.connections/list), [`otherContacts.list`](/people/api/rest/v1/
+        # otherContacts/list), and [`people.listDirectoryPeople`](/people/api/rest/v1/
+        # people/listDirectoryPeople) the number of phone numbers is limited to 100. If
+        # a Person has more phone numbers the entire set can be obtained by calling ['
+        # people.get'](/people/api/rest/v1/people/get).
         # Corresponds to the JSON property `phoneNumbers`
         # @return [Array<Google::Apis::PeopleV1::PhoneNumber>]
         attr_accessor :phone_numbers
@@ -2127,7 +2143,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. True if the person resource has been deleted. Populated only for [
-        # `connections.list`](/people/api/rest/v1/people.connections/list) requests that
+        # `connections.list`](/people/api/rest/v1/people.connections/list) and [`
+        # otherContacts.list`](/people/api/rest/v1/otherContacts/list) requests that
         # include a sync token.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]

data/lib/google/apis/people_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module PeopleV1
       # Version of the google-apis-people_v1 gem
-      GEM_VERSION = "0.8.0"
+      GEM_VERSION = "0.13.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.2.0"
+      GENERATOR_VERSION = "0.3.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210330"
+      REVISION = "20210617"
     end
   end
 end

data/lib/google/apis/people_v1/representations.rb

@@ -838,6 +838,7 @@ module Google
           property :next_sync_token, as: 'nextSyncToken'
           collection :other_contacts, as: 'otherContacts', class: Google::Apis::PeopleV1::Person, decorator: Google::Apis::PeopleV1::Person::Representation
       
+          property :total_size, as: 'totalSize'
         end
       end
       

data/lib/google/apis/people_v1/service.rb

@@ -60,7 +60,8 @@ module Google
         #   Optional. Specifies the maximum number of members to return for each group.
         #   Defaults to 0 if not set, which will return zero members.
         # @param [Array<String>, String] resource_names
-        #   Required. The resource names of the contact groups to get.
+        #   Required. The resource names of the contact groups to get. There is a maximum
+        #   of 200 resource names.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -359,7 +360,7 @@ module Google
         # @param [String] read_mask
         #   Required. A field mask to restrict which fields on each person are returned.
         #   Multiple fields can be specified by separating them with commas. Valid values
-        #   are: * emailAddresses * names * phoneNumbers
+        #   are: * emailAddresses * metadata * names * phoneNumbers
         # @param [Boolean] request_sync_token
         #   Optional. Whether the response should include `next_sync_token`, which can be
         #   used to get all changes since the last request. For subsequent sync requests
@@ -369,8 +370,11 @@ module Google
         #   Optional. A sync token, received from a previous `ListOtherContacts` call.
         #   Provide this to retrieve only the resources changed since the last request.
         #   Sync requests that specify `sync_token` have an additional rate limit. When
-        #   syncing, all other parameters provided to `ListOtherContacts` must match the
-        #   call that provided the sync token.
+        #   the `syncToken` is specified, resources deleted since the last sync will be
+        #   returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
+        #   people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
+        #   is specified, all other parameters provided to `ListOtherContacts` must match
+        #   the call that provided the sync token.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -405,10 +409,12 @@ module Google
         # Provides a list of contacts in the authenticated user's other contacts that
         # matches the search query. The query matches on a contact's `names`, `
         # emailAddresses`, and `phoneNumbers` fields that are from the OTHER_CONTACT
-        # source.
+        # source. **IMPORTANT**: Before searching, clients should send a warmup request
+        # with an empty query to update the cache. See https://developers.google.com/
+        # people/v1/other-contacts#search_the_users_other_contacts
         # @param [Fixnum] page_size
         #   Optional. The number of results to return. Defaults to 10 if field is not set,
-        #   or set to 0.
+        #   or set to 0. Values greater than 10 will be capped to 10.
         # @param [String] query
         #   Required. The plain-text query for the request. The query is used to match
         #   prefix phrases of the fields on a person. For example, a person with name "foo
@@ -417,7 +423,7 @@ module Google
         # @param [String] read_mask
         #   Required. A field mask to restrict which fields on each person are returned.
         #   Multiple fields can be specified by separating them with commas. Valid values
-        #   are: * emailAddresses * names * phoneNumbers
+        #   are: * emailAddresses * metadata * names * phoneNumbers
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -739,8 +745,8 @@ module Google
         #   specify `people/me`. - To get information about a google account, specify `
         #   people/`account_id``. - To get information about a contact, specify the
         #   resource name that identifies the contact as returned by [`people.connections.
-        #   list`](/people/api/rest/v1/people.connections/list). You can include up to 50
-        #   resource names in one request.
+        #   list`](/people/api/rest/v1/people.connections/list). There is a maximum of 200
+        #   resource names.
         # @param [Array<String>, String] sources
         #   Optional. A mask of what source types to return. Defaults to
         #   READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
@@ -842,9 +848,12 @@ module Google
         # Provides a list of contacts in the authenticated user's grouped contacts that
         # matches the search query. The query matches on a contact's `names`, `nickNames`
         # , `emailAddresses`, `phoneNumbers`, and `organizations` fields that are from
-        # the CONTACT" source.
+        # the CONTACT" source. **IMPORTANT**: Before searching, clients should send a
+        # warmup request with an empty query to update the cache. See https://developers.
+        # google.com/people/v1/contacts#search_the_users_contacts
         # @param [Fixnum] page_size
-        #   Optional. The number of results to return.
+        #   Optional. The number of results to return. Defaults to 10 if field is not set,
+        #   or set to 0. Values greater than 10 will be capped to 10.
         # @param [String] query
         #   Required. The plain-text query for the request. The query is used to match
         #   prefix phrases of the fields on a person. For example, a person with name "foo
@@ -858,6 +867,9 @@ module Google
         #   imClients * interests * locales * locations * memberships * metadata *
         #   miscKeywords * names * nicknames * occupations * organizations * phoneNumbers *
         #   photos * relations * sipAddresses * skills * urls * userDefined
+        # @param [Array<String>, String] sources
+        #   Optional. A mask of what source types to return. Defaults to
+        #   READ_SOURCE_TYPE_CONTACT if not set.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -875,13 +887,14 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def search_person_contacts(page_size: nil, query: nil, read_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def search_person_contacts(page_size: nil, query: nil, read_mask: nil, sources: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/people:searchContacts', options)
           command.response_representation = Google::Apis::PeopleV1::SearchResponse::Representation
           command.response_class = Google::Apis::PeopleV1::SearchResponse
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['query'] = query unless query.nil?
           command.query['readMask'] = read_mask unless read_mask.nil?
+          command.query['sources'] = sources unless sources.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1093,7 +1106,10 @@ module Google
         # @param [String] sync_token
         #   Optional. A sync token, received from a previous `ListConnections` call.
         #   Provide this to retrieve only the resources changed since the last request.
-        #   When syncing, all other parameters provided to `ListConnections` except `
+        #   When the `syncToken` is specified, resources deleted since the last sync will
+        #   be returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
+        #   people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
+        #   is specified, all other parameters provided to `ListConnections` except `
         #   page_size` and `page_token` must match the initial call that provided the sync
         #   token. Sync tokens expire after seven days, after which a full sync request
         #   without a `sync_token` should be made.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-people_v1
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-05 00:00:00.000000000 Z
+date: 2021-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.8.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.13.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1
 post_install_message: 
 rdoc_options: []
@@ -69,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: Simple REST client for People API V1