api reference · v1

Every Slides method, from the index.

All 5 methods of the Slides API, rendered at build time from the committed Discovery index the grr binary embeds — the same data grr api describe reads at runtime. Flags are kebab-cased parameter names: userId is --user-id.

5 methods · v1 · revision 20260921

slides.presentations

3 methods

slides.presentations.batchUpdate

POST

grr slides presentations batchUpdate v1/presentations/{presentationId}:batchUpdate

Applies one or more updates to the presentation. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need

Parameter Type Required Repeated Location Description Enum values
presentationId string yes — path The presentation to apply the updates to. —

https://www.googleapis.com/auth/spreadsheets.readonly least privilege

6 scopes
  • 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

grr slides presentations batchUpdate
grr slides presentations batchUpdate --presentation-id <presentation-id> --body-file ./body.json

slides.presentations.create

POST

grr slides presentations create v1/presentations

Creates a blank presentation using the title given in the request. If a `presentationId` is provided, it is used as the ID of the new presentation. Otherwise, a new ID is generated. Other fields in the request, including any provided content, are ignored. Returns the created presentation.

No parameters.

https://www.googleapis.com/auth/presentations least privilege

3 scopes
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

grr slides presentations create
grr slides presentations create --body-file ./body.json

slides.presentations.get

GET

grr slides presentations get v1/presentations/{+presentationId}

Gets the latest version of the specified presentation.

Parameter Type Required Repeated Location Description Enum values
commentsViewMode string — — query The comments view mode to apply to the presentation. This allows viewing the presentation with comments omitted or included. If one is not specified, COMMENTS_V COMMENTS_VIEW_MODE_UNSPECIFIED · COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS · COMMENTS_VIEW_MODE_OMITTED · COMMENTS_VIEW_MODE_INCLUDED
presentationId string yes — path The ID of the presentation to retrieve. —

https://www.googleapis.com/auth/presentations.readonly least privilege

5 scopes
  • 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/presentations.readonly

grr slides presentations get
grr slides presentations get --presentation-id <presentation-id>

slides.presentations.pages

2 methods

slides.presentations.pages.get

GET

grr slides presentations pages get v1/presentations/{presentationId}/pages/{pageObjectId}

Gets the latest version of the specified page in the presentation.

Parameter Type Required Repeated Location Description Enum values
commentsViewMode string — — query The comments view mode to apply to the page. This allows viewing the page with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED COMMENTS_VIEW_MODE_UNSPECIFIED · COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS · COMMENTS_VIEW_MODE_OMITTED · COMMENTS_VIEW_MODE_INCLUDED
pageObjectId string yes — path The object ID of the page to retrieve. —
presentationId string yes — path The ID of the presentation to retrieve. —

https://www.googleapis.com/auth/presentations.readonly least privilege

5 scopes
  • 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/presentations.readonly

grr slides presentations pages get
grr slides presentations pages get --page-object-id <page-object-id> --presentation-id <presentation-id>

slides.presentations.pages.getThumbnail

GET

grr slides presentations pages getThumbnail v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

Generates a thumbnail of the latest version of the specified page in the presentation and returns a URL to the thumbnail image. This request counts as an expensive read request for quota purposes.

Parameter Type Required Repeated Location Description Enum values
pageObjectId string yes — path The object ID of the page whose thumbnail to retrieve. —
presentationId string yes — path The ID of the presentation to retrieve. —
thumbnailProperties.mimeType string — — query The optional mime type of the thumbnail image. If you don't specify the mime type, the mime type defaults to PNG. PNG
thumbnailProperties.thumbnailSize string — — query The optional thumbnail image size. If you don't specify the size, the server chooses a default size of the image. THUMBNAIL_SIZE_UNSPECIFIED · LARGE · MEDIUM · SMALL · WIDTH2000_PX

https://www.googleapis.com/auth/presentations.readonly least privilege

5 scopes
  • 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/presentations.readonly

grr slides presentations pages getThumbnail
grr slides presentations pages getThumbnail --page-object-id <page-object-id> --presentation-id <presentation-id>