A hypertext link.
Methods
Method | Return type | Brief description |
---|---|---|
getLinkType() | LinkType | Returns the LinkType . |
getLinkedSlide() | Slide | Returns the linked Slide for non-URL links types, if it exists. |
getSlideId() | String | Returns the ID of the linked Slide or null if the LinkType is not
LinkType.SLIDE_ID . |
getSlideIndex() | Integer | Returns the zero-based index of the linked Slide or null if the LinkType is not LinkType.SLIDE_INDEX . |
getSlidePosition() | SlidePosition | Returns the SlidePosition of the linked Slide or null if the LinkType is not LinkType.SLIDE_POSITION . |
getUrl() | String | Returns the URL to the external web page or null if the LinkType is not LinkType.URL . |
Detailed documentation
getLinkType()
Returns the LinkType
.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLinkedSlide()
Returns the linked Slide
for non-URL links types, if it exists. Returns null
if
the slide doesn't exist in the presentation, or if the LinkType
is LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() != SlidesApp.LinkType.URL) { Logger.log('Shape has link to slide: ' + link.getLinkedSlide()); }
Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideId()
Returns the ID of the linked Slide
or null
if the LinkType
is not
LinkType.SLIDE_ID
.
Note that the slide with the returned ID might not exist.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_ID) { Logger.log('Shape has link to slide with ID: ' + link.getSlideId()); }
Return
String
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideIndex()
Returns the zero-based index of the linked Slide
or null
if the LinkType
is not LinkType.SLIDE_INDEX
.
Note that the slide at the returned index might not exist.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_INDEX) { Logger.log('Shape has link to slide with index: ' + link.getSlideIndex()); }
Return
Integer
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlidePosition()
Returns the SlidePosition
of the linked Slide
or null
if the LinkType
is not LinkType.SLIDE_POSITION
.
Note that the slide with the returned relative position might not exist.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_POSITION) { Logger.log('Shape has link to slide with relative position: ' + link.getSlidePosition()); }
Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getUrl()
Returns the URL to the external web page or null
if the LinkType
is not LinkType.URL
.
var link = shape.getLink(); if (link != null && link.getLinkType() == SlidesApp.LinkType.URL) { Logger.log('Shape has link to URL: ' + link.getUrl()); }
Return
String
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations