Listet alle weiteren Kontakte auf, d. h. Kontakte, die nicht zu einer Kontaktgruppe gehören. „Weitere Kontakte“ sind in der Regel automatisch aus Interaktionen erstellte Kontakte.
Synchronisierungstokens laufen 7 Tage nach der vollständigen Synchronisierung ab. Bei einer Anfrage mit einem abgelaufenen Synchronisierungstoken wird ein Fehler mit der Meldung google.rpc.ErrorInfo mit dem Grund „AbgelaufenD_SYNC_TOKEN“ zurückgegeben. In diesem Fall sollten Clients eine vollständige Synchronisierungsanfrage ohne
senden.syncToken
Für die erste Seite einer vollständigen Synchronisierungsanfrage gilt ein zusätzliches Kontingent. Wenn das Kontingent überschritten wird, wird der Fehler 429 zurückgegeben. Dieses Kontingent ist fest und kann nicht erhöht werden.
Wenn
angegeben ist, werden Ressourcen, die seit der letzten Synchronisierung gelöscht wurden, als Person zurückgegeben, für die syncToken
auf „true“ gesetzt ist.PersonMetadata.deleted
Wenn
oder pageToken
angegeben ist, müssen alle anderen Anfrageparameter mit dem ersten Aufruf übereinstimmen.syncToken
Schreibvorgänge können bei Synchronisierungsanfragen eine Verzögerung bei der Weitergabe von mehreren Minuten haben. Inkrementelle Synchronisierungen sind nicht für Anwendungsfälle mit Lese-/Schreibzugriff vorgesehen.
Anwendungsbeispiele finden Sie unter Andere Kontakte des Nutzers auflisten, die sich geändert haben.
HTTP-Anfrage
GET https://people.googleapis.com/v1/otherContacts
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
pageToken |
Optional. Ein Seitentoken, das von einer vorherigen Antwort Beim Paginieren müssen alle anderen für |
pageSize |
Optional. Die Anzahl unter „Weitere Kontakte“, die in der Antwort enthalten sein sollen. Gültige Werte liegen zwischen 1 und 1.000 (einschließlich). Wenn die Richtlinie nicht konfiguriert oder auf „0“ festgelegt ist, ist die Standardeinstellung 100. |
requestSyncToken |
Optional. Gibt an, ob die Antwort auf der letzten Ergebnisseite Weitere Informationen zum Synchronisierungsverhalten finden Sie unter |
syncToken |
Optional. Ein von einer vorherigen Antwort erhaltenes Synchronisierungstoken Bei der Synchronisierung müssen alle anderen für Weitere Informationen zum Synchronisierungsverhalten finden Sie unter |
readMask |
Erforderlich. Eine Feldmaske, mit der eingeschränkt wird, welche Felder für jede Person zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Welche Werte gültig sind, hängt davon ab, welcher ReadSourceType verwendet wird. Bei Verwendung von READ_SOURCE_TYPE_CONTACT sind folgende Werte gültig:
Bei Verwendung von READ_SOURCE_TYPE_PROFILE sind folgende Werte gültig:
|
sources[] |
Optional. Eine Maske, die angibt, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt wird, wird der Standardwert Mögliche Werte für dieses Feld sind: Die Angabe von |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Antwort auf eine Anfrage für die „Weitere Kontakte“ des authentifizierten Nutzers.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"otherContacts": [
{
object ( |
Felder | |
---|---|
otherContacts[] |
Die Liste „Weitere Kontakte“, die als Personenressourcen zurückgegeben wird. „Weitere Kontakte“ unterstützen eine begrenzte Teilmenge von Feldern. Weitere Informationen finden Sie unter ListOtherContactsRequest.request_mask. |
nextPageToken |
Ein Token, das als |
nextSyncToken |
Ein Token, das als |
totalSize |
Die Gesamtzahl der anderen Kontakte in der Liste ohne Paginierung. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/contacts.other.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.