Method: presentations.batchUpdate

Aplica una o más actualizaciones a la presentación.

Cada request se valida antes de aplicarse. Si alguna solicitud no es válida, fallará toda la solicitud y no se aplicará nada.

Algunas solicitudes tienen replies para brindarte información sobre cómo se aplican. Otras solicitudes no necesitan devolver información; cada una de ellas devuelve una respuesta vacía. El orden de las respuestas coincide con el de las solicitudes.

Por ejemplo, supongamos que llamas a batchUpdate con cuatro actualizaciones y solo la tercera devuelve información. La respuesta tendría dos respuestas vacías: la respuesta a la tercera solicitud y otra respuesta vacía, en ese orden.

Dado que otros usuarios pueden editar la presentación, es posible que esta no refleje exactamente tus cambios, ya que estos se pueden alterar en función de los cambios de los colaboradores. Si no hay colaboradores, la presentación debería reflejar tus cambios. En cualquier caso, se garantiza que las actualizaciones de tu solicitud se aplicarán de forma atómica.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
presentationId

string

Es la presentación a la que se aplicarán las actualizaciones.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campos
requests[]

object (Request)

Es una lista de actualizaciones que se aplicarán a la presentación.
writeControl

object (WriteControl)

Proporciona control sobre cómo se ejecutan las solicitudes de escritura.

Cuerpo de la respuesta

Es el mensaje de respuesta de una actualización por lotes.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Campos
presentationId

string

Es la presentación a la que se aplicaron las actualizaciones.
replies[]

object (Response)

Es la respuesta de las actualizaciones. Esto se correlaciona 1:1 con las actualizaciones, aunque las respuestas a algunas solicitudes pueden estar vacías.
writeControl

object (WriteControl)

Es el control de escritura actualizado después de aplicar la solicitud.
commentUpdateState

enum (CommentUpdateState)

Indica si se aplicaron actualizaciones de comentarios en la solicitud por lotes.

Permisos de autorización

Se necesita uno de los siguientes permisos 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 obtener más información, consulta la Guía de autorización.

WriteControl

Proporciona control sobre cómo se ejecutan las solicitudes de escritura.

Representación JSON 
{
  "requiredRevisionId": string
}
Campos
requiredRevisionId

string

Es el revision ID de la presentación que se requiere para la solicitud de escritura. Si se especifica y el ID de revisión requerido no coincide con el ID de revisión actual de la presentación, no se procesa la solicitud y se muestra un error de solicitud incorrecta 400.

Cuando se devuelve un ID de revisión obligatorio en una respuesta, se indica el ID de revisión del documento después de que se aplicó la solicitud.

CommentUpdateState

Es el estado de las actualizaciones de comentarios en la solicitud por lotes.

Enums
COMMENT_UPDATE_STATE_UNSPECIFIED No se especifica el estado de las actualizaciones de comentarios.
NO_UPDATES_REQUESTED No se solicitaron actualizaciones de comentarios en la solicitud por lotes.
ALL_SAVED Todas las actualizaciones de comentarios solicitadas se aplicaron en la solicitud por lotes.
ALL_FAILED_UNKNOWN_REASON No se pudieron realizar todas las actualizaciones de comentarios solicitadas.