google-apis-people_v1 0.23.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6a2ae9aba2057301a29fe8e5e856dbe018e4408c5cce4f667bdd27e7c4a3a72
-  data.tar.gz: ed17171947a1ffc08591059d4f46863b99eac38cc74979ac89d3c9a359606d01
+  metadata.gz: 9e05ebb6d8382219b5c5400e840bf127ec36439d82c748625ed4077785e0e4d8
+  data.tar.gz: ba1a63b4a9fba53afc398dfd35a19b5db37bfee9b24e399f719a39789f0bbd73
 SHA512:
-  metadata.gz: 5b9f8f1d9ce97c1afa855429a46b9fb0a4413132ac70a48978c547f8ae7dda70fe1c2350f06912747f22319f652bc712150cd4f6a611370261eb8952537f202a
-  data.tar.gz: 2e77142e4e745c14b84a63bcdea0a3b53b9f4ea66ebce4d93d3a4604351b01d4e514063966237b6dfdf0dac6a63ee7d26f612ec251949f9ecd95bfb8707f9251
+  metadata.gz: cbbd9b7e6b8ae2f1bf8308c783250bd517675dfa73d9deb8befaccdfa6b7f274c368ebaf7a6874d5c6ed4ef53fe0e68f281fbe265fbd03a5c484d6fdfe2d3261
+  data.tar.gz: 4a7e1ef7ef5c3a5812f6b68e43ddb8d188db48d2312516ec8b4d3cad885ee7deee485e31c8d1d24fd679d49bd7e372a699daab9c30ee1f6930686a41e89b187e

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Release history for google-apis-people_v1
 
+### v0.26.0 (2022-03-03)
+
+* Regenerated from discovery document revision 20220301
+
+### v0.25.0 (2022-02-04)
+
+* Regenerated from discovery document revision 20220202
+
+### v0.24.0 (2022-01-13)
+
+* Regenerated from discovery document revision 20220111
+* Regenerated using generator version 0.4.1
+
 ### v0.23.0 (2021-12-14)
 
 * Unspecified changes

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

@@ -346,18 +346,19 @@ module Google
       
       # 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.
+      # are not guaranteed to. Clients should always set the `date` field when
+      # mutating birthdays.
       class Birthday
         include Google::Apis::Core::Hashable
       
         # Represents a whole or partial calendar date, such as a birthday. The time of
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
-        # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `date`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :date
@@ -367,7 +368,8 @@ module Google
         # @return [Google::Apis::PeopleV1::FieldMetadata]
         attr_accessor :metadata
       
-        # A free-form string representing the user's birthday.
+        # Prefer to use the `date` field if set. A free-form string representing the
+        # user's birthday. This value is not validated.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -778,11 +780,11 @@ module Google
       # Represents a whole or partial calendar date, such as a birthday. The time of
       # day and time zone are either specified elsewhere or are insignificant. The
       # date is relative to the Gregorian Calendar. This can represent one of the
-      # following: * A full date, with non-zero year, month, and day values * A month
-      # and day value, with a zero year, such as an anniversary * A year on its own,
-      # with zero month and day values * A year and month value, with a zero day, such
-      # as a credit card expiration date Related types are google.type.TimeOfDay and `
-      # google.protobuf.Timestamp`.
+      # following: * A full date, with non-zero year, month, and day values. * A month
+      # and day, with a zero year (for example, an anniversary). * A year on its own,
+      # with a zero month and a zero day. * A year and month, with a zero day (for
+      # example, a credit card expiration date). Related types: * google.type.
+      # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
       class Date
         include Google::Apis::Core::Hashable
       
@@ -927,11 +929,11 @@ module Google
         # Represents a whole or partial calendar date, such as a birthday. The time of
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
-        # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `date`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :date
@@ -1806,11 +1808,11 @@ module Google
         # Represents a whole or partial calendar date, such as a birthday. The time of
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
-        # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `endDate`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :end_date
@@ -1855,11 +1857,11 @@ module Google
         # Represents a whole or partial calendar date, such as a birthday. The time of
         # day and time zone are either specified elsewhere or are insignificant. The
         # date is relative to the Gregorian Calendar. This can represent one of the
-        # following: * A full date, with non-zero year, month, and day values * A month
-        # and day value, with a zero year, such as an anniversary * A year on its own,
-        # with zero month and day values * A year and month value, with a zero day, such
-        # as a credit card expiration date Related types are google.type.TimeOfDay and `
-        # google.protobuf.Timestamp`.
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
         # Corresponds to the JSON property `startDate`
         # @return [Google::Apis::PeopleV1::Date]
         attr_accessor :start_date

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.23.0"
+      GEM_VERSION = "0.26.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.4.0"
+      GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210903"
+      REVISION = "20220301"
     end
   end
 end

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

@@ -93,7 +93,9 @@ module Google
         
         # 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.
+        # group with a duplicate name will return a HTTP 409 error. Mutate requests for
+        # the same user should be sent sequentially to avoid increased latency and
+        # failures.
         # @param [Google::Apis::PeopleV1::CreateContactGroupRequest] create_contact_group_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -124,7 +126,8 @@ module Google
         end
         
         # Delete an existing contact group owned by the authenticated user by specifying
-        # a contact group resource name.
+        # a contact group resource name. Mutate requests for the same user should be
+        # sent sequentially to avoid increased latency and failures.
         # @param [String] resource_name
         #   Required. The resource name of the contact group to delete.
         # @param [Boolean] delete_contacts
@@ -248,7 +251,8 @@ module Google
         # 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.
+        # error. Mutate requests for the same user should be sent sequentially to avoid
+        # increased latency and failures.
         # @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``.
@@ -319,6 +323,8 @@ module Google
         end
         
         # Copies an "Other contact" to a new contact in the user's "myContacts" group
+        # Mutate requests for the same user should be sent sequentially to avoid
+        # increased latency and failures.
         # @param [String] resource_name
         #   Required. The resource name of the "Other contact" to copy.
         # @param [Google::Apis::PeopleV1::CopyOtherContactToMyContactsGroupRequest] copy_other_contact_to_my_contacts_group_request_object
@@ -479,7 +485,8 @@ module Google
         end
         
         # Create a batch of new contacts and return the PersonResponses for the newly
-        # created contacts. Limited to 10 parallel requests per user.
+        # Mutate requests for the same user should be sent sequentially to avoid
+        # increased latency and failures.
         # @param [Google::Apis::PeopleV1::BatchCreateContactsRequest] batch_create_contacts_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -509,8 +516,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a batch of contacts. Any non-contact data will not be deleted. Limited
-        # to 10 parallel requests per user.
+        # Delete a batch of contacts. Any non-contact data will not be deleted. Mutate
+        # requests for the same user should be sent sequentially to avoid increased
+        # latency and failures.
         # @param [Google::Apis::PeopleV1::BatchDeleteContactsRequest] batch_delete_contacts_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -541,8 +549,8 @@ module Google
         end
         
         # Update a batch of contacts and return a map of resource names to
-        # PersonResponses for the updated contacts. Limited to 10 parallel requests per
-        # user.
+        # PersonResponses for the updated contacts. Mutate requests for the same user
+        # should be sent sequentially to avoid increased latency and failures.
         # @param [Google::Apis::PeopleV1::BatchUpdateContactsRequest] batch_update_contacts_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -575,7 +583,8 @@ module Google
         # Create a new contact and return the person resource for that contact. The
         # request returns a 400 error if more than one field is specified on a field
         # that is a singleton for contact sources: * biographies * birthdays * genders *
-        # names
+        # names Mutate requests for the same user should be sent sequentially to avoid
+        # increased latency and failures.
         # @param [Google::Apis::PeopleV1::Person] person_object
         # @param [String] person_fields
         #   Required. A field mask to restrict which fields on each person are returned.
@@ -619,7 +628,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a contact person. Any non-contact data will not be deleted.
+        # Delete a contact person. Any non-contact data will not be deleted. Mutate
+        # requests for the same user should be sent sequentially to avoid increased
+        # latency and failures.
         # @param [String] resource_name
         #   Required. The resource name of the contact to delete.
         # @param [String] fields
@@ -649,7 +660,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a contact's photo.
+        # Delete a contact's photo. Mutate requests for the same user should be done
+        # sequentially to avoid // lock contention.
         # @param [String] resource_name
         #   Required. The resource name of the contact whose photo will be deleted.
         # @param [String] person_fields
@@ -1001,7 +1013,8 @@ module Google
         # are being updated and there are no contact group memberships specified on the
         # person. The server returns a 400 error if more than one field is specified on
         # a field that is a singleton for contact sources: * biographies * birthdays *
-        # genders * names
+        # genders * names Mutate requests for the same user should be sent sequentially
+        # to avoid increased latency and failures.
         # @param [String] resource_name
         #   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``.
@@ -1058,7 +1071,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update a contact's photo.
+        # Update a contact's photo. Mutate requests for the same user should be sent
+        # sequentially to avoid increased latency and failures.
         # @param [String] resource_name
         #   Required. Person resource name
         # @param [Google::Apis::PeopleV1::UpdateContactPhotoRequest] update_contact_photo_request_object

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-people_v1
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-10 00:00:00.000000000 Z
+date: 2022-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,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/main/generated/google-apis-people_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.23.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.26.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-people_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: Simple REST client for People API V1