Method: presentations.batchUpdate

Applique une ou plusieurs modifications à la présentation.

Chaque request est validée avant d'être appliquée. Si une requête n'est pas valide, toute la requête échouera et rien ne sera appliqué.

Certaines requêtes comportent des replies pour vous donner des informations sur leur application. Les autres requêtes n'ont pas besoin de renvoyer d'informations. renvoient chacune une réponse vide. L'ordre des réponses correspond à celui des requêtes.

Par exemple, supposons que vous appelez batchUpdate avec quatre mises à jour et que seule la troisième renvoie des informations. La réponse aurait deux réponses vides: la réponse à la troisième demande et une autre réponse vide, dans cet ordre.

Étant donné que d'autres utilisateurs sont en train de modifier la présentation, il est possible que la présentation ne reflète pas exactement vos modifications. En effet, celles-ci peuvent l'être également par les collaborateurs. En l'absence de collaborateurs, la présentation doit refléter vos modifications. Dans tous les cas, l'application des mises à jour de votre requête est garantie de manière atomique.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
presentationId

string

Présentation à laquelle appliquer les mises à jour.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Champs
requests[]

object (Request)

Liste des mises à jour à appliquer à la présentation.

writeControl

object (WriteControl)

Permet de contrôler l'exécution des requêtes d'écriture.

Corps de la réponse

Message de réponse d'une mise à jour groupée.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Champs
presentationId

string

Présentation à laquelle les mises à jour ont été appliquées.

replies[]

object (Response)

Réponse aux mises à jour. Il correspond à la version 1:1 des mises à jour, bien que les réponses à certaines demandes puissent être vides.

writeControl

object (WriteControl)

Contrôle d'écriture mis à jour après l'application de la requête.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le Guide relatif aux autorisations.

WriteControl

Permet de contrôler l'exécution des requêtes d'écriture.

Représentation JSON
{
  "requiredRevisionId": string
}
Champs
requiredRevisionId

string

revision ID de la présentation requis pour la requête d'écriture. Si cet ID est spécifié et que l'ID de révision requis ne correspond pas à l'ID de révision actuel de la présentation, la requête n'est pas traitée et renvoie une erreur 400 (requête incorrecte).

Lorsqu'un ID de révision requis est renvoyé dans une réponse, il indique l'ID de révision du document après l'application de la requête.