Kontaktdaten für eine vorhandene Kontaktperson aktualisieren. Nicht-kontaktbezogene Daten werden nicht geändert. Alle Kontaktdaten, die nicht von der Person zu aktualisieren sind, werden ignoriert. Alle in updateMask
angegebenen Felder werden ersetzt.
Der Server gibt einen 400-Fehler zurück, wenn person.metadata.sources
für den zu aktualisierenden Kontakt nicht angegeben wurde oder keine Kontaktquelle vorhanden ist.
Der Server gibt einen 400-Fehler mit dem Grund "failedPrecondition"
zurück, wenn sich person.metadata.sources.etag
vom ETag des Kontakts unterscheidet. Dies bedeutet, dass sich der Kontakt seit dem Lesen der Daten geändert hat. Kunden sollten die neueste Person abrufen und ihre Aktualisierungen mit der neuesten Person zusammenführen.
Der Server gibt einen 400-Fehler zurück, wenn memberships
aktualisiert wird und für die Person keine Mitgliedschaften für Kontaktgruppen angegeben sind.
Der Server gibt einen 400-Fehler zurück, wenn mehr als ein Feld in einem Feld angegeben ist, das ein Singleton für Kontaktquellen ist:
- Biografien
- Geburtstage
- geschlechter
- names
Mutate-Anfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.
HTTP-Anfrage
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
person.resourceName |
Der Ressourcenname für die Person, der vom Server zugewiesen wird. Ein ASCII-String im Format |
Abfrageparameter
Parameter | |
---|---|
updatePersonFields |
Erforderlich. Eine Feldmaske, mit der eingeschränkt wird, welche Felder der Person aktualisiert werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Alle aktualisierten Felder werden ersetzt. Gültige Werte sind:
|
personFields |
Optional. 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. Wenn nichts anderes festgelegt ist, werden standardmäßig alle Felder verwendet. Gültige Werte sind:
|
sources[] |
Optional. Eine Maske, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, werden standardmäßig |
Anfragetext
Der Anfragetext enthält eine Instanz von Person
.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Person
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/contacts
Weitere Informationen finden Sie im Autorisierungsleitfaden.