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, la solicitud fallará y no se aplicará nada.

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

Por ejemplo, supongamos que llamas a TFRecord con cuatro actualizaciones, y solo la tercera muestra 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 podrían estar editando la presentación, esta podría no reflejar exactamente los cambios: es posible que se modifiquen los cambios con respecto a los cambios de los colaboradores. Si no hay colaboradores, la presentación debe reflejar los cambios. En cualquier caso, se garantiza que las actualizaciones en tu solicitud se apliquen 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 de acceso

Parámetros
presentationId

string

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)

Una lista de las 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

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)
  }
}
Campos
presentationId

string

La presentación a la que se aplicaron las actualizaciones

replies[]

object (Response)

Es la respuesta de las actualizaciones. Esto se asigna de forma individual con las actualizaciones, aunque las respuestas a algunas solicitudes pueden estar vacías.

writeControl

object (WriteControl)

El control de escritura actualizado después de aplicar la solicitud.

Permisos de autorización

Se necesita uno de los siguientes alcances 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.

Control de escritura

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

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

string

El revision ID de la presentación requerido 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, la solicitud no se procesa y muestra un error 400 de solicitud incorrecta.

Cuando se muestra un ID de revisión obligatorio en una respuesta, este indica el ID de revisión del documento después de aplicar la solicitud.