google-apis-people_v1 0.21.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33cec8d8374f797235ce49a5a85847d9e82e9ca9759e5b1a698f3ce09a8fc5f6
-  data.tar.gz: 42b3067c5daba1abceb320eeacfb299acf00d463c336005c331ff56c2f1c5784
+  metadata.gz: c0fe71dab8936eabcd3dbfe3991c05e7bb506498dd96831b5f8c6685703121e2
+  data.tar.gz: 1433faf94622b1ecdf2450d790e71c9e600e09ee6ac7e1fae9f3bdcf9a7fa137
 SHA512:
-  metadata.gz: 181fab9eb9d59816f4b62d1c0a9e25b46d2f7de03062bb1b35e00328e0804f5c6eac8aaf763ae582594e32df31294b266a8224b08a89bc822daf1b15587a5203
-  data.tar.gz: 2e6731b34479d3ca78f4187e62e9446fb7951d68e07384ddf3156bea6ac7c4c984419412eec95aae17823b6e3ddd52af203b4be0be71608dcf327d0ced6b3a67
+  metadata.gz: 1015557b1156f4d6cbca50aab5368fa2f11cf5a62086946cdbc97826ab5cd7d081506d572c129c4cfe7d35ed97db5eb17439862410053bed90793a923bd05099
+  data.tar.gz: e242f691234d4cad7eb6f4cb0a0cc9049c858dc9c4bd8b6b70b7ef7eb9ad870d7cd0dcb059d81110e40bb94ecf398580c80f9213c2c9852b80ed32f7139da5ee

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-people_v1
 
+### 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
+
+### v0.22.0 (2021-10-21)
+
+* Unspecified changes
+
 ### v0.21.0 (2021-09-07)
 
 * Regenerated from discovery document revision 20210903

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/people_v1"
 client = Google::Apis::PeopleV1::PeopleServiceService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the People service in particular.)
 

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

@@ -346,7 +346,8 @@ 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
       
@@ -354,10 +355,10 @@ module Google
         # 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`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., 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
@@ -779,10 +781,10 @@ module Google
       # 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`.
+      # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+      # zero month and a zero day * A year and month, with a zero day (e.g., a credit
+      # card expiration date) Related types: * google.type.TimeOfDay * google.type.
+      # DateTime * google.protobuf.Timestamp
       class Date
         include Google::Apis::Core::Hashable
       
@@ -928,10 +930,10 @@ module Google
         # 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`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., 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
@@ -1807,10 +1809,10 @@ module Google
         # 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`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., 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
@@ -1856,10 +1858,10 @@ module Google
         # 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`.
+        # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
+        # zero month and a zero day * A year and month, with a zero day (e.g., 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.21.0"
+      GEM_VERSION = "0.25.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 = "20220202"
     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.21.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-13 00:00:00.000000000 Z
+date: 2022-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 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.21.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1
+  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.25.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-people_v1
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: Simple REST client for People API V1