A hypertext link.
Methods
Method | Return type | Brief description |
---|---|---|
LinkType
|
Returns the LinkType
. |
|
Slide
|
Returns the linked Slide
for non-URL links types, if it exists. |
|
String
|
Returns the ID of the linked Slide
or null
if the LinkType
is not LinkType.SLIDE_ID
. |
|
Integer
|
Returns the zero-based index of the linked Slide
or null
if the LinkType
is not LinkType.SLIDE_INDEX
. |
|
SlidePosition
|
Returns the SlidePosition
of the linked Slide
or null
if the LinkType
is not LinkType.SLIDE_POSITION
. |
|
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