@@ -352,37 +352,44 @@ def copy_other_contact_to_my_contacts_group(resource_name, copy_other_contact_to
352352 end
353353
354354 # List all "Other contacts", that is contacts that are not in a contact group. "
355- # 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. See example usage at [List the user's other contacts that have changed](/
365+ # people/v1/other-contacts#list_the_users_other_contacts_that_have_changed).
356366 # @param [Fixnum] page_size
357367 # Optional. The number of "Other contacts" to include in the response. Valid
358368 # values are between 1 and 1000, inclusive. Defaults to 100 if not set or set to
359369 # 0.
360370 # @param [String] page_token
361- # Optional. A page token, received from a previous `ListOtherContacts` call .
371+ # Optional. A page token, received from a previous response `next_page_token` .
362372 # Provide this to retrieve the subsequent page. When paginating, all other
363- # parameters provided to `ListOtherContacts ` must match the call that provided
364- # the page token.
373+ # parameters provided to `otherContacts.list ` must match the first call that
374+ # provided the page token.
365375 # @param [String] read_mask
366376 # Required. A field mask to restrict which fields on each person are returned.
367377 # Multiple fields can be specified by separating them with commas. Valid values
368378 # are: * emailAddresses * metadata * names * phoneNumbers * photos
369379 # @param [Boolean] request_sync_token
370- # Optional. Whether the response should include `next_sync_token`, which can be
371- # used to get all changes since the last request. For subsequent sync requests
372- # use the `sync_token` param instead. Initial sync requests that specify `
373- # request_sync_token` have an additional rate limit .
380+ # Optional. Whether the response should return `next_sync_token` on the last
381+ # page of results. It can be used to get incremental changes since the last
382+ # request by setting it on the request `sync_token`. More details about sync
383+ # behavior at `otherContacts.list` .
374384 # @param [Array<String>, String] sources
375385 # Optional. A mask of what source types to return. Defaults to
376386 # READ_SOURCE_TYPE_CONTACT if not set.
377387 # @param [String] sync_token
378- # Optional. A sync token, received from a previous `ListOtherContacts` call.
388+ # Optional. A sync token, received from a previous response `next_sync_token`
379389 # Provide this to retrieve only the resources changed since the last request.
380- # Sync requests that specify `sync_token` have an additional rate limit. When
381- # the `syncToken` is specified, resources deleted since the last sync will be
382- # returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
383- # people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
384- # is specified, all other parameters provided to `ListOtherContacts` must match
385- # the call that provided the sync token.
390+ # When syncing, all other parameters provided to `otherContacts.list` must match
391+ # the first call that provided the sync token. More details about sync behavior
392+ # at `otherContacts.list`.
386393 # @param [String] fields
387394 # Selector specifying which fields to include in a partial response.
388395 # @param [String] quota_user
@@ -685,8 +692,7 @@ def delete_person_contact_photo(resource_name, person_fields: nil, sources: nil,
685692 # get information about the authenticated user, specify `people/me`. - To get
686693 # information about a google account, specify `people/`account_id``. - To get
687694 # information about a contact, specify the resource name that identifies the
688- # contact as returned by [`people.connections.list`](/people/api/rest/v1/people.
689- # connections/list).
695+ # contact as returned by `people.connections.list`.
690696 # @param [String] person_fields
691697 # Required. A field mask to restrict which fields on the person are returned.
692698 # Multiple fields can be specified by separating them with commas. Valid values
@@ -753,9 +759,8 @@ def get_person(resource_name, person_fields: nil, request_mask_include_field: ni
753759 # resourceNames=<name2>&... - To get information about the authenticated user,
754760 # specify `people/me`. - To get information about a google account, specify `
755761 # people/`account_id``. - To get information about a contact, specify the
756- # resource name that identifies the contact as returned by [`people.connections.
757- # list`](/people/api/rest/v1/people.connections/list). There is a maximum of 200
758- # resource names.
762+ # resource name that identifies the contact as returned by `people.connections.
763+ # list`. There is a maximum of 200 resource names.
759764 # @param [Array<String>, String] sources
760765 # Optional. A mask of what source types to return. Defaults to
761766 # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
@@ -790,18 +795,23 @@ def get_people(person_fields: nil, request_mask_include_field: nil, resource_nam
790795 end
791796
792797 # Provides a list of domain profiles and domain contacts in the authenticated
793- # user's domain directory.
798+ # user's domain directory. When the `sync_token` is specified, resources deleted
799+ # since the last sync will be returned as a person with `PersonMetadata.deleted`
800+ # set to true. When the `page_token` or `sync_token` is specified, all other
801+ # request parameters must match the first call. See example usage at [List the
802+ # directory people that have changed](/people/v1/directory#
803+ # list_the_directory_people_that_have_changed).
794804 # @param [Array<String>, String] merge_sources
795805 # Optional. Additional data to merge into the directory sources if they are
796806 # connected through verified join keys such as email addresses or phone numbers.
797807 # @param [Fixnum] page_size
798808 # Optional. The number of people to include in the response. Valid values are
799809 # between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.
800810 # @param [String] page_token
801- # Optional. A page token, received from a previous `ListDirectoryPeople` call .
811+ # Optional. A page token, received from a previous response `next_page_token` .
802812 # Provide this to retrieve the subsequent page. When paginating, all other
803- # parameters provided to `ListDirectoryPeople ` must match the call that provided
804- # the page token.
813+ # parameters provided to `people.listDirectoryPeople ` must match the first call
814+ # that provided the page token.
805815 # @param [String] read_mask
806816 # Required. A field mask to restrict which fields on each person are returned.
807817 # Multiple fields can be specified by separating them with commas. Valid values
@@ -811,16 +821,17 @@ def get_people(person_fields: nil, request_mask_include_field: nil, resource_nam
811821 # miscKeywords * names * nicknames * occupations * organizations * phoneNumbers *
812822 # photos * relations * sipAddresses * skills * urls * userDefined
813823 # @param [Boolean] request_sync_token
814- # Optional. Whether the response should include `next_sync_token`, which can be
815- # used to get all changes since the last request. For subsequent sync requests
816- # use the `sync_token` param instead .
824+ # Optional. Whether the response should return `next_sync_token`. It can be used
825+ # to get incremental changes since the last request by setting it on the request
826+ # `sync_token`. More details about sync behavior at `people.listDirectoryPeople` .
817827 # @param [Array<String>, String] sources
818828 # Required. Directory sources to return.
819829 # @param [String] sync_token
820- # Optional. A sync token, received from a previous `ListDirectoryPeople` call.
830+ # Optional. A sync token, received from a previous response `next_sync_token`
821831 # Provide this to retrieve only the resources changed since the last request.
822- # When syncing, all other parameters provided to `ListDirectoryPeople` must
823- # match the call that provided the sync token.
832+ # When syncing, all other parameters provided to `people.listDirectoryPeople`
833+ # must match the first call that provided the sync token. More details about
834+ # sync behavior at `people.listDirectoryPeople`.
824835 # @param [String] fields
825836 # Selector specifying which fields to include in a partial response.
826837 # @param [String] quota_user
@@ -918,9 +929,9 @@ def search_person_contacts(page_size: nil, query: nil, read_mask: nil, sources:
918929 # Optional. The number of people to include in the response. Valid values are
919930 # between 1 and 500, inclusive. Defaults to 100 if not set or set to 0.
920931 # @param [String] page_token
921- # Optional. A page token, received from a previous `SearchDirectoryPeople` call .
932+ # Optional. A page token, received from a previous response `next_page_token` .
922933 # Provide this to retrieve the subsequent page. When paginating, all other
923- # parameters provided to `SearchDirectoryPeople` must match the call that
934+ # parameters provided to `SearchDirectoryPeople` must match the first call that
924935 # provided the page token.
925936 # @param [String] query
926937 # Required. Prefix query that matches fields in the person. Does NOT use the
@@ -1069,23 +1080,28 @@ def update_person_contact_photo(resource_name, update_contact_photo_request_obje
10691080 execute_or_queue_command ( command , &block )
10701081 end
10711082
1072- # Provides a list of the authenticated user's contacts. The request returns a
1073- # 400 error if `personFields` is not specified. The request returns a 410 error
1074- # if `sync_token` is specified and is expired. Sync tokens expire after 7 days
1075- # to prevent data drift between clients and the server. To handle a sync token
1076- # expired error, a request should be sent without `sync_token` to get all
1077- # contacts.
1083+ # Provides a list of the authenticated user's contacts. Sync tokens expire 7
1084+ # days after the full sync. A request with an expired sync token will result in
1085+ # a 410 error. In the case of such an error clients should make a full sync
1086+ # request without a `sync_token`. The first page of a full sync request has an
1087+ # additional quota. If the quota is exceeded, a 429 error will be returned. This
1088+ # quota is fixed and can not be increased. When the `sync_token` is specified,
1089+ # resources deleted since the last sync will be returned as a person with `
1090+ # PersonMetadata.deleted` set to true. When the `page_token` or `sync_token` is
1091+ # specified, all other request parameters must match the first call. See example
1092+ # usage at [List the user's contacts that have changed](/people/v1/contacts#
1093+ # list_the_users_contacts_that_have_changed).
10781094 # @param [String] resource_name
10791095 # Required. The resource name to return connections for. Only `people/me` is
10801096 # valid.
10811097 # @param [Fixnum] page_size
10821098 # Optional. The number of connections to include in the response. Valid values
10831099 # are between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.
10841100 # @param [String] page_token
1085- # Optional. A page token, received from a previous `ListConnections` call .
1101+ # Optional. A page token, received from a previous response `next_page_token` .
10861102 # Provide this to retrieve the subsequent page. When paginating, all other
1087- # parameters provided to `ListConnections ` must match the call that provided the
1088- # page token.
1103+ # parameters provided to `people.connections.list ` must match the first call
1104+ # that provided the page token.
10891105 # @param [String] person_fields
10901106 # Required. A field mask to restrict which fields on each person are returned.
10911107 # Multiple fields can be specified by separating them with commas. Valid values
@@ -1099,29 +1115,22 @@ def update_person_contact_photo(resource_name, update_contact_photo_request_obje
10991115 # Each path should start with `person.`: for example, `person.names` or `person.
11001116 # photos`.
11011117 # @param [Boolean] request_sync_token
1102- # Optional. Whether the response should include `next_sync_token` on the last
1103- # page, which can be used to get all changes since the last request. For
1104- # subsequent sync requests use the `sync_token` param instead. Initial full sync
1105- # requests that specify `request_sync_token` and do not specify `sync_token`
1106- # have an additional rate limit per user. Each client should generally only be
1107- # doing a full sync once every few days per user and so should not hit this
1108- # limit.
1118+ # Optional. Whether the response should return `next_sync_token` on the last
1119+ # page of results. It can be used to get incremental changes since the last
1120+ # request by setting it on the request `sync_token`. More details about sync
1121+ # behavior at `people.connections.list`.
11091122 # @param [String] sort_order
11101123 # Optional. The order in which the connections should be sorted. Defaults to `
11111124 # LAST_MODIFIED_ASCENDING`.
11121125 # @param [Array<String>, String] sources
11131126 # Optional. A mask of what source types to return. Defaults to
11141127 # READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.
11151128 # @param [String] sync_token
1116- # Optional. A sync token, received from a previous `ListConnections` call.
1129+ # Optional. A sync token, received from a previous response `next_sync_token`
11171130 # Provide this to retrieve only the resources changed since the last request.
1118- # When the `syncToken` is specified, resources deleted since the last sync will
1119- # be returned as a person with [`PersonMetadata.deleted`](/people/api/rest/v1/
1120- # people#Person.PersonMetadata.FIELDS.deleted) set to true. When the `syncToken`
1121- # is specified, all other parameters provided to `ListConnections` except `
1122- # page_size` and `page_token` must match the initial call that provided the sync
1123- # token. Sync tokens expire after seven days, after which a full sync request
1124- # without a `sync_token` should be made.
1131+ # When syncing, all other parameters provided to `people.connections.list` must
1132+ # match the first call that provided the sync token. More details about sync
1133+ # behavior at `people.connections.list`.
11251134 # @param [String] fields
11261135 # Selector specifying which fields to include in a partial response.
11271136 # @param [String] quota_user
0 commit comments