Method: presentations.batchUpdate

Applica uno o più aggiornamenti alla presentazione.

Ogni request viene convalidato prima dell'applicazione. Se una qualsiasi richiesta non è valida, l'intera richiesta avrà esito negativo e non verrà applicato nulla.

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

Ad esempio, supponi di chiamare batchUpdate con quattro aggiornamenti e solo il terzo restituisce informazioni. La risposta conterrà due risposte vuote: la risposta alla terza richiesta e un'altra risposta vuota, in questo ordine.

Poiché altri utenti potrebbero aver modificato la presentazione, la presentazione potrebbe non riflettere esattamente le tue modifiche: le tue modifiche potrebbero essere alterate rispetto a quelle apportate dai collaboratori. Se non ci sono collaboratori, la presentazione dovrebbe rispecchiare le tue modifiche. In ogni caso, è garantito che gli aggiornamenti nella tua richiesta vengano applicati insieme a livello atomico.

Richiesta HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
presentationId

string

La presentazione a cui applicare gli aggiornamenti.

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 alla presentazione.
writeControl

object (WriteControl)

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

Corpo della risposta

Messaggio di risposta da un aggiornamento collettivo.

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

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

string

La presentazione 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 di scrittura aggiornato dopo l'applicazione della richiesta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

WriteControl

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

Rappresentazione JSON 
{
  "requiredRevisionId": string
}
Campi
requiredRevisionId

string

Il revision ID della presentazione necessario per la richiesta di scrittura. Se specificato e l'ID revisione richiesto non corrisponde all'ID revisione corrente della presentazione, la richiesta non viene elaborata e restituisce un errore 400 di richiesta errata.

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