Class Link

پیوند

یک پیوند فرامتنی.

روش‌ها

روش	نوع بازگشتی	شرح مختصر
get Link Type()	Link Type	Link Type برمی‌گرداند.
get Linked Slide()	Slide |null	در صورت وجود، Slide لینک‌شده را برای انواع لینک‌های غیر URL برمی‌گرداند.
get Slide Id()	String|null	شناسه Slide لینک‌شده را برمی‌گرداند یا اگر Link Type Link Type.SLIDE_ID نباشد null برمی‌گرداند.
get Slide Index()	Integer|null	اندیس Slide لینک‌شده را بر اساس صفر برمی‌گرداند و در صورتی که Link Type Link Type.SLIDE_INDEX نباشد، آن را null برمی‌گرداند.
get Slide Position()	Slide Position |null	Slide Position Slide لینک شده را برمی‌گرداند یا اگر Link Type Link Type.SLIDE_POSITION نباشد null برمی‌گرداند.
get Url()	String|null	آدرس اینترنتی (URL) صفحه وب خارجی را برمی‌گرداند یا اگر Link Type Link Type.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 لینک‌شده را برای انواع لینک‌های غیر URL برمی‌گرداند. اگر اسلاید در ارائه وجود نداشته باشد، یا اگر 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 |null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

---

getSlideId()

شناسه Slide لینک‌شده را برمی‌گرداند یا اگر LinkType LinkType.SLIDE_ID نباشد null برمی‌گرداند.

توجه داشته باشید که ممکن است اسلایدی با شناسه‌ی برگردانده شده وجود نداشته باشد.

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|null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

---

getSlideIndex()

اندیس Slide لینک‌شده را که از صفر شروع می‌شود، برمی‌گرداند و در صورتی که LinkType LinkType.SLIDE_INDEX نباشد، 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|null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

---

getSlidePosition()

SlidePosition Slide لینک‌شده را برمی‌گرداند یا اگر LinkType LinkType.SLIDE_POSITION نباشد، null برمی‌گرداند.

توجه داشته باشید که ممکن است اسلایدی با موقعیت نسبی برگردانده شده وجود نداشته باشد.

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 |null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

---

getUrl()

آدرس اینترنتی (URL) صفحه وب خارجی را برمی‌گرداند یا اگر 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|null

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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