Method: people.createContact

Erstellen Sie einen neuen Kontakt und geben Sie die Personenressource für diesen Kontakt zurück.

Die Anfrage 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

POST https://people.googleapis.com/v1/people:createContact

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
personFields

string (FieldMask format)

Erforderlich. 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.