Method: people.batchCreateContacts

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

Ä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: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. Ermöglicht bis zu 200 Kontakte in einer einzelnen Anfrage.
readMask

string (FieldMask format)

Erforderlich. Eine Feldmaske, mit der eingeschränkt wird, welche Felder für jede Person in der Antwort zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Bleibt die Lesemaske leer, wird „post-mutate-get“ übersprungen und es werden keine Daten in der Antwort zurückgegeben. 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 mit den Quelltypen, die im Post-Mutate-Lesevorgang zurückgegeben werden sollen. Wenn kein Wert festgelegt wird, werden standardmäßig READ_SOURCE_TYPE_CONTACT und READ_SOURCE_TYPE_PROFILE verwendet.

Antworttext

Wenn nicht erfolgreich, wird BatchCreateContactsErrorDetails zurückgegeben, das eine Liste von Fehlern für jeden ungültigen Kontakt enthält.

Die Antwort auf die Anfrage zum Erstellen eines Batch-Kontakts.

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 zum Ausfüllen einer neu erstellten Quelle enthält.

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

object (Person)

Erforderlich. Die Personendaten, die in eine neu erstellte Quelle eingefügt werden sollen.