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 falhará e nada será aplicado.

Algumas solicitações têm replies para fornecer informações sobre como são aplicadas. Outras solicitações não precisam retornar informações. retornar 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: uma para a terceira solicitação e outra vazia, nessa ordem.

Como outros usuários podem estar editando a apresentação, ela pode não refletir exatamente suas alterações: suas alterações podem ser alteradas em relação às alterações dos colaboradores. Se não houver colaboradores, a apresentação deverá refletir as alterações que você fez. De qualquer forma, as atualizações na solicitação têm a garantia de serem aplicadas atomicamente em conjunto.

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 à qual aplicar as atualizações.

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 para aplicar à 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 é mapeado individualmente 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ário 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 de solicitação 400 inválida.

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