Method: presentations.batchUpdate

Aplica uma ou mais atualizações à apresentação.

Cada request é validado antes de ser aplicado. Se alguma solicitação não for válida, toda a solicitação vai falhar e nada será aplicado.

Algumas solicitações têm replies para fornecer informações sobre como elas são aplicadas. Outras solicitações não precisam retornar informações. Elas retornam uma resposta vazia. A ordem das respostas corresponde à das solicitações.

Por exemplo, suponha que você chame batchUpdate com quatro atualizações e apenas a terceira retorne informações. A resposta teria duas respostas vazias: a resposta à terceira solicitação e outra resposta vazia, nessa ordem.

Como outros usuários podem editar a apresentação, ela pode não refletir exatamente suas alterações. Suas mudanças podem ser alteradas em relação às mudanças do colaborador. Se não houver colaboradores, a apresentação vai refletir suas mudanças. De qualquer forma, as atualizações na sua solicitação são aplicadas de forma atômica.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
presentationId

string

A apresentação em que as atualizações serão aplicadas.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campos
requests[]

object (Request)

Uma lista de atualizações a serem aplicadas à apresentação.
writeControl

object (WriteControl)

Fornece controle sobre como as solicitações de gravação são executadas.

Corpo da resposta

Mensagem de resposta de uma atualização em lote.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campos
presentationId

string

A apresentação em que as atualizações foram aplicadas.
replies[]

object (Response)

A resposta das atualizações. Isso mapeia 1:1 com as atualizações, embora as respostas a algumas solicitações possam estar vazias.
writeControl

object (WriteControl)

O controle de gravação atualizado após a aplicação da solicitação.

Escopos de autorização

Requer um dos seguintes escopos do 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

Para mais informações, consulte o guia de autorização.

WriteControl

Fornece controle sobre como as solicitações de gravação são executadas.

Representação JSON 
{
  "requiredRevisionId": string
}
Campos
requiredRevisionId

string

O revision ID da apresentação necessária para a solicitação de gravação. Se especificado e o ID de revisão obrigatório não corresponder ao ID de revisão atual da apresentação, a solicitação não será processada e retornará um erro 400 de solicitação inválida.

Quando um ID de revisão obrigatório é retornado em uma resposta, ele indica o ID de revisão do documento após a solicitação ter sido aplicada.