Aggiorna un gruppo di contatti e restituisci una mappa dei nomi delle risorse a PersonResponses per i contatti aggiornati.
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:batchUpdateContacts
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "contacts": { string: { object ( |
Campi | |
---|---|
contacts |
obbligatorio. Una mappa dei nomi delle risorse con i dati delle persone da aggiornare. Consente fino a 200 contatti in una singola richiesta. Un oggetto contenente un elenco di |
updateMask |
obbligatorio. Una maschera di campo per limitare i campi aggiornati per la persona. È possibile specificare più campi separandoli con virgole. Tutti i campi specificati verranno sostituiti o cancellati se lasciati vuoti per ogni persona. I valori validi sono:
|
readMask |
obbligatorio. Una maschera di campo per limitare i campi restituiti per ogni persona. È 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:
|
sources[] |
Campo facoltativo. Una maschera dei tipi di origine da restituire. Se non viene configurato, il valore predefinito è |
Corpo della risposta
Se l'operazione non va a buon fine, restituisce BatchUpdateContactsErrorDetails
, un elenco di errori corrispondenti a ciascun contatto.
La risposta a una richiesta di aggiornamento di un gruppo di contatti.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"updateResult": {
string: {
object ( |
Campi | |
---|---|
updateResult |
Una mappa dei nomi delle risorse per i contatti che sono stati aggiornati, a meno che la richiesta Un oggetto contenente un elenco di |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/contacts
Per ulteriori informazioni, consulta la guida all'autorizzazione.