Method: people.updateContact

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

string

Der Ressourcenname für die Person, der vom Server zugewiesen wird. Ein ASCII-String im Format people/{person_id}.

Abfrageparameter

Parameter
updatePersonFields

string (FieldMask format)

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:

  • addresses
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • Beziehungen
  • sipAdressen
  • URLs
  • Benutzerdefiniert
personFields

string (FieldMask format)

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:

  • addresses
  • Altersbereiche
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • Cover Photos
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • metadata
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • fotos
  • Beziehungen
  • sipAdressen
  • skills
  • URLs
  • Benutzerdefiniert
sources[]

enum (ReadSourceType)

Optional. Eine Maske, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, werden standardmäßig READ_SOURCE_TYPE_CONTACT und READ_SOURCE_TYPE_PROFILE verwendet.

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.