com.google.api.services.people.v1

Class PeopleService.OtherContacts

java.lang.Object

com.google.api.services.people.v1.PeopleService.OtherContacts

Enclosing class:

PeopleService

public class PeopleService.OtherContacts
extends Object

The "otherContacts" collection of methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	PeopleService.OtherContacts.CopyOtherContactToMyContactsGroup
class	PeopleService.OtherContacts.List
class	PeopleService.OtherContacts.Search

Constructor Summary

Constructors

Constructor and Description
OtherContacts()

Method Summary

Modifier and Type	Method and Description
PeopleService.OtherContacts.CopyOtherContactToMyContactsGroup	copyOtherContactToMyContactsGroup(String resourceName, CopyOtherContactToMyContactsGroupRequest content) 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.
PeopleService.OtherContacts.List	list() List all "Other contacts", that is contacts that are not in a contact group.
PeopleService.OtherContacts.Search	search() Provides a list of contacts in the authenticated user's other contacts that matches the search query.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OtherContacts

public OtherContacts()

Method Detail

copyOtherContactToMyContactsGroup

public PeopleService.OtherContacts.CopyOtherContactToMyContactsGroup copyOtherContactToMyContactsGroup(String resourceName,
                                                                                                       CopyOtherContactToMyContactsGroupRequest content)
                                                                                                throws IOException

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. Create a request for the method "otherContacts.copyOtherContactToMyContactsGroup". This request holds the parameters needed by the people server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.

Parameters:

resourceName - Required. The resource name of the "Other contact" to copy.

content - the CopyOtherContactToMyContactsGroupRequest

Returns:

the request

Throws:

IOException

list

public PeopleService.OtherContacts.List list()
                                      throws IOException

List 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](https://cloud.google.com/apis/design/errors#error_info) 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](/people/v1/other-contacts#list_the_users_other_contacts_that_have_changed). Create a request for the method "otherContacts.list". This request holds the parameters needed by the people server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.

Returns:

the request

Throws:

IOException

search

public PeopleService.OtherContacts.Search search()
                                          throws IOException

Provides 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 Create a request for the method "otherContacts.search". This request holds the parameters needed by the people server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.

Returns:

the request

Throws:

IOException