- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ContactToCreate
- Prova!
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 ( |
Campi | |
---|---|
contacts[] |
Obbligatorio. Il contatto da creare. Consente fino a 200 contatti in una singola richiesta. |
readMask |
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:
|
sources[] |
(Facoltativo) Una maschera dei tipi di origine da restituire nella lettura successiva alla modifica. Se non viene configurato, il valore predefinito è |
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 ( |
Campi | |
---|---|
createdPeople[] |
I contatti creati, a meno che la richiesta |
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 ( |
Campi | |
---|---|
contactPerson |
Obbligatorio. I dati personali da inserire in un'origine appena creata. |