Method: people.batchCreateContacts

Creare un gruppo di nuovi contatti e restituire le risposte PersonResponse per i nuovi

Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Campi
contacts[]

object (ContactToCreate)

obbligatorio. Il contatto da creare. Consente fino a 200 contatti in una singola richiesta.
readMask

string (FieldMask format)

obbligatorio. Una maschera di campo per limitare i campi per ogni persona che vengono restituiti nella risposta. È possibile specificare più campi separandoli con virgole. Se la maschera di lettura viene lasciata vuota, il comando post-mutate-get viene ignorato e non vengono restituiti dati nella risposta. I valori validi sono:

  • addresses
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • names
  • nickname
  • occupazioni
  • organizations
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Campo facoltativo. Una maschera dei tipi di origine da restituire nella lettura post-mutata. Se non viene configurato, il valore predefinito è READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

Corpo della risposta

Se l'operazione non va a buon fine, restituisce BatchCreateContactsErrorDetails, che contiene un elenco di errori per ogni contatto non valido.

La risposta a una richiesta di creazione di un gruppo di contatti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Campi
createdPeople[]

object (PersonResponse)

I contatti creati, a meno che la richiesta readMask non sia vuota.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.

ContactToCreate

Un wrapper contenente i dati delle persone da compilare in un'origine appena creata.

Rappresentazione JSON 
{
  "contactPerson": {
    object (Person)
  }
}
Campi
contactPerson

object (Person)

obbligatorio. I dati personali da completare in un'origine appena creata.