Method: people.batchCreateContacts

Erstellen Sie einen Batch neuer Kontakte und geben Sie die Personenantworten für die neu

Mutate-Anfragen 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. Bis zu 200 Kontakte in einer Anfrage.
readMask

string (FieldMask format)

Erforderlich. Eine Feldmaske zur Einschränkung der Felder, die von jeder Person in der Antwort zurückgegeben werden. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Wenn die Lesemaske leer gelassen wird, wird die Methode nach der Mutation übersprungen und es werden keine Daten in der Antwort zurückgegeben. Gültige Werte sind:

  • addresses
  • Altersbereiche
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • Cover Photos
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • metadata
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • fotos
  • Beziehungen
  • sipAdressen
  • skills
  • URLs
  • Benutzerdefiniert
sources[]

enum (ReadSourceType)

Optional. Eine Maske, welche Quelltypen im PostMutate-Lesevorgang zurückgegeben werden. Wenn kein Wert festgelegt ist, werden standardmäßig READ_SOURCE_TYPE_CONTACT und READ_SOURCE_TYPE_PROFILE verwendet.

Antworttext

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

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

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

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

object (PersonResponse)

Die Kontakte, die erstellt wurden, 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 Autorisierungsleitfaden.

Kontakt erstellen

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 Daten der Person zum Befüllen einer neu erstellten Quelle.