Method: people.updateContact

Kontaktdaten für eine vorhandene Kontaktperson aktualisieren Alle nicht personenidentifizierbaren Daten werden nicht geändert. Alle nicht Kontaktdaten der Person, die aktualisiert werden soll, werden ignoriert. Alle in der updateMask angegebenen Felder werden ersetzt.

Der Server gibt den Fehler 400 zurück, wenn für den zu aktualisierenden Kontakt keine person.metadata.sources angegeben ist oder keine Kontaktdatenquelle 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 seiner Daten geändert hat. Kunden sollten die neueste Person abrufen und ihre Änderungen in die neueste Person einfügen. Wenn Sie mehrere aufeinanderfolgende Aktualisierungen für dieselbe Person vornehmen, sollten Sie den Etag aus der updateContact-Antwort verwenden, um Fehler zu vermeiden.

Der Server gibt den Fehler 400 zurück, wenn memberships aktualisiert werden und für die Person keine Kontaktgruppenmitgliedschaften angegeben sind.

Der Server gibt den Fehler 400 zurück, wenn für ein Feld, das für Kontaktdatenquellen ein Singleton ist, mehr als ein Feld angegeben ist:

  • Biografien
  • Geburtstage
  • geschlechter
  • Namen

Mutanfragen für denselben Nutzer sollten nacheinander gesendet werden, um eine 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 vom Server zugewiesene Ressourcenname der Person. 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:

  • Adressen
  • Biografien
  • Geburtstage
  • calendarUrls
  • clientData
  • emailAddresses
  • Veranstaltungen
  • externalIds
  • geschlechter
  • imClients
  • Interessen
  • locales
  • Standorte
  • mitgliedschaft
  • miscKeywords
  • Namen
  • Aliasse
  • Berufe
  • Organisationen
  • phoneNumbers
  • Beziehungen
  • sipAddresses
  • URLs
  • userDefined
personFields

string (FieldMask format)

Optional. Eine Feldmaske, mit der eingeschränkt wird, welche Felder zu den einzelnen Personen zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Wenn kein Wert festgelegt ist, werden standardmäßig alle Felder berücksichtigt. Gültige Werte sind:

  • Adressen
  • ageRanges
  • Biografien
  • Geburtstage
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • Veranstaltungen
  • externalIds
  • geschlechter
  • imClients
  • Interessen
  • locales
  • Standorte
  • mitgliedschaft
  • Metadaten
  • miscKeywords
  • Namen
  • Aliasse
  • Berufe
  • Organisationen
  • phoneNumbers
  • Fotos
  • Beziehungen
  • sipAddresses
  • skills
  • URLs
  • userDefined
sources[]

enum (ReadSourceType)

Optional. Eine Maske, die angibt, 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 Leitfaden zur Autorisierung.