Nachdem Sie die Schritte unter Vorbereitungen für die Verwendung der People API ausgeführt haben, können Sie Verzeichniskontakte und ‑profile lesen.
Die folgenden Codebeispiele zeigen, wie Sie einige einfache Anfragen senden. Eine vollständige Liste der Methoden finden Sie in der Referenzdokumentation.
Personen im Verzeichnis auflisten
Mit dem folgenden Code erhältst du eine Liste der Kontakte und Profile im Domainverzeichnis des Nutzers:
GET /v1/people:listDirectoryPeople?sources=DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT&sources=DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE&readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
List<String> sources = new ArrayList<>();
sources.add("DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT");
sources.add("DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE");
ListDirectoryPeopleResponse response = peopleService.people().listDirectoryPeople()
.setSources(sources)
.setReadMask("metadata,names,emailAddresses")
.execute();
List<Person> people = response.getPeople();
Liste der Personen im Verzeichnis, die sich geändert haben
// Initial request
List<String> sources = new ArrayList<>();
sources.add("DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT");
sources.add("DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE");
ListDirectoryPeopleResponse fullSyncResponse = peopleService.people().listDirectoryPeople()
.setSources(sources)
.setReadMask("metadata,names,emailAddresses")
.setRequestSyncToken(true)
.execute();
// Fetch all the pages
while (fullSyncResponse.getNextPageToken() != null) {
fullSyncResponse = peopleService.people().listDirectoryPeople()
.setSources(sources)
.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 {
ListDirectoryPeopleResponse incrementalSyncResponse = peopleService.people().listDirectoryPeople()
.setSources(sources)
.setReadMask("metadata,names,emailAddresses")
.setSyncToken(fullSyncResponse.getNextSyncToken())
.execute();
for (Person person : incrementalSyncResponse.getDirectoryPeople()) {
handlePerson(person);
}
// Fetch all the pages
while (incrementalSyncResponse.getNextPageToken() != null) {
incrementalSyncResponse = peopleService.people().listDirectoryPeople
.setSources(sources)
.setReadMask("metadata,names,emailAddresses")
.setSyncToken(fullSyncResponse.getNextSyncToken())
.setPageToken(incrementalSyncResponse.getNextPageToken())
.execute();
for (Person person : incrementalSyncResponse.getDirectoryPeople()) {
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 ListDirectory.
Im Verzeichnis „Personen“ suchen
Mit dem folgenden Code erhältst du eine Liste der Kontakte und Profile im Domainverzeichnis des Nutzers, die mit einer Prefix-Abfrage übereinstimmen:
POST /v1/people:searchDirectoryPeople?query=John&sources=DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT&sources=DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE&readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
List