Method: presentations.batchUpdate

Applique une ou plusieurs mises à jour à la présentation.

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

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

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

Étant donné que d'autres utilisateurs peuvent modifier la présentation, il est possible qu'elle ne reflète pas exactement vos modifications. En effet, vos modifications peuvent être modifiées par rapport à celles des collaborateurs. Si vous êtes le seul collaborateur, la présentation doit refléter vos modifications. Dans tous les cas, les modifications apportées à votre demande sont garanties d'être appliquées ensemble 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 modifications.

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 modifications à 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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Champs
presentationId

string

La présentation à laquelle les modifications ont été appliquées.
replies[]

object (Response)

Réponse aux mises à jour. Cette valeur correspond aux mises à jour, même si les réponses à certaines requêtes peuvent être vides.
writeControl

object (WriteControl)

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

enum (CommentUpdateState)

Indique si les modifications apportées aux commentaires ont été appliquées dans la requête par lot.

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 d'autorisation.

WriteControl

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

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

string

Le revision ID de la présentation requis pour la requête d'écriture. Si un ID de révision est spécifié et qu'il 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.

CommentUpdateState

État des mises à jour des commentaires dans la requête par lot.

Enums
COMMENT_UPDATE_STATE_UNSPECIFIED L'état des mises à jour des commentaires n'est pas spécifié.
NO_UPDATES_REQUESTED Aucune mise à jour de commentaire n'a été demandée dans la requête par lot.
ALL_SAVED Toutes les modifications demandées pour les commentaires ont été appliquées dans la requête par lot.
ALL_FAILED_UNKNOWN_REASON Échec de toutes les modifications demandées pour les commentaires.