Po wykonaniu czynności opisanych w artykule Przygotowanie do korzystania z People API możesz odczytywać, kopiować i przeszukiwać dane „Inne kontakty”.
Poniższe przykłady kodu pokazują, jak wysyłać kilka prostych żądań. Pełną listę metod znajdziesz w dokumentacji referencyjnej.
Wyświetlanie „Innych kontaktów” użytkownika
Aby uzyskać listę osób z sekcji „Inni kontakty”, użyj tego kodu:
GET /v1/otherContacts?readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
ListOtherContactsResponse response = peopleService.otherContacts().list()
.setReadMask("metadata,names,emailAddresses")
.execute();
List<Person> otherContacts = response.getOtherContacts();
Wymień „Inne kontakty” użytkownika, które uległy zmianie
// 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
}
}
Więcej informacji o zachowaniu synchronizacji znajdziesz w artykule ListOtherContacts.
Kopiowanie „Innego kontaktu” do grupy „mojeKontakty”
Aby skopiować „Inny kontakt” do grupy „myContacts”, użyj tego kodu:
POST /v1/resource_name :copyOtherContactToMyContactsGroup?copyMask=names,emailAddresses,phoneNumbers HTTP/1.1
Host: people.googleapis.com
Person copiedContact = peopleService
.otherContacts()
.copyOtherContactToMyContactsGroup(
"resource_name ",
new CopyOtherContactToMyContactsGroupRequest()
.setCopyMask("names,emailAddresses,phoneNumbers"))
.execute();
Przeszukaj „Inne kontakty” użytkownika.
Aby przeszukiwać wszystkich „Innych kontaktów” użytkownika, użyj tego kodu:
// 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
// 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();