Skip to main content

other_contacts

Overview

Nameother_contacts
TypeResource
Idgoogledevelopers.people.other_contacts

Fields

NameDatatypeDescription
otherContactsarrayThe list of "Other contacts" returned as Person resources. "Other contacts" support a limited subset of fields. See ListOtherContactsRequest.request_mask for more detailed information.
totalSizeintegerThe total number of other contacts in the list without pagination.
nextPageTokenstringA token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
nextSyncTokenstringA token, which can be sent as sync_token to retrieve changes since the last request. Request must set request_sync_token to return the sync token.

Methods

NameAccessible byRequired ParamsDescription
otherContacts_listSELECTList all "Other contacts", that is contacts that are not in a contact group. "Other contacts" are typically auto created contacts from interactions. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an google.rpc.ErrorInfo with reason "EXPIRED_SYNC_TOKEN". In the case of such an error clients should make a full sync request without a sync_token. The first page of a full sync request has an additional quota. If the quota is exceeded, a 429 error will be returned. This quota is fixed and can not be increased. When the sync_token is specified, resources deleted since the last sync will be returned as a person with PersonMetadata.deleted set to true. When the page_token or sync_token is specified, all other request parameters must match the first call. Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases. See example usage at List the user's other contacts that have changed.
otherContacts_copyOtherContactToMyContactsGroupEXECotherContactsIdCopies 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.
otherContacts_searchEXECProvides 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. 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