Presentations

Endpoints to manage presentations

Presentation

Details about the presentation, including its ID, name, and milestone dates.

Properties

Name	Type	Description	Restrictions
created	Action	When the action was performed, and details about the user who did it	read-only
customFieldGroups	[string]	An array of Custom Field Group IDs applied to the presentation.
customFields	any	A map of ids to values representing Custom Fields on the presentation.
id	string	The unique identifier of the presentation	read-only
lock	PresentationLockType¦null	The type of lock applied to this presentation, if any. Note this property is not tied to revision and will always reflect the presentation’s current lock state.
modified	Action	When the action was performed, and details about the user who did it	read-only
name	string	Name of the presentation	read-only
revision	string¦null	The current revision of the presentation	read-only
slideCustomFieldGroups	[string]	An array of Custom Field Group IDs applied to all slides within the presentation.
slides	[Slide]	An array of information about the slides in the presentation. Included in the response only when the $expand query parameter is provided.	read-only
template	boolean	Whether the presentation is a template	read-only

Example

{
  "created": {
    "dateTime": "2020-10-28T15:03:27Z"
  },
  "customFieldGroups": [],
  "customFields": {
    "com.workiva.gsr.legal_entity": "Workiva"
  },
  "id": "124efa2a142f472ba1ceab34ed18915f",
  "lock": null,
  "modified": {
    "dateTime": "2020-10-28T15:03:27Z"
  },
  "name": "2019 Year-End Summary",
  "slideCustomFieldGroups": [],
  "slideLayouts": [
    {
      "id": "27f1b61a04ee4b0991bc73c631914e1d_103",
      "name": "Main Layout"
    },
    {
      "id": "c51b67d8cb1145c3baaa0637bb329c26_24",
      "name": "Title Slide"
    }
  ],
  "slides": [
    {
      "id": "27f1b61a04ee4b0991bc73c631914e1d_103",
      "name": "Slide"
    },
    {
      "id": "c51b67d8cb1145c3baaa0637bb329c26_24",
      "name": "Subslide"
    }
  ],
  "template": false
}

PresentationExport

Details about the presentation export, including its format and options

Properties

Name	Type	Description	Restrictions
format	string	The file format to export the presentation as - .PDF or .PPTX.	required
pdfOptions	PresentationToPdfOptions¦null	Optional options to export the presentation as a portable document file (.PDF). If no options are provided, all options default to False.
pptxOptions	PresentationToPptxOptions¦null	Optional options to export the presentation as a Microsoft Powerpoint File (.pptx). If no options are provided, all options default to False.
slides	[string]	The IDs of the slides of the presentation to export. Omit to export the entire presentation.

Enumerated Values

Property	Value
format	pdf
format	pptx

Example

{
  "format": "pptx",
  "pptxOptions": {
    "includeUnusedLayoutSlides": true
  },
  "slides": [
    "a8b3adb687644b27fafcb3a9875f0f0d_18",
    "a8b3adb687644b27fafcb3a9875f0f0d_19"
  ]
}

PresentationFiltersReapplication

A presentation filter reapply operation, which can reapply filters to a presentation and optionally ignore read-only filters.

Properties

Name	Type	Description	Restrictions
ignoreNonEditableFilters	boolean	Skip filters that cannot be reapplied (due to not having edit permissions or locked sections) instead of returning an error.

Example

{
  "ignoreNonEditableFilters": true
}

PresentationLockType

The type of the presentation lock.

Properties

Name	Type	Description	Restrictions
anonymous	string	The type of the presentation lock.

Enumerated Values

Property	Value
anonymous	locked

Example

"locked"

PresentationToPdfOptions

Optional options to export the presentation as a portable document file (.PDF). If no options are provided, all options default to False.

Properties

Name	Type	Description	Restrictions
includeAlternateRowFill	boolean	Whether to include alternate row fill in the presentation’s tables when exporting to .PDF. False by default.
includeComments	boolean	Whether to include comments when exporting to .PDF. False by default. When True, all comments are included, even those already resolved.
includeDraftWatermark	boolean	Whether to include a “Draft” watermark when exporting to .PDF. False by default.
includeHyperlinks	boolean	Whether to include hyperlinks when exporting to .PDF. False by default.
includeLeaderDots	boolean	Whether to include leader dots when exporting to .PDF. False by default.
tagForWebAccessibility	boolean	Whether to tag for web accessibility when exporting to .PDF. False by default.
useCmykColorspace	boolean	Whether to use CMYK colorspace when exporting to .PDF. False by default.

Example

{
  "includeAlternateRowFill": true,
  "includeComments": true,
  "includeDraftWatermark": true,
  "includeHyperlinks": true,
  "includeLeaderDots": true,
  "tagForWebAccessibility": true,
  "useCmykColorspace": true
}

PresentationTableCollectionResult

Returns a JSON object with data and @nextLink properties. data contains a list of ContentTable objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string¦null	Pagination link for next set of results
data	[ContentTable]	Tables contained by this presentation.	required
revision	string	The revision of the presentation.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "id": "WA7i5vbm7lNaEn6XT97lNaEn6XT9AtcW5vb22BJjMrqxmrujMrqxmru",
      "index": 0,
      "name": "Sheet 1",
      "parent": {
        "richText": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "type": "richText"
      }
    }
  ],
  "revision": "24601abc"
}

PresentationToPptxOptions

Optional options to export the presentation as a Microsoft Powerpoint File (.pptx). If no options are provided, all options default to False.

Properties

Name	Type	Description	Restrictions
includeUnusedLayoutSlides	boolean	Whether to include unused layout slides. False by default.

Example

{
  "includeUnusedLayoutSlides": true
}

Slide

Details about the slide, including its ID and name.

Properties

Name	Type	Description	Restrictions
children	[Slide]	An array of partial information about any slides within the slide.	read-only
customFields	any	A map of ids to values representing Custom Fields on the slide.
id	string¦null	The unique identifier of the slide	read-only
index	integer	The integer index of the slide relative to its parent slide (or to the presentation if no parent slide). The special value -1 may be used to position a slide at the end of its siblings list.
layoutSource	string¦null	The ID of the slide layout from which this slide’s layout is derived.
lock	SlideLockType¦null	The type of lock applied to this slide, if any. Note this property is not tied to revision and will always reflect the slide’s current lock state.
name	string	The name of the slide
parent	Slide¦null	The slide’s ID and name
revision	string	The revision of the slide	read-only
slideBody	DrawingRef	Reference to the Drawing content for this slide	read-only

Example

{
  "children": [
    {
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "name": "Risk factors"
    }
  ],
  "customFields": null,
  "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
  "index": 1,
  "layoutSource": "a8b3adb687644b27fafcb3a9875f0f0d_1",
  "lock": "lock",
  "name": "Risk factors",
  "parent": {
    "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
    "name": "Risk factors"
  },
  "revision": "24601abc",
  "slideBody": {
    "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
    "revision": "2c6438ab4541de6d"
  }
}

SlideLayout

Details about the slide layout, including its ID and name.

Properties

Name	Type	Description	Restrictions
id	string¦null	The unique identifier of the slide layout	read-only
index	integer	The integer index of the slide relative to its parent slide layout (or to the presentation if no parent slide layout). The special value -1 may be used to position a slide at the end of its siblings list.
lock	SlideLayoutLockType¦null	The type of lock applied to this slide layout, if any. Note this property is not tied to revision and will always reflect the slide layout’s current lock state.
name	string	The name of the slide layout
revision	string	The revision of the slide layout	read-only
slideLayoutBody	DrawingRef	Reference to the Drawing content for this slide layout	read-only

Example

{
  "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
  "index": 1,
  "lock": "lock",
  "name": "Title Page",
  "revision": "24601abc",
  "slideLayoutBody": {
    "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
    "revision": "2c6438ab4541de6d"
  }
}

SlideLayoutLockType

A lock applied to a slide layout.

Properties

Name	Type	Description	Restrictions
anonymous	string	A lock applied to a slide layout.

Enumerated Values

Property	Value
anonymous	lock

Example

"lock"

SlideLayoutsListResult

Returns a JSON object with data and @nextLink properties. data contains a list of SlideLayout objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string	Pagination link for next set of results
data	[SlideLayout]	Details about the slide layout, including its ID and name.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "index": 1,
      "lock": "lock",
      "name": "Title Page",
      "revision": "24601abc",
      "slideLayoutBody": {
        "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "revision": "2c6438ab4541de6d"
      }
    }
  ]
}

SlideLockType

A lock applied to a slide.

Properties

Name	Type	Description	Restrictions
anonymous	string	A lock applied to a slide.

Enumerated Values

Property	Value
anonymous	lock

Example

"lock"

SlidesListResult

Returns a JSON object with data and @nextLink properties. data contains a list of Slide objects, and @nextLink provides the URL to the next set of results. If there are no additional results, @nextLink doesn’t appear. If the request returns no results at all, data contains an empty array.

Properties

Name	Type	Description	Restrictions
@nextLink	string	Pagination link for next set of results
data	[Slide]	Details about the slide, including its ID and name.	required

Example

{
  "@nextLink": "<opaque_url>",
  "data": [
    {
      "children": [
        null
      ],
      "customFields": null,
      "id": "a8b3adb687644b27fafcb3a9875f0f0d_18",
      "index": 1,
      "layoutSource": "a8b3adb687644b27fafcb3a9875f0f0d_1",
      "lock": "lock",
      "name": "Risk factors",
      "parent": null,
      "revision": "24601abc",
      "slideBody": {
        "drawing": "WA2NiYGJgm7cWr4W6Ka9BHScz56m2AT2FqTmBgekyk399M99I9Bb69BoEt3WHCag",
        "revision": "2c6438ab4541de6d"
      }
    }
  ]
}