Method: people.batchCreateContacts

Erstellen Sie einen Batch neuer Kontakte und geben Sie die PersonResponses für die neuen

Änderungsanfragen für denselben Nutzer sollten sequenziell gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Felder
contacts[]

object (ContactToCreate)

Erforderlich. Der zu erstellende Kontakt. Bis zu 200 Kontakte in einer einzelnen Anfrage sind zulässig.
readMask

string (FieldMask format)

Erforderlich. Eine Feldmaske, um einzuschränken, welche Felder für jede Person in der Antwort zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Wenn die Lesemaske leer bleibt, wird post-mutate-get übersprungen und in der Antwort werden keine Daten zurückgegeben. Gültige Werte sind:

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

enum (ReadSourceType)

Optional. Eine Maske der Quelltypen, die beim Lesen von post mutate zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, werden standardmäßig READ_SOURCE_TYPE_CONTACT und READ_SOURCE_TYPE_PROFILE verwendet.

Antworttext

Bei nicht erfolgreicher Ausführung wird BatchCreateContactsErrorDetails zurückgegeben, das eine Liste von Fehlern für jeden ungültigen Kontakt enthält.

Die Antwort auf eine Anfrage zum Erstellen eines Stapels von Kontakten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Felder
createdPeople[]

object (PersonResponse)

Die erstellten Kontakte, es sei denn, die Anfrage readMask ist leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/contacts

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

ContactToCreate

Ein Wrapper, der die Personendaten enthält, um eine neu erstellte Quelle zu füllen.

JSON-Darstellung 
{
  "contactPerson": {
    object (Person)
  }
}
Felder
contactPerson

object (Person)

Erforderlich. Die Personendaten, die in eine neu erstellte Quelle eingetragen werden sollen.