Listen Sie alle anderen Kontakte auf, die nicht zu einer Kontaktgruppe gehören. „Weitere Kontakte“ sind normalerweise automatisch erstellte Kontakte aus Interaktionen.
Synchronisierungstoken laufen sieben Tage nach der vollständigen Synchronisierung ab. Eine Anfrage mit einem abgelaufenen Synchronisierungstoken erhält einen Fehler mit der Meldung google.rpc.ErrorInfo mit dem Grund "EXPIRED_SYNC_TOKEN". In diesem Fall sollten Clients eine vollständige Synchronisierungsanfrage ohne
ausführen.syncToken
Die erste Seite einer vollständigen Synchronisierungsanfrage hat ein zusätzliches Kontingent. Wenn das Kontingent überschritten wird, wird ein 429-Fehler zurückgegeben. Dieses Kontingent ist festgelegt und kann nicht erhöht werden.
Wenn
angegeben ist, werden Ressourcen, die seit der letzten Synchronisierung gelöscht wurden, als Person zurückgegeben, wobei syncToken
auf „true“ gesetzt ist.PersonMetadata.deleted
Wenn
oder pageToken
angegeben ist, müssen alle anderen Anfrageparameter mit dem ersten Aufruf übereinstimmen.syncToken
Bei Schreibvorgängen kann die Übertragungsverzögerung für Synchronisierungsanfragen mehrere Minuten betragen. Inkrementelle Synchronisierungen sind nicht für Anwendungsfälle „Lesen nach Schreiben“ gedacht.
Sehen Sie sich die Beispielverwendung unter Andere Kontakte des Nutzers auflisten, die geändert wurden an.
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 empfangen wurde: Beim Paginieren müssen alle anderen für |
pageSize |
Optional. Die Anzahl der weiteren Kontakte in der Antwort. Gültige Werte liegen im Bereich von 1 bis 1.000. Der Standardwert ist 100, wenn nicht oder 0 festgelegt. |
requestSyncToken |
Optional. Gibt an, ob die Antwort Weitere Informationen zum Synchronisierungsverhalten finden Sie unter |
syncToken |
Optional. Ein Synchronisierungstoken, das von einer vorherigen Antwort empfangen wurde Bei der Synchronisierung müssen alle anderen Parameter, die für Weitere Informationen zum Synchronisierungsverhalten finden Sie unter |
readMask |
Erforderlich. Eine Feldmaske zur Einschränkung der zurückgegebenen Felder für jede Person. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Welche Werte gültig sind, hängt vom verwendeten ReadSourceType ab. Wenn READ_SOURCE_TYPE_CONTACT verwendet wird, sind die folgenden Werte gültig:
Wenn READ_SOURCE_TYPE_PROFILE verwendet wird, sind die folgenden Werte gültig:
|
sources[] |
Optional. Eine Maske, welche Quelltypen zurückgegeben werden sollen. Wenn nichts festgelegt ist, wird standardmäßig Mögliche Werte für dieses Feld sind: Die Angabe von |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Die Antwort auf eine Anfrage für „Andere Kontakte“ des authentifizierten Nutzers.
JSON-Darstellung |
---|
{
"otherContacts": [
{
object ( |
Felder | |
---|---|
otherContacts[] |
Die Liste „Weitere Kontakte“ wurde als Ressourcen der Person zurückgegeben. „Andere 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 Autorisierungsleitfaden.