Class Link

Link

Um link de hipertexto.

Métodos

MétodoTipo de retornoBreve descrição
getLinkType()LinkTypeRetorna LinkType.
getLinkedSlide()SlideRetorna o Slide vinculado para tipos de links que não são URLs, se houver.
getSlideId()StringRetorna o ID do Slide ou null vinculado, se o LinkType não for LinkType.SLIDE_ID.
getSlideIndex()IntegerRetorna o índice baseado em zero do Slide ou null vinculado, se o LinkType não for LinkType.SLIDE_INDEX.
getSlidePosition()SlidePositionRetorna o SlidePosition do Slide ou null vinculado se o LinkType não for LinkType.SLIDE_POSITION.
getUrl()StringRetorna o URL da página da Web externa ou null se o LinkType não for LinkType.URL.

Documentação detalhada

getLinkType()

Retorna 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()}`);
}

Retornar

LinkType

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getLinkedSlide()

Retorna o Slide vinculado para tipos de links que não são URLs, se houver. Retorna null se o slide não existir na apresentação ou se o LinkType for LinkType.URL.

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()}`);
}

Retornar

Slide

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getSlideId()

Retorna o ID do Slide ou null vinculado, se o LinkType não for LinkType.SLIDE_ID.

O slide com o ID retornado pode não existir.

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()}`);
}

Retornar

String

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getSlideIndex()

Retorna o índice baseado em zero do Slide ou null vinculado, se o LinkType não for LinkType.SLIDE_INDEX.

O slide no índice retornado pode não existir.

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()}`);
}

Retornar

Integer

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getSlidePosition()

Retorna o SlidePosition do Slide ou null vinculado se o LinkType não for LinkType.SLIDE_POSITION.

O slide com a posição relativa retornada pode não existir.

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()}`,
  );
}

Retornar

SlidePosition

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

getUrl()

Retorna o URL da página da Web externa ou null se o LinkType não for LinkType.URL.

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()}`);
}

Retornar

String

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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