google-apis-people_v1 0.13.0 → 0.17.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 364e27c9c4f7b5a658554ccdc4d19346370f14bfcb0dcbdaf2d57d093a2a1d26
4
- data.tar.gz: 158d7d594f94fdb1db990aa51869b7873b69fc5809bc12b64ae7bafdfd432d60
3
+ metadata.gz: e342b31e596b78efef9822c31b11e39f21be7c7988a7a830ec0ae454d9a7a8ef
4
+ data.tar.gz: bbe8539726d3bbd045716d9fc58b4b6f749b882aa7d5b6bf23db0b452631ea47
5
5
  SHA512:
6
- metadata.gz: 0aaef8be1d2fac55715dc34bcf00809b0541ebf577a027a41a926956551e109ce0d1ae57877040dbd76b668cb993bf2bce467ef443f4895f6b54034ff8e550f7
7
- data.tar.gz: ca30bbcae67a6d76ff287a2dd3b7588059d8143040f8b3fdf89fe05fe243cf2b9bfd0d6542883866588ef046de3ed5708b879e7420f8b990810adebdacdcbcdd
6
+ metadata.gz: e8403207f0cd54183aaa93287189a4bec73cb92dffc20e2bd5cfd4538341eafb63329c10815f1bfeadd0cee4d030e21f9b433c0ff67582aadc42e9ef2580b751
7
+ data.tar.gz: f1b4ccf1d623f7836f2a505588dfd519543d17026a0b57da8adeecc93985c8769624002c47ab054ad895772866d84c8423d2103c2b8eb27d94c2ef9871d13a34
data/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Release history for google-apis-people_v1
2
2
 
3
+ ### v0.17.0 (2021-07-22)
4
+
5
+ * Regenerated from discovery document revision 20210720
6
+
7
+ ### v0.16.0 (2021-07-16)
8
+
9
+ * Regenerated from discovery document revision 20210714
10
+
11
+ ### v0.15.0 (2021-06-29)
12
+
13
+ * Regenerated using generator version 0.4.0
14
+
15
+ ### v0.14.0 (2021-06-25)
16
+
17
+ * Regenerated from discovery document revision 20210623
18
+
3
19
  ### v0.13.0 (2021-06-19)
4
20
 
5
21
  * Regenerated from discovery document revision 20210617
@@ -522,7 +522,10 @@ module Google
522
522
  attr_accessor :metadata
523
523
 
524
524
  # The contact group name set by the group owner or a system provided name for
525
- # system groups.
525
+ # system groups. For [`contactGroups.create`](/people/api/rest/v1/contactGroups/
526
+ # create) or [`contactGroups.update`](/people/api/rest/v1/contactGroups/update)
527
+ # the name must be unique to the users contact groups. Attempting to create a
528
+ # group with a duplicate name will return a HTTP 409 error.
526
529
  # Corresponds to the JSON property `name`
527
530
  # @return [String]
528
531
  attr_accessor :name
@@ -1002,8 +1005,7 @@ module Google
1002
1005
  class FieldMetadata
1003
1006
  include Google::Apis::Core::Hashable
1004
1007
 
1005
- # True if the field is the primary field; false if the field is a secondary
1006
- # field.
1008
+ # True if the field is the primary field for the person.
1007
1009
  # Corresponds to the JSON property `primary`
1008
1010
  # @return [Boolean]
1009
1011
  attr_accessor :primary
@@ -1014,6 +1016,12 @@ module Google
1014
1016
  # @return [Google::Apis::PeopleV1::Source]
1015
1017
  attr_accessor :source
1016
1018
 
1019
+ # True if the field is the primary field for the source.
1020
+ # Corresponds to the JSON property `sourcePrimary`
1021
+ # @return [Boolean]
1022
+ attr_accessor :source_primary
1023
+ alias_method :source_primary?, :source_primary
1024
+
1017
1025
  # Output only. True if the field is verified; false if the field is unverified.
1018
1026
  # A verified field is typically a name, email address, phone number, or website
1019
1027
  # that has been confirmed to be owned by the person.
@@ -1030,6 +1038,7 @@ module Google
1030
1038
  def update!(**args)
1031
1039
  @primary = args[:primary] if args.key?(:primary)
1032
1040
  @source = args[:source] if args.key?(:source)
1041
+ @source_primary = args[:source_primary] if args.key?(:source_primary)
1033
1042
  @verified = args[:verified] if args.key?(:verified)
1034
1043
  end
1035
1044
  end
@@ -1931,12 +1940,9 @@ module Google
1931
1940
  # @return [Array<Google::Apis::PeopleV1::CoverPhoto>]
1932
1941
  attr_accessor :cover_photos
1933
1942
 
1934
- # The person's email addresses. For [`connections.list`](/people/api/rest/v1/
1935
- # people.connections/list), [`otherContacts.list`](/people/api/rest/v1/
1936
- # otherContacts/list), and [`people.listDirectoryPeople`](/people/api/rest/v1/
1937
- # people/listDirectoryPeople) the number of email addresses is limited to 100.
1938
- # If a Person has more email addresses the entire set can be obtained by calling
1939
- # ['people.get'](/people/api/rest/v1/people/get).
1943
+ # The person's email addresses. For `people.connections.list` and `otherContacts.
1944
+ # list` the number of email addresses is limited to 100. If a Person has more
1945
+ # email addresses the entire set can be obtained by calling GetPeople.
1940
1946
  # Corresponds to the JSON property `emailAddresses`
1941
1947
  # @return [Array<Google::Apis::PeopleV1::EmailAddress>]
1942
1948
  attr_accessor :email_addresses
@@ -2022,12 +2028,9 @@ module Google
2022
2028
  # @return [Array<Google::Apis::PeopleV1::Organization>]
2023
2029
  attr_accessor :organizations
2024
2030
 
2025
- # The person's phone numbers. For [`connections.list`](/people/api/rest/v1/
2026
- # people.connections/list), [`otherContacts.list`](/people/api/rest/v1/
2027
- # otherContacts/list), and [`people.listDirectoryPeople`](/people/api/rest/v1/
2028
- # people/listDirectoryPeople) the number of phone numbers is limited to 100. If
2029
- # a Person has more phone numbers the entire set can be obtained by calling ['
2030
- # people.get'](/people/api/rest/v1/people/get).
2031
+ # The person's phone numbers. For `people.connections.list` and `otherContacts.
2032
+ # list` the number of phone numbers is limited to 100. If a Person has more
2033
+ # phone numbers the entire set can be obtained by calling GetPeople.
2031
2034
  # Corresponds to the JSON property `phoneNumbers`
2032
2035
  # @return [Array<Google::Apis::PeopleV1::PhoneNumber>]
2033
2036
  attr_accessor :phone_numbers
@@ -2142,10 +2145,8 @@ module Google
2142
2145
  class PersonMetadata
2143
2146
  include Google::Apis::Core::Hashable
2144
2147
 
2145
- # Output only. True if the person resource has been deleted. Populated only for [
2146
- # `connections.list`](/people/api/rest/v1/people.connections/list) and [`
2147
- # otherContacts.list`](/people/api/rest/v1/otherContacts/list) requests that
2148
- # include a sync token.
2148
+ # Output only. True if the person resource has been deleted. Populated only for `
2149
+ # people.connections.list` and `otherContacts.list` sync requests.
2149
2150
  # Corresponds to the JSON property `deleted`
2150
2151
  # @return [Boolean]
2151
2152
  attr_accessor :deleted
@@ -2163,10 +2164,9 @@ module Google
2163
2164
  attr_accessor :object_type
2164
2165
 
2165
2166
  # Output only. Any former resource names this person has had. Populated only for
2166
- # [`connections.list`](/people/api/rest/v1/people.connections/list) requests
2167
- # that include a sync token. The resource name may change when adding or
2168
- # removing fields that link a contact and profile such as a verified email,
2169
- # verified phone number, or profile URL.
2167
+ # `people.connections.list` requests that include a sync token. The resource
2168
+ # name may change when adding or removing fields that link a contact and profile
2169
+ # such as a verified email, verified phone number, or profile URL.
2170
2170
  # Corresponds to the JSON property `previousResourceNames`
2171
2171
  # @return [Array<String>]
2172
2172
  attr_accessor :previous_resource_names
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module PeopleV1
18
18
  # Version of the google-apis-people_v1 gem
19
- GEM_VERSION = "0.13.0"
19
+ GEM_VERSION = "0.17.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.3.0"
22
+ GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210617"
25
+ REVISION = "20210720"
26
26
  end
27
27
  end
28
28
  end
@@ -736,6 +736,7 @@ module Google
736
736
  property :primary, as: 'primary'
737
737
  property :source, as: 'source', class: Google::Apis::PeopleV1::Source, decorator: Google::Apis::PeopleV1::Source::Representation
738
738
 
739
+ property :source_primary, as: 'sourcePrimary'
739
740
  property :verified, as: 'verified'
740
741
  end
741
742
  end
@@ -91,7 +91,9 @@ module Google
91
91
  execute_or_queue_command(command, &block)
92
92
  end
93
93
 
94
- # Create a new contact group owned by the authenticated user.
94
+ # Create a new contact group owned by the authenticated user. Created contact
95
+ # group names must be unique to the users contact groups. Attempting to create a
96
+ # group with a duplicate name will return a HTTP 409 error.
95
97
  # @param [Google::Apis::PeopleV1::CreateContactGroupRequest] create_contact_group_request_object
96
98
  # @param [String] fields
97
99
  # Selector specifying which fields to include in a partial response.
@@ -244,6 +246,9 @@ module Google
244
246
  end
245
247
 
246
248
  # Update the name of an existing contact group owned by the authenticated user.
249
+ # Updated contact group names must be unique to the users contact groups.
250
+ # Attempting to create a group with a duplicate name will return a HTTP 409
251
+ # error.
247
252
  # @param [String] resource_name
248
253
  # The resource name for the contact group, assigned by the server. An ASCII
249
254
  # string, in the form of `contactGroups/`contact_group_id``.
@@ -347,34 +352,46 @@ module Google
347
352
  end
348
353
 
349
354
  # List all "Other contacts", that is contacts that are not in a contact group. "
350
- # Other contacts" are typically auto created contacts from interactions.
355
+ # Other contacts" are typically auto created contacts from interactions. Sync
356
+ # tokens expire 7 days after the full sync. A request with an expired sync token
357
+ # will result in a 410 error. In the case of such an error clients should make a
358
+ # full sync request without a `sync_token`. The first page of a full sync
359
+ # request has an additional quota. If the quota is exceeded, a 429 error will be
360
+ # returned. This quota is fixed and can not be increased. When the `sync_token`
361
+ # is specified, resources deleted since the last sync will be returned as a
362
+ # person with `PersonMetadata.deleted` set to true. When the `page_token` or `
363
+ # sync_token` is specified, all other request parameters must match the first
364
+ # call. Writes may have a propagation delay of several minutes for sync requests.
365
+ # Incremental syncs are not intended for read-after-write use cases. See
366
+ # example usage at [List the user's other contacts that have changed](/people/v1/
367
+ # other-contacts#list_the_users_other_contacts_that_have_changed).
351
368
  # @param [Fixnum] page_size
352
369
  # Optional. The number of "Other contacts" to include in the response. Valid
353
370
  # values are between 1 and 1000, inclusive. Defaults to 100 if not set or set to
354
371
  # 0.
355
372
  # @param [String] page_token
356
- # Optional. A page token, received from a previous `ListOtherContacts` call.
373
+ # Optional. A page token, received from a previous response `next_page_token`.
357
374
  # Provide this to retrieve the subsequent page. When paginating, all other
358
- # parameters provided to `ListOtherContacts` must match the call that provided
359
- # the page token.
375
+ # parameters provided to `otherContacts.list` must match the first call that
376
+ # provided the page token.
360
377
  # @param [String] read_mask
361
378
  # Required. A field mask to restrict which fields on each person are returned.
362
379
  # Multiple fields can be specified by separating them with commas. Valid values
363
- # are: * emailAddresses * metadata * names * phoneNumbers
380
+ # are: * emailAddresses * metadata * names * phoneNumbers * photos
364
381
  # @param [Boolean] request_sync_token
365
- # Optional. Whether the response should include `next_sync_token`, which can be
366
- # used to get all changes since the last request. For subsequent sync requests
367
- # use the `sync_token` param instead. Initial sync requests that specify `
368
- # request_sync_token` have an additional rate limit.
382
+ # Optional. Whether the response should return `next_sync_token` on the last
383
+ # page of results. It can be used to get incremental changes since the last
384
+ # request by setting it on the request `sync_token`. More details about sync
385
+ # behavior at `otherContacts.list`.
386
+ # @param [Array<String>, String] sources
387
+ # Optional. A mask of what source types to return. Defaults to
388
+ # READ_SOURCE_TYPE_CONTACT if not set.
369
389
  # @param [String] sync_token
370
- # Optional. A sync token, received from a previous `ListOtherContacts` call.
390
+ # Optional. A sync token, received from a previous response `next_sync_token`
371
391
  # Provide this to retrieve only the resources changed since the last request.
372
- # Sync requests that specify `sync_token` have an additional rate limit. When
373
- # the `syncToken` is specified, resources deleted since the last sync will be
374
- # returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
375
- # people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
376
- # is specified, all other parameters provided to `ListOtherContacts` must match
377
- # the call that provided the sync token.
392
+ # When syncing, all other parameters provided to `otherContacts.list` must match
393
+ # the first call that provided the sync token. More details about sync behavior
394
+ # at `otherContacts.list`.
378
395
  # @param [String] fields
379
396
  # Selector specifying which fields to include in a partial response.
380
397
  # @param [String] quota_user
@@ -392,7 +409,7 @@ module Google
392
409
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
393
410
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
394
411
  # @raise [Google::Apis::AuthorizationError] Authorization is required
395
- def list_other_contacts(page_size: nil, page_token: nil, read_mask: nil, request_sync_token: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block)
412
+ def list_other_contacts(page_size: nil, page_token: nil, read_mask: nil, request_sync_token: nil, sources: nil, sync_token: nil, fields: nil, quota_user: nil, options: nil, &block)
396
413
  command = make_simple_command(:get, 'v1/otherContacts', options)
397
414
  command.response_representation = Google::Apis::PeopleV1::ListOtherContactsResponse::Representation
398
415
  command.response_class = Google::Apis::PeopleV1::ListOtherContactsResponse
@@ -400,6 +417,7 @@ module Google
400
417
  command.query['pageToken'] = page_token unless page_token.nil?
401
418
  command.query['readMask'] = read_mask unless read_mask.nil?
402
419
  command.query['requestSyncToken'] = request_sync_token unless request_sync_token.nil?
420
+ command.query['sources'] = sources unless sources.nil?
403
421
  command.query['syncToken'] = sync_token unless sync_token.nil?
404
422
  command.query['fields'] = fields unless fields.nil?
405
423
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -414,7 +432,7 @@ module Google
414
432
  # people/v1/other-contacts#search_the_users_other_contacts
415
433
  # @param [Fixnum] page_size
416
434
  # Optional. The number of results to return. Defaults to 10 if field is not set,
417
- # or set to 0. Values greater than 10 will be capped to 10.
435
+ # or set to 0. Values greater than 30 will be capped to 30.
418
436
  # @param [String] query
419
437
  # Required. The plain-text query for the request. The query is used to match
420
438
  # prefix phrases of the fields on a person. For example, a person with name "foo
@@ -676,8 +694,7 @@ module Google
676
694
  # get information about the authenticated user, specify `people/me`. - To get
677
695
  # information about a google account, specify `people/`account_id``. - To get
678
696
  # information about a contact, specify the resource name that identifies the
679
- # contact as returned by [`people.connections.list`](/people/api/rest/v1/people.
680
- # connections/list).
697
+ # contact as returned by `people.connections.list`.
681
698
  # @param [String] person_fields
682
699
  # Required. A field mask to restrict which fields on the person are returned.
683
700
  # Multiple fields can be specified by separating them with commas. Valid values
@@ -744,9 +761,8 @@ module Google
744
761
  # resourceNames=<name2>&... - To get information about the authenticated user,
745
762
  # specify `people/me`. - To get information about a google account, specify `
746
763
  # people/`account_id``. - To get information about a contact, specify the
747
- # resource name that identifies the contact as returned by [`people.connections.
748
- # list`](/people/api/rest/v1/people.connections/list). There is a maximum of 200
749
- # resource names.
764
+ # resource name that identifies the contact as returned by `people.connections.
765
+ # list`. There is a maximum of 200 resource names.
750
766
  # @param [Array<String>, String] sources
751
767
  # Optional. A mask of what source types to return. Defaults to
752
768
  # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
@@ -781,7 +797,14 @@ module Google
781
797
  end
782
798
 
783
799
  # Provides a list of domain profiles and domain contacts in the authenticated
784
- # user's domain directory.
800
+ # user's domain directory. When the `sync_token` is specified, resources deleted
801
+ # since the last sync will be returned as a person with `PersonMetadata.deleted`
802
+ # set to true. When the `page_token` or `sync_token` is specified, all other
803
+ # request parameters must match the first call. Writes may have a propagation
804
+ # delay of several minutes for sync requests. Incremental syncs are not intended
805
+ # for read-after-write use cases. See example usage at [List the directory
806
+ # people that have changed](/people/v1/directory#
807
+ # list_the_directory_people_that_have_changed).
785
808
  # @param [Array<String>, String] merge_sources
786
809
  # Optional. Additional data to merge into the directory sources if they are
787
810
  # connected through verified join keys such as email addresses or phone numbers.
@@ -789,10 +812,10 @@ module Google
789
812
  # Optional. The number of people to include in the response. Valid values are
790
813
  # between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.
791
814
  # @param [String] page_token
792
- # Optional. A page token, received from a previous `ListDirectoryPeople` call.
815
+ # Optional. A page token, received from a previous response `next_page_token`.
793
816
  # Provide this to retrieve the subsequent page. When paginating, all other
794
- # parameters provided to `ListDirectoryPeople` must match the call that provided
795
- # the page token.
817
+ # parameters provided to `people.listDirectoryPeople` must match the first call
818
+ # that provided the page token.
796
819
  # @param [String] read_mask
797
820
  # Required. A field mask to restrict which fields on each person are returned.
798
821
  # Multiple fields can be specified by separating them with commas. Valid values
@@ -802,16 +825,17 @@ module Google
802
825
  # miscKeywords * names * nicknames * occupations * organizations * phoneNumbers *
803
826
  # photos * relations * sipAddresses * skills * urls * userDefined
804
827
  # @param [Boolean] request_sync_token
805
- # Optional. Whether the response should include `next_sync_token`, which can be
806
- # used to get all changes since the last request. For subsequent sync requests
807
- # use the `sync_token` param instead.
828
+ # Optional. Whether the response should return `next_sync_token`. It can be used
829
+ # to get incremental changes since the last request by setting it on the request
830
+ # `sync_token`. More details about sync behavior at `people.listDirectoryPeople`.
808
831
  # @param [Array<String>, String] sources
809
832
  # Required. Directory sources to return.
810
833
  # @param [String] sync_token
811
- # Optional. A sync token, received from a previous `ListDirectoryPeople` call.
834
+ # Optional. A sync token, received from a previous response `next_sync_token`
812
835
  # Provide this to retrieve only the resources changed since the last request.
813
- # When syncing, all other parameters provided to `ListDirectoryPeople` must
814
- # match the call that provided the sync token.
836
+ # When syncing, all other parameters provided to `people.listDirectoryPeople`
837
+ # must match the first call that provided the sync token. More details about
838
+ # sync behavior at `people.listDirectoryPeople`.
815
839
  # @param [String] fields
816
840
  # Selector specifying which fields to include in a partial response.
817
841
  # @param [String] quota_user
@@ -853,7 +877,7 @@ module Google
853
877
  # google.com/people/v1/contacts#search_the_users_contacts
854
878
  # @param [Fixnum] page_size
855
879
  # Optional. The number of results to return. Defaults to 10 if field is not set,
856
- # or set to 0. Values greater than 10 will be capped to 10.
880
+ # or set to 0. Values greater than 30 will be capped to 30.
857
881
  # @param [String] query
858
882
  # Required. The plain-text query for the request. The query is used to match
859
883
  # prefix phrases of the fields on a person. For example, a person with name "foo
@@ -909,9 +933,9 @@ module Google
909
933
  # Optional. The number of people to include in the response. Valid values are
910
934
  # between 1 and 500, inclusive. Defaults to 100 if not set or set to 0.
911
935
  # @param [String] page_token
912
- # Optional. A page token, received from a previous `SearchDirectoryPeople` call.
936
+ # Optional. A page token, received from a previous response `next_page_token`.
913
937
  # Provide this to retrieve the subsequent page. When paginating, all other
914
- # parameters provided to `SearchDirectoryPeople` must match the call that
938
+ # parameters provided to `SearchDirectoryPeople` must match the first call that
915
939
  # provided the page token.
916
940
  # @param [String] query
917
941
  # Required. Prefix query that matches fields in the person. Does NOT use the
@@ -1060,12 +1084,19 @@ module Google
1060
1084
  execute_or_queue_command(command, &block)
1061
1085
  end
1062
1086
 
1063
- # Provides a list of the authenticated user's contacts. The request returns a
1064
- # 400 error if `personFields` is not specified. The request returns a 410 error
1065
- # if `sync_token` is specified and is expired. Sync tokens expire after 7 days
1066
- # to prevent data drift between clients and the server. To handle a sync token
1067
- # expired error, a request should be sent without `sync_token` to get all
1068
- # contacts.
1087
+ # Provides a list of the authenticated user's contacts. Sync tokens expire 7
1088
+ # days after the full sync. A request with an expired sync token will result in
1089
+ # a 410 error. In the case of such an error clients should make a full sync
1090
+ # request without a `sync_token`. The first page of a full sync request has an
1091
+ # additional quota. If the quota is exceeded, a 429 error will be returned. This
1092
+ # quota is fixed and can not be increased. When the `sync_token` is specified,
1093
+ # resources deleted since the last sync will be returned as a person with `
1094
+ # PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is
1095
+ # specified, all other request parameters must match the first call. Writes may
1096
+ # have a propagation delay of several minutes for sync requests. Incremental
1097
+ # syncs are not intended for read-after-write use cases. See example usage at [
1098
+ # List the user's contacts that have changed](/people/v1/contacts#
1099
+ # list_the_users_contacts_that_have_changed).
1069
1100
  # @param [String] resource_name
1070
1101
  # Required. The resource name to return connections for. Only `people/me` is
1071
1102
  # valid.
@@ -1073,10 +1104,10 @@ module Google
1073
1104
  # Optional. The number of connections to include in the response. Valid values
1074
1105
  # are between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.
1075
1106
  # @param [String] page_token
1076
- # Optional. A page token, received from a previous `ListConnections` call.
1107
+ # Optional. A page token, received from a previous response `next_page_token`.
1077
1108
  # Provide this to retrieve the subsequent page. When paginating, all other
1078
- # parameters provided to `ListConnections` must match the call that provided the
1079
- # page token.
1109
+ # parameters provided to `people.connections.list` must match the first call
1110
+ # that provided the page token.
1080
1111
  # @param [String] person_fields
1081
1112
  # Required. A field mask to restrict which fields on each person are returned.
1082
1113
  # Multiple fields can be specified by separating them with commas. Valid values
@@ -1090,13 +1121,10 @@ module Google
1090
1121
  # Each path should start with `person.`: for example, `person.names` or `person.
1091
1122
  # photos`.
1092
1123
  # @param [Boolean] request_sync_token
1093
- # Optional. Whether the response should include `next_sync_token` on the last
1094
- # page, which can be used to get all changes since the last request. For
1095
- # subsequent sync requests use the `sync_token` param instead. Initial full sync
1096
- # requests that specify `request_sync_token` and do not specify `sync_token`
1097
- # have an additional rate limit per user. Each client should generally only be
1098
- # doing a full sync once every few days per user and so should not hit this
1099
- # limit.
1124
+ # Optional. Whether the response should return `next_sync_token` on the last
1125
+ # page of results. It can be used to get incremental changes since the last
1126
+ # request by setting it on the request `sync_token`. More details about sync
1127
+ # behavior at `people.connections.list`.
1100
1128
  # @param [String] sort_order
1101
1129
  # Optional. The order in which the connections should be sorted. Defaults to `
1102
1130
  # LAST_MODIFIED_ASCENDING`.
@@ -1104,15 +1132,11 @@ module Google
1104
1132
  # Optional. A mask of what source types to return. Defaults to
1105
1133
  # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
1106
1134
  # @param [String] sync_token
1107
- # Optional. A sync token, received from a previous `ListConnections` call.
1135
+ # Optional. A sync token, received from a previous response `next_sync_token`
1108
1136
  # Provide this to retrieve only the resources changed since the last request.
1109
- # When the `syncToken` is specified, resources deleted since the last sync will
1110
- # be returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
1111
- # people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
1112
- # is specified, all other parameters provided to `ListConnections` except `
1113
- # page_size` and `page_token` must match the initial call that provided the sync
1114
- # token. Sync tokens expire after seven days, after which a full sync request
1115
- # without a `sync_token` should be made.
1137
+ # When syncing, all other parameters provided to `people.connections.list` must
1138
+ # match the first call that provided the sync token. More details about sync
1139
+ # behavior at `people.connections.list`.
1116
1140
  # @param [String] fields
1117
1141
  # Selector specifying which fields to include in a partial response.
1118
1142
  # @param [String] quota_user
metadata CHANGED
@@ -1,29 +1,35 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-people_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.0
4
+ version: 0.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-06-21 00:00:00.000000000 Z
11
+ date: 2021-07-26 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - "~>"
17
+ - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.1'
19
+ version: '0.4'
20
+ - - "<"
21
+ - !ruby/object:Gem::Version
22
+ version: 2.a
20
23
  type: :runtime
21
24
  prerelease: false
22
25
  version_requirements: !ruby/object:Gem::Requirement
23
26
  requirements:
24
- - - "~>"
27
+ - - ">="
28
+ - !ruby/object:Gem::Version
29
+ version: '0.4'
30
+ - - "<"
25
31
  - !ruby/object:Gem::Version
26
- version: '0.1'
32
+ version: 2.a
27
33
  description: This is the simple REST client for People API V1. Simple REST clients
28
34
  are Ruby client libraries that provide access to Google services via their HTTP
29
35
  REST API endpoints. These libraries are generated and updated automatically based
@@ -52,7 +58,7 @@ licenses:
52
58
  metadata:
53
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
54
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1/CHANGELOG.md
55
- documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.13.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-people_v1/v0.17.0
56
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-people_v1
57
63
  post_install_message:
58
64
  rdoc_options: []