Get

Gets the latest version of the specified page in the presentation

2 variables
117 variables

Gets the latest version of the specified page in the presentation

Authorization

To use this building block you will have to grant access to at least one of the following scopes:

  • See, edit, create, and delete all of your Google Drive files
  • View and manage Google Drive files and folders that you have opened or created with this app
  • See and download all your Google Drive files
  • View and manage your Google Slides presentations
  • View your Google Slides presentations

Input

This building block consumes 2 input parameters

  = Parameter name
  = Format

presentationId STRING Required

The ID of the presentation to retrieve

pageObjectId STRING Required

The object ID of the page to retrieve

Output

This building block provides 117 output parameters

  = Parameter name
  = Format

masterProperties OBJECT

The properties of Page that are only relevant for pages with page_type MASTER

masterProperties.displayName STRING

The human-readable name of the master

objectId STRING

The object ID for this page. Object IDs used by Page and PageElement share the same namespace

revisionId STRING

The revision ID of the presentation containing this page. Can be used in update requests to assert that the presentation revision hasn't changed since the last read operation. Only populated if the user has edit access to the presentation.

The format of the revision ID may change over time, so it should be treated opaquely. A returned revision ID is only guaranteed to be valid for 24 hours after it has been returned and cannot be shared across users. If the revision ID is unchanged between calls, then the presentation has not changed. Conversely, a changed ID (for the same presentation and user) usually means the presentation has been updated; however, a changed ID can also be due to internal factors such as ID format changes

layoutProperties OBJECT

The properties of Page are only relevant for pages with page_type LAYOUT

layoutProperties.masterObjectId STRING

The object ID of the master that this layout is based on

layoutProperties.name STRING

The name of the layout

layoutProperties.displayName STRING

The human-readable name of the layout

pageElements[] OBJECT

A visual element rendered on a page

pageElements[].wordArt OBJECT

A PageElement kind representing word art

pageElements[].wordArt.renderedText STRING

The text rendered as word art

pageElements[].table OBJECT

A PageElement kind representing a table

pageElements[].table.horizontalBorderRows[] OBJECT

Contents of each border row in a table

pageElements[].table.verticalBorderRows[] OBJECT

Contents of each border row in a table

pageElements[].table.rows INTEGER

Number of rows in the table

pageElements[].table.tableColumns[] OBJECT

Properties of each column in a table

pageElements[].table.columns INTEGER

Number of columns in the table

pageElements[].table.tableRows[] OBJECT

Properties and contents of each row in a table

pageElements[].objectId STRING

The object ID for this page element. Object IDs used by google.apps.slides.v1.Page and google.apps.slides.v1.PageElement share the same namespace

pageElements[].transform OBJECT

AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ] to transform source coordinates (x,y) into destination coordinates (x', y') according to:

  x'  x  =   shear_y  scale_y  translate_y  
  1  [ 1 ]

After transformation,

 x' = scale_x * x + shear_x * y + translate_x;
 y' = scale_y * y + shear_y * x + translate_y;

This message is therefore composed of these six matrix elements

pageElements[].transform.shearX NUMBER

The X coordinate shearing element

pageElements[].transform.scaleY NUMBER

The Y coordinate scaling element

pageElements[].transform.translateY NUMBER

The Y coordinate translation element

pageElements[].transform.translateX NUMBER

The X coordinate translation element

pageElements[].transform.shearY NUMBER

The Y coordinate shearing element

pageElements[].transform.unit ENUMERATION

The units for translate elements

pageElements[].transform.scaleX NUMBER

The X coordinate scaling element

pageElements[].shape OBJECT

A PageElement kind representing a generic shape that does not have a more specific classification

pageElements[].shape.shapeType ENUMERATION

The type of the shape

pageElements[].shape.text OBJECT

The general text content. The text must reside in a compatible shape (e.g. text box or rectangle) or a table cell in a page

pageElements[].shape.text.lists OBJECT

The bulleted lists contained in this text, keyed by list ID

pageElements[].shape.placeholder OBJECT

The placeholder information that uniquely identifies a placeholder shape

pageElements[].shape.placeholder.parentObjectId STRING

The object ID of this shape's parent placeholder. If unset, the parent placeholder shape does not exist, so the shape does not inherit properties from any other shape

pageElements[].shape.placeholder.index INTEGER

The index of the placeholder. If the same placeholder types are present in the same page, they would have different index values

pageElements[].shape.placeholder.type ENUMERATION

The type of the placeholder

pageElements[].shape.shapeProperties OBJECT

The properties of a Shape.

If the shape is a placeholder shape as determined by the placeholder field, then these properties may be inherited from a parent placeholder shape. Determining the rendered value of the property depends on the corresponding property_state field value

pageElements[].shape.shapeProperties.contentAlignment ENUMERATION

The alignment of the content in the shape. If unspecified, the alignment is inherited from a parent placeholder if it exists. If the shape has no parent, the default alignment matches the alignment for new shapes created in the Slides editor

pageElements[].line OBJECT

A PageElement kind representing a non-connector line, straight connector, curved connector, or bent connector

pageElements[].line.lineType ENUMERATION

The type of the line

pageElements[].line.lineCategory ENUMERATION

The category of the line.

It matches the category specified in CreateLineRequest, and can be updated with UpdateLineCategoryRequest

pageElements[].line.lineProperties OBJECT

The properties of the Line.

When unset, these fields default to values that match the appearance of new lines created in the Slides editor

pageElements[].line.lineProperties.dashStyle ENUMERATION

The dash style of the line

pageElements[].line.lineProperties.startArrow ENUMERATION

The style of the arrow at the beginning of the line

pageElements[].line.lineProperties.endArrow ENUMERATION

The style of the arrow at the end of the line

pageElements[].description STRING

The description of the page element. Combined with title to display alt text

pageElements[].elementGroup OBJECT

A PageElement kind representing a joined collection of PageElements

pageElements[].elementGroup.children[] OBJECT

A visual element rendered on a page

pageElements[].image OBJECT

A PageElement kind representing an image

pageElements[].image.imageProperties OBJECT

The properties of the Image

pageElements[].image.imageProperties.brightness FLOAT

The brightness effect of the image. The value should be in the interval [-1.0, 1.0], where 0 means no effect. This property is read-only

pageElements[].image.imageProperties.transparency FLOAT

The transparency effect of the image. The value should be in the interval [0.0, 1.0], where 0 means no effect and 1 means completely transparent. This property is read-only

pageElements[].image.imageProperties.contrast FLOAT

The contrast effect of the image. The value should be in the interval [-1.0, 1.0], where 0 means no effect. This property is read-only

pageElements[].image.contentUrl STRING

An URL to an image with a default lifetime of 30 minutes. This URL is tagged with the account of the requester. Anyone with the URL effectively accesses the image as the original requester. Access to the image may be lost if the presentation's sharing settings change

pageElements[].image.sourceUrl STRING

The source URL is the URL used to insert the image. The source URL can be empty

pageElements[].size OBJECT

A width and height

pageElements[].size.height OBJECT

A magnitude in a single direction in the specified units

pageElements[].size.height.magnitude NUMBER

The magnitude

pageElements[].size.height.unit ENUMERATION

The units for magnitude

pageElements[].size.width OBJECT

A magnitude in a single direction in the specified units

pageElements[].size.width.magnitude NUMBER

The magnitude

pageElements[].size.width.unit ENUMERATION

The units for magnitude

pageElements[].sheetsChart OBJECT

A PageElement kind representing a linked chart embedded from Google Sheets

pageElements[].sheetsChart.chartId INTEGER

The ID of the specific chart in the Google Sheets spreadsheet that is embedded

pageElements[].sheetsChart.sheetsChartProperties OBJECT

The properties of the SheetsChart

pageElements[].sheetsChart.contentUrl STRING

The URL of an image of the embedded chart, with a default lifetime of 30 minutes. This URL is tagged with the account of the requester. Anyone with the URL effectively accesses the image as the original requester. Access to the image may be lost if the presentation's sharing settings change

pageElements[].sheetsChart.spreadsheetId STRING

The ID of the Google Sheets spreadsheet that contains the source chart

pageElements[].title STRING

The title of the page element. Combined with description to display alt text

pageElements[].video OBJECT

A PageElement kind representing a video

pageElements[].video.source ENUMERATION

The video source

pageElements[].video.url STRING

An URL to a video. The URL is valid as long as the source video exists and sharing settings do not change

pageElements[].video.id STRING

The video source's unique identifier for this video

pageElements[].video.videoProperties OBJECT

The properties of the Video

pageElements[].video.videoProperties.autoPlay BOOLEAN

Whether to enable video autoplay when the page is displayed in present mode. Defaults to false

pageElements[].video.videoProperties.end INTEGER

The time at which to end playback, measured in seconds from the beginning of the video. If set, the end time should be after the start time. If not set or if you set this to a value that exceeds the video's length, the video will be played until its end

pageElements[].video.videoProperties.mute BOOLEAN

Whether to mute the audio during video playback. Defaults to false

pageElements[].video.videoProperties.start INTEGER

The time at which to start playback, measured in seconds from the beginning of the video. If set, the start time should be before the end time. If you set this to a value that exceeds the video's length in seconds, the video will be played from the last second. If not set, the video will be played from the beginning

pageType ENUMERATION

The type of the page

notesProperties OBJECT

The properties of Page that are only relevant for pages with page_type NOTES

notesProperties.speakerNotesObjectId STRING

The object ID of the shape on this notes page that contains the speaker notes for the corresponding slide. The actual shape may not always exist on the notes page. Inserting text using this object ID will automatically create the shape. In this case, the actual shape may have different object ID. The GetPresentation or GetPage action will always return the latest object ID

slideProperties OBJECT

The properties of Page that are only relevant for pages with page_type SLIDE

slideProperties.notesPage OBJECT

A page in a presentation

slideProperties.notesPage.masterProperties OBJECT

The properties of Page that are only relevant for pages with page_type MASTER

slideProperties.notesPage.masterProperties.displayName STRING

The human-readable name of the master

slideProperties.notesPage.objectId STRING

The object ID for this page. Object IDs used by Page and PageElement share the same namespace

slideProperties.notesPage.revisionId STRING

The revision ID of the presentation containing this page. Can be used in update requests to assert that the presentation revision hasn't changed since the last read operation. Only populated if the user has edit access to the presentation.

The format of the revision ID may change over time, so it should be treated opaquely. A returned revision ID is only guaranteed to be valid for 24 hours after it has been returned and cannot be shared across users. If the revision ID is unchanged between calls, then the presentation has not changed. Conversely, a changed ID (for the same presentation and user) usually means the presentation has been updated; however, a changed ID can also be due to internal factors such as ID format changes

slideProperties.notesPage.layoutProperties OBJECT

The properties of Page are only relevant for pages with page_type LAYOUT

slideProperties.notesPage.layoutProperties.masterObjectId STRING

The object ID of the master that this layout is based on

slideProperties.notesPage.layoutProperties.name STRING

The name of the layout

slideProperties.notesPage.layoutProperties.displayName STRING

The human-readable name of the layout

slideProperties.notesPage.pageElements[] OBJECT

A visual element rendered on a page

slideProperties.notesPage.pageElements[].objectId STRING

The object ID for this page element. Object IDs used by google.apps.slides.v1.Page and google.apps.slides.v1.PageElement share the same namespace

slideProperties.notesPage.pageElements[].description STRING

The description of the page element. Combined with title to display alt text

slideProperties.notesPage.pageElements[].title STRING

The title of the page element. Combined with description to display alt text

slideProperties.notesPage.pageType ENUMERATION

The type of the page

slideProperties.notesPage.notesProperties OBJECT

The properties of Page that are only relevant for pages with page_type NOTES

slideProperties.notesPage.notesProperties.speakerNotesObjectId STRING

The object ID of the shape on this notes page that contains the speaker notes for the corresponding slide. The actual shape may not always exist on the notes page. Inserting text using this object ID will automatically create the shape. In this case, the actual shape may have different object ID. The GetPresentation or GetPage action will always return the latest object ID

slideProperties.notesPage.slideProperties OBJECT

The properties of Page that are only relevant for pages with page_type SLIDE

slideProperties.notesPage.slideProperties.notesPage OBJECT

A page in a presentation

slideProperties.notesPage.slideProperties.layoutObjectId STRING

The object ID of the layout that this slide is based on. This property is read-only

slideProperties.notesPage.slideProperties.masterObjectId STRING

The object ID of the master that this slide is based on. This property is read-only

slideProperties.notesPage.pageProperties OBJECT

The properties of the Page.

The page will inherit properties from the parent page. Depending on the page type the hierarchy is defined in either SlideProperties or LayoutProperties

slideProperties.notesPage.pageProperties.pageBackgroundFill OBJECT

The page background fill

slideProperties.notesPage.pageProperties.colorScheme OBJECT

The palette of predefined colors for a page

slideProperties.layoutObjectId STRING

The object ID of the layout that this slide is based on. This property is read-only

slideProperties.masterObjectId STRING

The object ID of the master that this slide is based on. This property is read-only

pageProperties OBJECT

The properties of the Page.

The page will inherit properties from the parent page. Depending on the page type the hierarchy is defined in either SlideProperties or LayoutProperties

pageProperties.pageBackgroundFill OBJECT

The page background fill

pageProperties.pageBackgroundFill.propertyState ENUMERATION

The background fill property state.

Updating the fill on a page will implicitly update this field to RENDERED, unless another value is specified in the same request. To have no fill on a page, set this field to NOT_RENDERED. In this case, any other fill fields set in the same request will be ignored

pageProperties.pageBackgroundFill.stretchedPictureFill OBJECT

The stretched picture fill. The page or page element is filled entirely with the specified picture. The picture is stretched to fit its container

pageProperties.pageBackgroundFill.stretchedPictureFill.contentUrl STRING

Reading the content_url:

An URL to a picture with a default lifetime of 30 minutes. This URL is tagged with the account of the requester. Anyone with the URL effectively accesses the picture as the original requester. Access to the picture may be lost if the presentation's sharing settings change.

Writing the content_url:

The picture is fetched once at insertion time and a copy is stored for display inside the presentation. Pictures must be less than 50MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF format.

The provided URL can be at most 2 kB in length

pageProperties.pageBackgroundFill.stretchedPictureFill.size OBJECT

A width and height

pageProperties.pageBackgroundFill.solidFill OBJECT

A solid color fill. The page or page element is filled entirely with the specified color value.

If any field is unset, its value may be inherited from a parent placeholder if it exists

pageProperties.pageBackgroundFill.solidFill.alpha FLOAT

The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation:

pixel color = alpha * (color) + (1.0 - alpha) * (background color)

This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color

pageProperties.pageBackgroundFill.solidFill.color OBJECT

A themeable solid color value

pageProperties.colorScheme OBJECT

The palette of predefined colors for a page

pageProperties.colorScheme.colors[] OBJECT

A pair mapping a theme color type to the concrete color it represents

pageProperties.colorScheme.colors[].type ENUMERATION

The type of the theme color