Method: documents.batchUpdate

Applica uno o più aggiornamenti al documento.

Ogni request viene convalidato prima di essere applicato. Se una richiesta non è valida, l'intera richiesta non andrà a buon fine e non verrà applicato nulla.

Alcune richieste hanno replies per fornirti alcune informazioni su come vengono applicate. Non è necessario che altre richieste restituiscano informazioni; ognuna di queste restituisce una risposta vuota. L'ordine delle risposte corrisponde a quello delle richieste.

Ad esempio, supponiamo che tu chiami batchUpdate con quattro aggiornamenti e solo il terzo restituisca informazioni. La risposta conterrà due risposte vuote, la risposta alla terza richiesta e un'altra risposta vuota, in questo ordine.

Poiché altri utenti potrebbero modificare il documento, le modifiche potrebbero non riflettere esattamente le tue: le tue modifiche potrebbero essere alterate rispetto a quelle dei collaboratori. Se non sono presenti collaboratori, il documento dovrebbe riflettere le tue modifiche. In ogni caso, gli aggiornamenti nella richiesta verranno applicati insieme in modo atomico.

Richiesta HTTP

POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
documentId

string

L'ID del documento da aggiornare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campi
requests[]

object (Request)

Un elenco di aggiornamenti da applicare al documento.
writeControl

object (WriteControl)

Consente di controllare il modo in cui vengono eseguite le richieste di scrittura.

Corpo della risposta

Messaggio di risposta da una richiesta documents.batchUpdate.

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

Rappresentazione JSON 
{
  "documentId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campi
documentId

string

L'ID del documento a cui sono stati applicati gli aggiornamenti.
replies[]

object (Response)

La risposta degli aggiornamenti. Questa mappa mappa 1:1 con gli aggiornamenti, anche se le risposte ad alcune richieste potrebbero essere vuote.
writeControl

object (WriteControl)

Il controllo scrittura aggiornato dopo l'applicazione della richiesta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

WriteControl

Consente di controllare il modo in cui vengono eseguite le richieste di scrittura.

Rappresentazione JSON 
{

  // Union field control can be only one of the following:
  "requiredRevisionId": string,
  "targetRevisionId": string
  // End of list of possible types for union field control.
}
Campi
Campo unione control. Determina la revisione del documento in cui scrivere e il comportamento della richiesta se questa revisione non è quella corrente del documento. Se non viene specificato nessuno dei due campi, gli aggiornamenti vengono applicati all'ultima revisione. control può essere solo uno dei seguenti:
requiredRevisionId

string

Il valore facoltativo revision ID del documento a cui viene applicata la richiesta di scrittura. Se non si tratta dell'ultima revisione del documento, la richiesta non viene elaborata e viene restituito un errore di richiesta non valida (400).

Quando in una risposta viene restituito un ID revisione obbligatorio, viene indicato l'ID revisione del documento dopo l'applicazione della richiesta.
targetRevisionId

string

Il target facoltativo revision ID del documento a cui viene applicata la richiesta di scrittura.

Se le modifiche dei collaboratori sono state apportate dopo la lettura del documento utilizzando l'API, le modifiche prodotte da questa richiesta di scrittura vengono applicate alle modifiche dei collaboratori. Ciò porta a una nuova revisione del documento che incorpora sia le modifiche del collaboratore sia le modifiche nella richiesta, con il server Documenti che risolve le modifiche in conflitto. Quando utilizzi l'ID revisione target, il client API può essere considerato un altro collaboratore del documento.

L'ID revisione di destinazione può essere utilizzato solo per scrivere nelle versioni recenti di un documento. Se la revisione di destinazione è troppo indietro rispetto all'ultima revisione, la richiesta non viene elaborata e viene restituito un errore di richiesta non valida (400). La richiesta dovrebbe essere tentata di nuovo dopo aver recuperato l'ultima versione del documento. In genere, un ID revisione rimane valido per l'utilizzo come revisione target per diversi minuti dopo la lettura, ma per i documenti modificati di frequente questa finestra potrebbe essere più breve.