Nachdem Sie die Schritte unter Vorbereitung auf die Verwendung der People API ausgeführt haben, können Sie Daten in „Weitere Kontakte“ lesen, kopieren und suchen.
Die folgenden Codebeispiele zeigen, wie Sie einige einfache Anfragen senden. Eine vollständige Liste der Methoden finden Sie in der Referenzdokumentation.
Weitere Kontakte des Nutzers auflisten
Verwenden Sie den folgenden Code, um eine Liste der Personen in der Gruppe "Weitere Kontakte" des Nutzers abzurufen:
Protokoll
GET /v1/otherContacts?readMask=names,emailAddresses HTTP/1.1 Host: people.googleapis.com
Java
ListOtherContactsResponse response = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.execute();
List<Person> otherContacts = response.getOtherContacts();
Geänderte "Weitere Kontakte" des Nutzers auflisten
Java
// Initial request
ListOtherContactsResponse fullSyncResponse = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.setRequestSyncToken(true)
.execute();
// Fetch all the pages
while (fullSyncResponse.getNextPageToken() != null) {
fullSyncResponse = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.setRequestSyncToken(true)
.setPageToken(fullSyncResponse.getNextPageToken())
.execute();
}
// Some time passes
// Fetch incremental changes using the sync token returned in the last fullSyncResponse.
try {
ListOtherContactsResponse incrementalSyncResponse = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.setSyncToken(fullSyncResponse.getNextSyncToken())
.execute();
for (Person person : incrementalSyncResponse.getOtherContacts()) {
handlePerson(person);
}
// Fetch all the pages
while (!incrementalSyncResponse.getNextPageToken().isEmpty()) {
incrementalSyncResponse = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.setSyncToken(fullSyncResponse.getNextSyncToken())
.setPageToken(incrementalSyncResponse.getNextPageToken())
.execute();
for (Person person : incrementalSyncResponse.getOtherContacts()) {
handlePerson(person);
}
}
} catch (GoogleJsonResponseException e) {
if (e.getStatusCode() == 410) {
// Sync token expired. Make full sync request.
}
}
void handlePerson(Person person) {
if (person.getMetadata().getDeleted()) {
// Handle deleted person
} else {
// Handle changed person
}
}
Weitere Informationen zum Synchronisierungsverhalten finden Sie unter ListOtherContacts.
Einen anderen Kontakt in die Gruppe "myContacts" kopieren
Verwenden Sie den folgenden Code, um einen anderen Kontakt in die Gruppe "myContacts" zu kopieren:
Protokoll
POST /v1/resource_name:copyOtherContactToMyContactsGroup?copyMask=names,emailAddresses,phoneNumbers HTTP/1.1 Host: people.googleapis.com
Java
Person copiedContact = peopleService
.otherContacts()
.copyOtherContactToMyContactsGroup(
"resource_name",
new CopyOtherContactToMyContactsGroupRequest()
.setCopyMask("names,emailAddresses,phoneNumbers"))
.execute();
In „Weitere Kontakte“ des Nutzers suchen
Verwenden Sie den folgenden Code, um in allen weiteren Kontakten des Nutzers zu suchen:
Protokoll
// Warmup cache GET /v1/otherContacts:search?query=&readMask=names,emailAddresses HTTP/1.1 Host: people.googleapis.com // Send search request after several seconds GET /v1/otherContacts:search?query=query&readMask=names,emailAddresses HTTP/1.1 Host: people.googleapis.com
Java
// Warmup cache
SearchResponse response = peopleService.otherContacts().search()
.setQuery("")
.setReadMask("names,emailAddresses")
.execute();
// Wait a few seconds
Thread.sleep(5);
// Send search request
SearchResponse response = peopleService.otherContacts().search()
.setQuery("query")
.setReadMask("names,emailAddresses")
.execute();