Class Slide

Trang trình bày

Một trang trình bày trong bản trình bày.

Các trang này chứa nội dung mà bạn đang trình bày cho khán giả. Hầu hết các trang trình bày đều dựa trên một trang tổng thể và một bố cục. Bạn có thể chỉ định bố cục sẽ sử dụng cho mỗi trang trình bày khi tạo.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
duplicate()SlideSao chép trang trình bày.
getBackground()PageBackgroundLấy nền của trang.
getColorScheme()ColorSchemeLấy ColorScheme được liên kết với trang.
getGroups()Group[]Trả về danh sách đối tượng Group trên trang.
getImages()Image[]Trả về danh sách đối tượng Image trên trang.
getLayout()LayoutLấy bố cục mà trang trình bày dựa trên hoặc null nếu trang trình bày không dựa trên bố cục.
getLines()Line[]Trả về danh sách đối tượng Line trên trang.
getNotesPage()NotesPageTrả về trang ghi chú liên kết với trang trình bày.
getObjectId()StringLấy mã nhận dạng duy nhất của trang.
getPageElementById(id)PageElementTrả về PageElement trên trang có mã nhận dạng đã cho hoặc null nếu không có.
getPageElements()PageElement[]Trả về danh sách các đối tượng PageElement được hiển thị trên trang.
getPageType()PageTypeLấy loại trang.
getPlaceholder(placeholderType)PageElementTrả về đối tượng PageElement giữ chỗ cho một PlaceholderType hoặc null đã chỉ định nếu không có phần giữ chỗ phù hợp.
getPlaceholder(placeholderType, placeholderIndex)PageElementTrả về đối tượng PageElement phần giữ chỗ cho một PlaceholderType và chỉ mục phần giữ chỗ đã chỉ định hoặc null nếu không có phần giữ chỗ.
getPlaceholders()PageElement[]Trả về danh sách các đối tượng PageElement giữ chỗ trong trang.
getShapes()Shape[]Trả về danh sách đối tượng Shape trên trang.
getSheetsCharts()SheetsChart[]Trả về danh sách đối tượng SheetsChart trên trang.
getSlideLinkingMode()SlideLinkingModeTrả về một SlideLinkingMode cho biết liệu trang trình bày có được liên kết với một trang trình bày khác hay không.
getSourcePresentationId()StringTrả về mã Presentation nguồn hoặc null nếu không liên kết trang trình bày.
getSourceSlideObjectId()StringTrả về mã nhận dạng của trang trình bày nguồn hoặc null nếu trang trình bày không được liên kết.
getTables()Table[]Trả về danh sách đối tượng Table trên trang.
getVideos()Video[]Trả về danh sách đối tượng Video trên trang.
getWordArts()WordArt[]Trả về danh sách đối tượng WordArt trên trang.
group(pageElements)GroupNhóm tất cả các phần tử trang đã chỉ định.
insertGroup(group)GroupChèn một bản sao của Group được cung cấp trên trang.
insertImage(blobSource)ImageChèn một hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ khối hình ảnh được chỉ định.
insertImage(blobSource, left, top, width, height)ImageChèn hình ảnh trên trang có vị trí và kích thước được cung cấp từ blob hình ảnh được chỉ định.
insertImage(image)ImageChèn một bản sao của Image được cung cấp trên trang.
insertImage(imageUrl)ImageChèn hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ URL được cung cấp.
insertImage(imageUrl, left, top, width, height)ImageChèn hình ảnh trên trang với vị trí và kích thước được cung cấp từ URL được cung cấp.
insertLine(line)LineChèn một bản sao của Line được cung cấp trên trang.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineChèn một dòng trên trang kết nối hai connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineChèn một dòng trên trang.
insertPageElement(pageElement)PageElementChèn một bản sao của PageElement được cung cấp trên trang.
insertShape(shape)ShapeChèn một bản sao của Shape được cung cấp trên trang.
insertShape(shapeType)ShapeChèn một hình dạng trên trang.
insertShape(shapeType, left, top, width, height)ShapeChèn một hình dạng trên trang.
insertSheetsChart(sourceChart)SheetsChartChèn biểu đồ trên Google Trang tính vào trang.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartChèn một biểu đồ trên Google Trang tính vào trang với vị trí và kích thước được cung cấp.
insertSheetsChart(sheetsChart)SheetsChartChèn một bản sao của SheetsChart được cung cấp trên trang.
insertSheetsChartAsImage(sourceChart)ImageChèn biểu đồ Google Trang tính dưới dạng Image trên trang.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageChèn biểu đồ Google Trang tính dưới dạng Image trên trang với vị trí và kích thước được cung cấp.
insertTable(numRows, numColumns)TableChèn một bảng trên trang.
insertTable(numRows, numColumns, left, top, width, height)TableChèn một bảng trên trang với vị trí và kích thước được cung cấp.
insertTable(table)TableChèn một bản sao của Table được cung cấp trên trang.
insertTextBox(text)ShapeChèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang.
insertTextBox(text, left, top, width, height)ShapeChèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang.
insertVideo(videoUrl)VideoChèn một video ở góc trên cùng bên trái của trang với kích thước mặc định.
insertVideo(videoUrl, left, top, width, height)VideoChèn một video trên trang với vị trí và kích thước được cung cấp.
insertVideo(video)VideoChèn một bản sao của Video được cung cấp trên trang.
insertWordArt(wordArt)WordArtChèn một bản sao của WordArt được cung cấp trên trang.
isSkipped()BooleanTrả về thông tin về việc trang trình bày có bị bỏ qua ở chế độ trình bày hay không.
move(index)voidDi chuyển trang trình bày đến chỉ mục đã chỉ định.
refreshSlide()voidLàm mới trang trình bày để phản ánh mọi thay đổi đối với trang trình bày nguồn được liên kết.
remove()voidXoá trang.
replaceAllText(findText, replaceText)IntegerThay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.
replaceAllText(findText, replaceText, matchCase)IntegerThay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.
selectAsCurrentPage()voidChọn Page trong bản trình bày đang hoạt động làm current page selection và xoá mọi lựa chọn trước đó.
setSkipped(isSkipped)voidĐặt xem trang trình bày có bị bỏ qua ở chế độ trình bày hay không.
unlink()voidHuỷ liên kết Slide hiện tại khỏi trang trình bày nguồn.

Tài liệu chi tiết

duplicate()

Sao chép trang trình bày.

Trang trình bày trùng lặp sẽ được tạo ngay sau trang trình bày gốc.

Cầu thủ trả bóng

Slide – Trang trình bày đã sao chép.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getBackground()

Lấy nền của trang.

Cầu thủ trả bóng

PageBackground – Nền của trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getColorScheme()

Lấy ColorScheme được liên kết với trang.

Cầu thủ trả bóng

ColorScheme – Bảng phối màu của trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getGroups()

Trả về danh sách đối tượng Group trên trang.

Cầu thủ trả bóng

Group[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getImages()

Trả về danh sách đối tượng Image trên trang.

Cầu thủ trả bóng

Image[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getLayout()

Lấy bố cục mà trang trình bày dựa trên hoặc null nếu trang trình bày không dựa trên bố cục.

Cầu thủ trả bóng

Layout

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getLines()

Trả về danh sách đối tượng Line trên trang.

Cầu thủ trả bóng

Line[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getNotesPage()

Trả về trang ghi chú liên kết với trang trình bày.

Cầu thủ trả bóng

NotesPage

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getObjectId()

Lấy mã nhận dạng duy nhất của trang. Mã nhận dạng đối tượng mà các trang và phần tử trang sử dụng có cùng một không gian tên.

Cầu thủ trả bóng

String

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPageElementById(id)

Trả về PageElement trên trang có mã nhận dạng đã cho hoặc null nếu không có.

Tham số

TênLoạiMô tả
idStringMã của phần tử trang đang được truy xuất.

Cầu thủ trả bóng

PageElement – Phần tử trang có mã nhận dạng đã cho.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPageElements()

Trả về danh sách các đối tượng PageElement được hiển thị trên trang.

Cầu thủ trả bóng

PageElement[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPageType()

Lấy loại trang.

Cầu thủ trả bóng

PageType – Loại trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPlaceholder(placeholderType)

Trả về đối tượng PageElement giữ chỗ cho một PlaceholderType hoặc null đã chỉ định nếu không có phần giữ chỗ phù hợp.

Nếu có nhiều phần giữ chỗ cùng loại, hàm này sẽ trả về phần giữ chỗ có chỉ mục phần giữ chỗ tối thiểu. Nếu có nhiều phần giữ chỗ khớp với cùng một chỉ mục, thì hàm này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp phần tử trang của trang. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Tham số

TênLoạiMô tả
placeholderTypePlaceholderType

Cầu thủ trả bóng

PageElement

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPlaceholder(placeholderType, placeholderIndex)

Trả về đối tượng PageElement phần giữ chỗ cho một PlaceholderType và chỉ mục phần giữ chỗ đã chỉ định hoặc null nếu không có phần giữ chỗ.

Nếu có nhiều phần giữ chỗ có cùng loại và chỉ mục, thì hàm này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp phần tử trang của trang. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Tham số

TênLoạiMô tả
placeholderTypePlaceholderType
placeholderIndexInteger

Cầu thủ trả bóng

PageElement

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getPlaceholders()

Trả về danh sách các đối tượng PageElement giữ chỗ trong trang. 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Cầu thủ trả bóng

PageElement[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getShapes()

Trả về danh sách đối tượng Shape trên trang.

Cầu thủ trả bóng

Shape[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getSheetsCharts()

Trả về danh sách đối tượng SheetsChart trên trang.

Cầu thủ trả bóng

SheetsChart[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getSlideLinkingMode()

Trả về một SlideLinkingMode cho biết liệu trang trình bày có được liên kết với một trang trình bày khác hay không.

Cầu thủ trả bóng

SlideLinkingMode – Chế độ liên kết trang trình bày.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getSourcePresentationId()

Trả về mã Presentation nguồn hoặc null nếu không liên kết trang trình bày.

Một trang trình bày chỉ có mã Presentation nguồn khi được liên kết với một trang trình bày trong một bản trình bày khác.

Cầu thủ trả bóng

String – Mã bản trình bày nguồn hoặc null.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getSourceSlideObjectId()

Trả về mã nhận dạng của trang trình bày nguồn hoặc null nếu trang trình bày không được liên kết.

Một trang trình bày chỉ có mã trang trình bày nguồn khi được liên kết với một trang trình bày trong một bản trình bày khác.

Cầu thủ trả bóng

String – Mã của trang trình bày nguồn hoặc null.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getTables()

Trả về danh sách đối tượng Table trên trang.

Cầu thủ trả bóng

Table[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getVideos()

Trả về danh sách đối tượng Video trên trang.

Cầu thủ trả bóng

Video[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getWordArts()

Trả về danh sách đối tượng WordArt trên trang.

Cầu thủ trả bóng

WordArt[]

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

group(pageElements)

Nhóm tất cả các phần tử trang đã chỉ định.

Phải có ít nhất hai phần tử trang trên cùng một trang chưa có trong một nhóm khác. Không thể nhóm một số thành phần trang, chẳng hạn như Videos, Tables và placeholder Shapes.

Tham số

TênLoạiMô tả
pageElementsPageElement[]Các phần tử cần nhóm lại với nhau.

Cầu thủ trả bóng

Group – Nhóm mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertGroup(group)

Chèn một bản sao của Group được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
groupGroupNhóm cần sao chép và chèn.

Cầu thủ trả bóng

Group – Nhóm đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertImage(blobSource)

Chèn một hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ khối hình ảnh được chỉ định.

Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ BlobSource một lần và một bản sao sẽ được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Tham số

TênLoạiMô tả
blobSourceBlobSourceDữ liệu hình ảnh.

Cầu thủ trả bóng

Image – Hình ảnh đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertImage(blobSource, left, top, width, height)

Chèn hình ảnh trên trang có vị trí và kích thước được cung cấp từ blob hình ảnh được chỉ định.

Hình ảnh được tìm nạp từ BlobSource được cung cấp một lần tại thời điểm chèn và một bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước được cung cấp. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Tham số

TênLoạiMô tả
blobSourceBlobSourceDữ liệu hình ảnh.
leftNumberVị trí ngang của hình ảnh tính bằng điểm, đo từ góc trên bên trái của trang.
topNumberVị trí dọc của hình ảnh tính bằng điểm, được đo từ góc trên bên trái của trang.
widthNumberChiều rộng của hình ảnh tính bằng điểm.
heightNumberChiều cao của hình ảnh tính bằng điểm.

Cầu thủ trả bóng

Image – Hình ảnh đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertImage(image)

Chèn một bản sao của Image được cung cấp trên trang.

Vị trí của hình ảnh được chèn trên trang này được xác định từ vị trí của hình ảnh nguồn trên trang tương ứng.

Nếu hình ảnh được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng sẽ kế thừa trên hình ảnh được chèn.

Nếu hình ảnh được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào hình ảnh từ bản trình bày nguồn. Nếu hình ảnh phần giữ chỗ được sao chép trống, thì sẽ không có nội dung nào được chèn vào bản trình bày đích. 

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Tham số

TênLoạiMô tả
imageImageHình ảnh cần sao chép và chèn.

Cầu thủ trả bóng

Image – Hình ảnh đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertImage(imageUrl)

Chèn hình ảnh ở góc trên cùng bên trái của trang với kích thước mặc định từ URL được cung cấp.

Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ URL một lần và lưu trữ một bản sao để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

URL bạn cung cấp phải có thể truy cập công khai và không được lớn hơn 2 kB. URL sẽ được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl().

Tham số

TênLoạiMô tả
imageUrlStringURL của hình ảnh.

Cầu thủ trả bóng

Image – Hình ảnh đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertImage(imageUrl, left, top, width, height)

Chèn hình ảnh trên trang với vị trí và kích thước được cung cấp từ URL được cung cấp.

Thao tác chèn hình ảnh sẽ tìm nạp hình ảnh đó từ URL một lần và lưu trữ một bản sao để hiển thị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

URL bạn cung cấp phải có thể truy cập công khai và không được lớn hơn 2 kB. URL sẽ được lưu cùng với hình ảnh và hiển thị thông qua Image.getSourceUrl().

Để duy trì tỷ lệ khung hình của hình ảnh, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước được cung cấp.

Tham số

TênLoạiMô tả
imageUrlStringURL của hình ảnh.
leftNumberVị trí ngang của hình ảnh tính bằng điểm, đo từ góc trên bên trái của trang.
topNumberVị trí dọc của hình ảnh tính bằng điểm, được đo từ góc trên bên trái của trang.
widthNumberChiều rộng của hình ảnh tính bằng điểm.
heightNumberChiều cao của hình ảnh tính bằng điểm.

Cầu thủ trả bóng

Image – Hình ảnh đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertLine(line)

Chèn một bản sao của Line được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Tham số

TênLoạiMô tả
lineLineDòng cần sao chép và chèn.

Cầu thủ trả bóng

Line – Dòng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

Chèn một dòng trên trang kết nối hai connection sites. Hai trang web liên kết phải nằm trên trang này. 

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Tham số

TênLoạiMô tả
lineCategoryLineCategoryDanh mục của dòng cần chèn.
startConnectionSiteConnectionSiteĐiểm kết nối nơi bắt đầu của đường dây sẽ được kết nối.
endConnectionSiteConnectionSiteĐiểm kết nối nơi kết nối cuối đường dây.

Cầu thủ trả bóng

Line – Dòng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

Chèn một dòng trên trang. 

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Tham số

TênLoạiMô tả
lineCategoryLineCategoryDanh mục của dòng cần chèn.
startLeftNumberVị trí theo chiều ngang của điểm bắt đầu của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang.
startTopNumberVị trí theo chiều dọc của điểm bắt đầu của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang.
endLeftNumberVị trí theo chiều ngang của điểm cuối của đường thẳng, được đo bằng điểm tính từ góc trên cùng bên trái của trang.
endTopNumberVị trí theo chiều dọc của điểm cuối của đường thẳng, đo bằng điểm tính từ góc trên cùng bên trái của trang.

Cầu thủ trả bóng

Line – Dòng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertPageElement(pageElement)

Chèn một bản sao của PageElement được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Tham số

TênLoạiMô tả
pageElementPageElementPhần tử trang cần sao chép và chèn.

Cầu thủ trả bóng

PageElement – Phần tử trang đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertShape(shape)

Chèn một bản sao của Shape được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
shapeShapeHình dạng cần sao chép và chèn.

Cầu thủ trả bóng

Shape – Hình dạng được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertShape(shapeType)

Chèn một hình dạng trên trang.

Hình dạng được chèn với kích thước mặc định ở góc trên cùng bên trái của trang. 

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Tham số

TênLoạiMô tả
shapeTypeShapeTypeLoại hình dạng cần chèn.

Cầu thủ trả bóng

Shape – Hình dạng được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertShape(shapeType, left, top, width, height)

Chèn một hình dạng trên trang.

Tham số

TênLoạiMô tả
shapeTypeShapeTypeLoại hình dạng cần chèn.
leftNumberVị trí ngang của hình dạng, được đo từ góc trên bên trái của trang.
topNumberVị trí dọc của hình dạng, được đo từ góc trên bên trái của trang.
widthNumberChiều rộng của hình dạng.
heightNumberChiều cao của hình dạng.

Cầu thủ trả bóng

Shape – Hình dạng được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertSheetsChart(sourceChart)

Chèn biểu đồ trên Google Trang tính vào trang.

Biểu đồ được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.

Biểu đồ được chèn được liên kết với biểu đồ nguồn trên Google Trang tính, cho phép bạn cập nhật biểu đồ đó. Những cộng tác viên khác có thể thấy đường liên kết đến bảng tính nguồn. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Tham số

TênLoạiMô tả
sourceChartEmbeddedChartBiểu đồ trong bảng tính cần được chèn vào trang.

Cầu thủ trả bóng

SheetsChart – Biểu đồ đã chèn trong trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertSheetsChart(sourceChart, left, top, width, height)

Chèn một biểu đồ trên Google Trang tính vào trang với vị trí và kích thước được cung cấp.

Để duy trì tỷ lệ khung hình của biểu đồ, biểu đồ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước đã cung cấp.

Biểu đồ được chèn được liên kết với biểu đồ nguồn trên Google Trang tính, cho phép bạn cập nhật biểu đồ đó. Những cộng tác viên khác có thể thấy đường liên kết đến bảng tính nguồn. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

Tham số

TênLoạiMô tả
sourceChartEmbeddedChartBiểu đồ trong bảng tính cần được chèn vào trang.
leftNumberVị trí theo chiều ngang của biểu đồ tính bằng điểm, được đo từ góc trên cùng bên trái của trang.
topNumberVị trí dọc của biểu đồ tính bằng điểm, đo từ góc trên bên trái của trang.
widthNumberChiều rộng của biểu đồ tính bằng điểm.
heightNumberChiều cao của biểu đồ tính bằng điểm.

Cầu thủ trả bóng

SheetsChart – Biểu đồ đã chèn trong trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertSheetsChart(sheetsChart)

Chèn một bản sao của SheetsChart được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Tham số

TênLoạiMô tả
sheetsChartSheetsChartBiểu đồ trên trang tính cần sao chép và chèn.

Cầu thủ trả bóng

SheetsChart – Biểu đồ trang tính đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertSheetsChartAsImage(sourceChart)

Chèn biểu đồ Google Trang tính dưới dạng Image trên trang.

Hình ảnh của biểu đồ được chèn với kích thước mặc định ở góc trên cùng bên trái của trang.

Hình ảnh biểu đồ được chèn không được liên kết với biểu đồ nguồn trên Google Trang tính. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
sourceChartEmbeddedChartBiểu đồ trong bảng tính cần được chèn vào trang.

Cầu thủ trả bóng

Image – Hình ảnh được chèn của biểu đồ trong trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

Chèn biểu đồ Google Trang tính dưới dạng Image trên trang với vị trí và kích thước được cung cấp.

Để duy trì tỷ lệ khung hình của hình ảnh biểu đồ, hình ảnh được điều chỉnh theo tỷ lệ và căn giữa theo kích thước đã cung cấp.

Hình ảnh biểu đồ được chèn không được liên kết với biểu đồ nguồn trên Google Trang tính. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

Tham số

TênLoạiMô tả
sourceChartEmbeddedChartBiểu đồ trong bảng tính cần được chèn vào trang.
leftNumberVị trí theo chiều ngang của biểu đồ tính bằng điểm, được đo từ góc trên cùng bên trái của trang.
topNumberVị trí dọc của biểu đồ tính bằng điểm, đo từ góc trên bên trái của trang.
widthNumberChiều rộng của biểu đồ tính bằng điểm.
heightNumberChiều cao của biểu đồ tính bằng điểm.

Cầu thủ trả bóng

Image – Hình ảnh được chèn của biểu đồ trong trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertTable(numRows, numColumns)

Chèn một bảng trên trang.

Bảng được căn giữa trang với kích thước mặc định và các hàng và cột được phân bổ đều nhau.

Tham số

TênLoạiMô tả
numRowsIntegerSố hàng trong bảng.
numColumnsIntegerSố lượng cột trong bảng.

Cầu thủ trả bóng

Table – Bảng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertTable(numRows, numColumns, left, top, width, height)

Chèn một bảng trên trang với vị trí và kích thước được cung cấp.

Các hàng và cột được phân bổ đều trong bảng đã tạo.

Tham số

TênLoạiMô tả
numRowsIntegerSố hàng trong bảng.
numColumnsIntegerSố lượng cột trong bảng.
leftNumberVị trí ngang của bảng, được đo từ góc trên bên trái của trang.
topNumberVị trí dọc của bảng, được đo từ góc trên bên trái của trang.
widthNumberChiều rộng của bảng.
heightNumberChiều cao tối thiểu của bảng. Chiều cao thực tế của bảng được hiển thị phụ thuộc vào các yếu tố như kích thước phông chữ văn bản.

Cầu thủ trả bóng

Table – Bảng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertTable(table)

Chèn một bản sao của Table được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
tableTableBảng cần sao chép và chèn.

Cầu thủ trả bóng

Table – Bảng đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertTextBox(text)

Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang.

Hình dạng hộp văn bản được chèn với kích thước mặc định ở góc trên cùng bên trái của trang. 

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
textStringChuỗi mà hình dạng hộp văn bản phải chứa.

Cầu thủ trả bóng

Shape – Hình dạng hộp văn bản đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertTextBox(text, left, top, width, height)

Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang. 

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
textStringChuỗi mà hình dạng hộp văn bản phải chứa.
leftNumberVị trí theo chiều ngang của hình dạng hộp văn bản, được đo từ góc trên bên trái của trang.
topNumberVị trí dọc của hình dạng hộp văn bản, được đo từ góc trên bên trái của trang.
widthNumberChiều rộng của hình dạng hộp văn bản.
heightNumberChiều cao của hình dạng hộp văn bản.

Cầu thủ trả bóng

Shape – Hình dạng hộp văn bản đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertVideo(videoUrl)

Chèn một video ở góc trên cùng bên trái của trang với kích thước mặc định.

Hiện tại, chỉ những video trên YouTube mới được hỗ trợ.

Tham số

TênLoạiMô tả
videoUrlStringURL của video cần chèn.

Cầu thủ trả bóng

Video – Video được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertVideo(videoUrl, left, top, width, height)

Chèn một video trên trang với vị trí và kích thước được cung cấp.

Hiện tại, chỉ những video trên YouTube mới được hỗ trợ.

Tham số

TênLoạiMô tả
videoUrlStringURL của video cần chèn.
leftNumberVị trí ngang của video tính bằng điểm, được đo từ góc trên bên trái của trang.
topNumberVị trí dọc của video tính bằng điểm, đo từ góc trên bên trái của trang.
widthNumberChiều rộng của video tính bằng điểm.
heightNumberChiều cao của video tính bằng điểm.

Cầu thủ trả bóng

Video – Video được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertVideo(video)

Chèn một bản sao của Video được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

Tham số

TênLoạiMô tả
videoVideoVideo cần sao chép và chèn.

Cầu thủ trả bóng

Video – Video được chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

insertWordArt(wordArt)

Chèn một bản sao của WordArt được cung cấp trên trang.

Vị trí của phần tử được chèn trên trang này được xác định từ vị trí của phần tử nguồn trên trang tương ứng.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ trong bản trình bày hiện tại, thì các thuộc tính kế thừa từ trang chính hoặc trang bố cục cũng kế thừa trên phần tử được chèn.

Nếu phần tử được cung cấp là phần giữ chỗ đang được sao chép từ một bản trình bày khác, thì các thuộc tính kế thừa từ trang tổng thể hoặc trang bố cục sẽ được sao chép vào phần tử từ bản trình bày nguồn. 

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Tham số

TênLoạiMô tả
wordArtWordArtNhóm cần sao chép và chèn.

Cầu thủ trả bóng

WordArt – Chữ nghệ thuật đã chèn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

isSkipped()

Trả về thông tin về việc trang trình bày có bị bỏ qua ở chế độ trình bày hay không.

Cầu thủ trả bóng

Boolean – True nếu trang trình bày bị bỏ qua ở chế độ trình bày.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

move(index)

Di chuyển trang trình bày đến chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
indexIntegerChỉ mục mà trang trình bày sẽ được di chuyển đến, dựa trên cách sắp xếp trang trình bày trước khi di chuyển. Chỉ mục phải nằm trong khoảng từ 0 đến số trang trình bày, bao gồm cả số trang trình bày.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

refreshSlide()

Làm mới trang trình bày để phản ánh mọi thay đổi đối với trang trình bày nguồn được liên kết. Nếu không liên kết đến trang trình bày này, hàm sẽ trả về mà không thực hiện thay đổi nào.

Phương thức refreshSlide sao chép các trang bố cục và trang tổng thể tương ứng của trang trình bày nguồn được liên kết vào bản trình bày của trang trình bày nếu các trang đó chưa tồn tại. Nếu đã có, các tệp này cũng được cập nhật để phản ánh mọi thay đổi đối với nguồn. 

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

Gửi

Error – Nếu không còn quyền đọc đối với bản trình bày nguồn.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

remove()

Xoá trang.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

replaceAllText(findText, replaceText)

Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế. Tìm kiếm không phân biệt chữ hoa chữ thường.

Tham số

TênLoạiMô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản thay thế văn bản đã khớp.

Cầu thủ trả bóng

Integer – số lần xuất hiện đã thay đổi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

replaceAllText(findText, replaceText, matchCase)

Thay thế tất cả các bản sao của văn bản khớp với văn bản tìm kiếm bằng văn bản thay thế.

Tham số

TênLoạiMô tả
findTextStringVăn bản cần tìm.
replaceTextStringVăn bản thay thế văn bản đã khớp.
matchCaseBooleanNếu là true, thì tính năng tìm kiếm sẽ phân biệt chữ hoa chữ thường; nếu là false, thì tính năng tìm kiếm sẽ không phân biệt chữ hoa chữ thường.

Cầu thủ trả bóng

Integer – số lần xuất hiện đã thay đổi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

selectAsCurrentPage()

Chọn Page trong bản trình bày đang hoạt động làm current page selection và xoá mọi lựa chọn trước đó.

Một tập lệnh chỉ có thể truy cập vào lựa chọn của người dùng đang chạy tập lệnh và chỉ khi tập lệnh đó được liên kết với bản trình bày. 

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

setSkipped(isSkipped)

Đặt xem trang trình bày có bị bỏ qua ở chế độ trình bày hay không.

Tham số

TênLoạiMô tả
isSkippedBooleanTrue để bỏ qua trang trình bày ở chế độ trình bày.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Huỷ liên kết Slide hiện tại khỏi trang trình bày nguồn. Nếu không liên kết đến trang trình bày này, hãy trả về mà không thực hiện thay đổi nào. 

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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