google-apis-people_v1 0.10.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 974ea5776f4d606a997d1b6e9a1de61d9f5126e380dab3080c9955bd944225db
-  data.tar.gz: 7e97bbcc9a6aa80229992578bbc746d707e4b31df904d6aa625283f120cdb4c7
+  metadata.gz: 1a829a70f027e2db31e93f798965dd0a3e27fd24fd95ca5c70507072e43cf2f4
+  data.tar.gz: 5b9715b37ae4fe75e239b2340986c1b3494d3621e70e3cf8c16ce80252e072cf
 SHA512:
-  metadata.gz: ff1dadf5713fb410decf4628e50aca4f82647117890db5954dedae9d01e6f7ca6b0355e0e02f45bb01b4c440d9359db97fa74a8513668281d18fd8b0724cf152
-  data.tar.gz: 5d940f30f966f0003f0b73de9a2367fb5c15d46de0edb1bd255877a68b4a845d1ead54a7ff256b89b885b2eb955f614dc28ac7b63609c542cee89ba5cf32de08
+  metadata.gz: 76e77c369c7dfac9dd99406109f7a695c2682549fdc85d0084ed07b4b5753148265daa1e1c158a5963579e37e40657820502b94554a3d34407e6c03870fe1527
+  data.tar.gz: 3b00c53345d8a03a17c7999cc1dddfeda671c8842acfa90f5e65a1b1d0e8e79e09e6215f9cd6550d24d4f00db47b4f7b2c04a0ee5cad8814b98b6238b165fe33

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Release history for google-apis-people_v1
 
+### v0.15.0 (2021-06-29)
+
+* Regenerated using generator version 0.4.0
+
+### v0.14.0 (2021-06-25)
+
+* Regenerated from discovery document revision 20210623
+
+### 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

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

@@ -522,7 +522,10 @@ module Google
         attr_accessor :metadata
       
         # The contact group name set by the group owner or a system provided name for
-        # system groups.
+        # system groups. For [`contactGroups.create`](/people/api/rest/v1/contactGroups/
+        # create) or [`contactGroups.update`](/people/api/rest/v1/contactGroups/update)
+        # the name must be unique to the users contact groups. Attempting to create a
+        # group with a duplicate name will return a HTTP 409 error.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -831,11 +834,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
@@ -1481,7 +1484,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
@@ -1931,7 +1934,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
@@ -2017,7 +2025,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
@@ -2133,7 +2146,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.10.0"
+      GEM_VERSION = "0.15.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.2.0"
+      GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210515"
+      REVISION = "20210623"
     end
   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
@@ -90,7 +91,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a new contact group owned by the authenticated user.
+        # Create a new contact group owned by the authenticated user. Created contact
+        # group names must be unique to the users contact groups. Attempting to create a
+        # group with a duplicate name will return a HTTP 409 error.
         # @param [Google::Apis::PeopleV1::CreateContactGroupRequest] create_contact_group_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -243,6 +246,9 @@ module Google
         end
         
         # Update the name of an existing contact group owned by the authenticated user.
+        # Updated contact group names must be unique to the users contact groups.
+        # Attempting to create a group with a duplicate name will return a HTTP 409
+        # error.
         # @param [String] resource_name
         #   The resource name for the contact group, assigned by the server. An ASCII
         #   string, in the form of `contactGroups/`contact_group_id``.
@@ -359,7 +365,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 * photos
         # @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 +375,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 +414,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. Values greater than 10 will be capped to 10.
+        #   or set to 0. Values greater than 30 will be capped to 30.
         # @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 +428,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 +750,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 200
-        #   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,10 +853,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. Defaults to 10 if field is not set,
-        #   or set to 0. Values greater than 10 will be capped to 10.
+        #   or set to 0. Values greater than 30 will be capped to 30.
         # @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
@@ -1098,7 +1111,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,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-people_v1
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-24 00:00:00.000000000 Z
+date: 2021-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 2.a
 description: This is the simple REST client for People API V1. Simple REST clients
   are Ruby client libraries that provide access to Google services via their HTTP
   REST API endpoints. These libraries are generated and updated automatically based
@@ -52,7 +58,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.10.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.15.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1
 post_install_message: 
 rdoc_options: []