Method: people.batchCreateContacts

Creare un gruppo di nuovi contatti e restituire le PersonResponses per i nuovi

Le richieste di modifica 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 di ogni persona che vengono restituiti nella risposta. Puoi specificare più campi separandoli con virgole. Se la maschera di lettura viene lasciata vuota, il metodo post-mutate-get viene ignorato e non vengono restituiti dati nella risposta. I valori validi sono:

  • indirizzi
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • nomi
  • nickname
  • occupazioni
  • organizzazioni
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • Url
  • userDefined
sources[]

enum (ReadSourceType)

(Facoltativo) Una maschera dei tipi di origine da restituire nella lettura successiva alla modifica. Se non viene configurato, il valore predefinito è READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

Corpo della risposta

In caso contrario, 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 personali per completare un'origine appena creata.

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

object (Person)

Obbligatorio. I dati personali da inserire in un'origine appena creata.