- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Demander
- CreateSlideRequest
- LayoutReference
- prédéfinisLayout
- LayoutPlaceholderIdMapping
- CreateShapeRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnsRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- ReplaceAllTextRequest
- SubstringMatchCriteria
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode (Mode d'application).
- UpdateSlidesPositionRequest
- DeleteTextRequest
- Plage
- Type
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- Mode d'association
- CreateLineRequest
- Catégorie
- RefreshSheetsChartRequest
- UpdateShapePropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- UpdatePagePropertiesRequest
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphBulletsRequest
- BulletGlyphe prédéfini
- ReplaceAllShapesWithImageRequest
- ReplaceMethod.
- ImageReplaceMethod.
- DuplicateObjectRequest
- UpdateTextStyleRequest
- ReplaceAllShapesWithSheetsChartRequest
- Mode d'association
- DeleteParagraphBulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- BorderPosition
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- ReplaceImageRequest
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- Opération ZOrder
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- Réponse
- CreateSlideResponse
- CreateShapeResponse
- CreateTableResponse
- ReplaceAllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- ReplaceAllShapesWithImageResponse
- DuplicateObjectResponse
- ReplaceAllShapesWithSheetsChartResponse
- GroupObjectsResponse
- Essayer
Applique une ou plusieurs mises à jour de la présentation.
Chaque request
est validé avant d'être appliqué. Si une requête n'est pas valide, l'intégralité de la requête échoue, et rien n'est appliqué.
Certaines requêtes comportent replies
pour vous fournir des informations sur la manière dont elles sont appliquées. Il n'est pas nécessaire que les autres requêtes renvoient des informations, qui 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 contiendra deux réponses vides: la réponse à la troisième requête et une autre, dans cet ordre.
Étant donné que d'autres utilisateurs peuvent modifier la présentation, il est possible que celle-ci ne reflète pas exactement vos modifications: celles apportées par vos collaborateurs peuvent être modifiées en conséquence. En l'absence de collaborateurs, la présentation doit refléter vos modifications. Dans tous les cas, les mises à jour de votre requête seront 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 |
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 ( |
Champs | |
---|---|
requests[] |
Liste des modifications à appliquer à la présentation. |
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 ( |
Champs | |
---|---|
presentationId |
Présentation à laquelle les mises à jour ont été appliquées. |
replies[] |
Réponse des mises à jour. Cette méthode permet un mappage individuel avec les mises à jour, mais les réponses à certaines requêtes peuvent être vides. |
writeControl |
Mise à jour du contrôle de l'écriture 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 sur les autorisations.
Commande d'écriture
Permet de contrôler l'exécution des requêtes d'écriture.
Représentation JSON |
---|
{ "requiredRevisionId": string } |
Champs | |
---|---|
requiredRevisionId |
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. |