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, a solicitação inteira 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. Cada uma delas retorna uma resposta vazia. A ordem das respostas corresponde à das solicitações.

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

Como outros usuários podem estar editando a apresentação, ela pode não refletir exatamente as suas alterações: as suas alterações podem ser alteradas em relação às alterações do colaborador. Se não houver colaboradores, a apresentação deve refletir as alterações. De qualquer forma, as atualizações em sua solicitação serão 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 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 à qual as atualizações foram aplicadas.
replies[]

object (Response)

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

object (WriteControl)

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

Escopos de autorização

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

GravarControle

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 necessário não corresponder ao ID de revisão atual da apresentação, a solicitação não é processada e retorna um erro de solicitação inválida 400.

Quando um código de revisão necessário é retornado em uma resposta, ele indica o código de revisão do documento depois que a solicitação é aplicada.