Method: people.updateContact

Aktualisieren Sie die Kontaktdaten einer vorhandenen Kontaktperson. Nicht Kontaktdaten werden nicht geändert. Alle nicht Kontaktdaten der zu aktualisierenden Person 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 wenn keine Kontaktquelle vorhanden ist.

Der Server gibt einen 400-Fehler mit dem Grund "failedPrecondition" zurück, wenn person.metadata.sources.etag vom ETag des Kontakts abweicht. Das bedeutet, dass sich der Kontakt seit dem Lesen der Daten geändert hat. Die Kundschaft sollte die neueste Person abrufen und ihre Updates in der neuesten Person zusammenführen.

Der Server gibt einen 400-Fehler zurück, wenn memberships aktualisiert werden und für die Person keine Mitgliedschaft in Kontaktgruppen angegeben wurde.

Der Server gibt einen 400-Fehler zurück, wenn in einem Feld, das ein Singleton-Feld für Kontaktquellen ist, mehr als ein Feld angegeben ist:

  • biografien
  • Geburtstage
  • geschlechter
  • names

Änderungsanfragen 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 vom Server zugewiesene Ressourcenname für die 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 einer 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
  • clientData
  • emailAddresses
  • Veranstaltungen
  • externalIds
  • geschlechter
  • imClients
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • miscKeywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • Beziehungen
  • sipAddresses
  • urls
  • userDefined
personFields

string (FieldMask format)

Optional. 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. Wird kein Wert festgelegt, werden standardmäßig alle Felder verwendet. Gültige Werte sind:

  • addresses
  • ageRanges
  • biografien
  • Geburtstage
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • Veranstaltungen
  • externalIds
  • geschlechter
  • imClients
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • Metadaten
  • miscKeywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • 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 wird, 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.