Method: presentations.batchUpdate

Applique une ou plusieurs modifications à la présentation.

Chaque request est validée avant d'être appliquée. Si l'une des requêtes n'est pas valide, l'ensemble de la requête échoue et aucune modification n'est appliquée.

Certaines requêtes contiennent replies pour vous fournir 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 comportera deux réponses vides: la réponse à la troisième requête et une autre réponse vide, dans cet ordre.

D'autres utilisateurs peuvent modifier la présentation. Il est donc possible qu'elle ne reflète pas exactement vos modifications. Si aucun collaborateur n'est associé, la présentation doit refléter vos modifications. Dans tous les cas, les mises à jour de votre requête sont appliquées 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 modifications à appliquer à la présentation.
writeControl

object (WriteControl)

Permet de contrôler la façon dont les requêtes d'écriture sont exécutées.

Corps de la réponse

Message de réponse d'une mise à jour par lot.

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. Cette correspondance est un à un avec les mises à jour, bien que les réponses à certaines requêtes 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 d'autorisation.

WriteControl

Permet de contrôler la façon dont les requêtes d'écriture sont exécutées.

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

string

revision ID de la présentation requise pour la requête d'écriture. Si l'ID de révision requis 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 une erreur 400 est renvoyée.

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