Class Link

連結

超文字連結。

方法

方法傳回類型簡短說明
getLinkType()LinkType傳回 LinkType。
getLinkedSlide()Slide傳回非網址連結類型的已連結 Slide (如果有)。
getSlideId()String如果 LinkType 不是 LinkType.SLIDE_ID，則會傳回已連結的 Slide 或 null ID。
getSlideIndex()Integer如果 LinkType 不是 LinkType.SLIDE_INDEX，則傳回已連結 Slide 的零起算索引，或 null。
getSlidePosition()SlidePosition如果 LinkType 不是 LinkType.SLIDE_POSITION，則會傳回已連結 Slide 或 null 的 SlidePosition。
getUrl()String如果 LinkType 不是 LinkType.URL，則傳回外部網頁的網址或 null。

內容詳盡的說明文件

getLinkType()

傳回 LinkType。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

回攻員

LinkType

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLinkedSlide()

傳回非網址連結類型的已連結 Slide (如果有)。如果簡報中沒有投影片，或 LinkType 為 LinkType.URL，則會傳回 null。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() !== SlidesApp.LinkType.URL) {
  Logger.log(`Shape has link to slide: ${link.getLinkedSlide()}`);
}

回攻員

Slide

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSlideId()

如果 LinkType 不是 LinkType.SLIDE_ID，則會傳回已連結的 Slide 或 null ID。

請注意，返回的 ID 可能不存在於投影片中。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_ID) {
  Logger.log(`Shape has link to slide with ID: ${link.getSlideId()}`);
}

回攻員

String

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSlideIndex()

如果 LinkType 不是 LinkType.SLIDE_INDEX，則傳回已連結 Slide 的零起始索引，或 null。

請注意，傳回索引的投影片可能不存在。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_INDEX) {
  Logger.log(`Shape has link to slide with index: ${link.getSlideIndex()}`);
}

回攻員

Integer

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSlidePosition()

如果 LinkType 不是 LinkType.SLIDE_POSITION，則會傳回已連結 Slide 或 null 的 SlidePosition。

請注意，可能不存在具有傳回相對位置的幻燈片。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.SLIDE_POSITION) {
  Logger.log(
      `Shape has link to slide with relative position: ${
          link.getSlidePosition()}`,
  );
}

回攻員

SlidePosition

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getUrl()

如果 LinkType 不是 LinkType.URL，則傳回外部網頁的網址或 null。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null && link.getLinkType() === SlidesApp.LinkType.URL) {
  Logger.log(`Shape has link to URL: ${link.getUrl()}`);
}

回攻員

String

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations