Một mẫu trong bản trình bày.
Trang mẫu chứa tất cả các phần tử trang phổ biến và các thuộc tính phổ biến cho một nhóm bố cục. Các mục tiêu này phục vụ 3 mục đích:
- Các hình giữ chỗ trên trang cái chứa kiểu văn bản và thuộc tính hình dạng mặc định của tất cả các hình giữ chỗ trên những trang sử dụng trang cái đó.
- Các thuộc tính của trang chính xác định các thuộc tính trang chung mà bố cục của trang đó kế thừa.
- Mọi hình dạng khác trên trang trình bày mẫu sẽ xuất hiện trên tất cả các trang trình bày sử dụng mẫu đó, bất kể bố cục của chúng.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
get | Page | Lấy nền của trang. |
get | Color | Lấy Color được liên kết với trang. |
get | Group[] | Trả về danh sách các đối tượng Group trên trang. |
get | Image[] | Trả về danh sách các đối tượng Image trên trang. |
get | Layout[] | Lấy bố cục của trang cái này. |
get | Line[] | Trả về danh sách các đối tượng Line trên trang. |
get | String | Lấy mã nhận dạng duy nhất của trang. |
get | Page | Trả về Page trên trang có mã nhận dạng đã cho hoặc null nếu không có. |
get | Page | Trả về danh sách các đối tượng Page được hiển thị trên trang. |
get | Page | Lấy loại trang. |
get | Page | Trả về đối tượng trình giữ chỗ Page cho Placeholder hoặc null được chỉ định nếu không có trình giữ chỗ nào khớp. |
get | Page | Trả về đối tượng phần giữ chỗ Page cho một Placeholder và chỉ mục phần giữ chỗ được chỉ định hoặc null nếu không có phần giữ chỗ. |
get | Page | Trả về danh sách các đối tượng Page giữ chỗ trong trang. |
get | Shape[] | Trả về danh sách các đối tượng Shape trên trang. |
get | Sheets | Trả về danh sách các đối tượng Sheets trên trang. |
get | Table[] | Trả về danh sách các đối tượng Table trên trang. |
get | Video[] | Trả về danh sách các đối tượng Video trên trang. |
get | Word | Trả về danh sách các đối tượng Word trên trang. |
group(pageElements) | Group | Nhóm tất cả các phần tử trang được chỉ định. |
insert | Group | Chèn một bản sao của Group được cung cấp vào trang. |
insert | Image | 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ừ blob hình ảnh đã chỉ định. |
insert | Image | Chèn một hình ảnh vào trang với vị trí và kích thước được cung cấp từ blob hình ảnh đã chỉ định. |
insert | Image | Chèn một bản sao của Image được cung cấp vào trang. |
insert | Image | Chèn một hình ảnh có kích thước mặc định vào góc trên cùng bên trái của trang từ URL được cung cấp. |
insert | Image | Chèn một hình ảnh vào trang với vị trí và kích thước được cung cấp từ URL được cung cấp. |
insert | Line | Chèn một bản sao của Line được cung cấp vào trang. |
insert | Line | Chèn một đường thẳng trên trang để kết nối hai connection sites. |
insert | Line | Chèn một đường kẻ vào trang. |
insert | Page | Chèn một bản sao của Page được cung cấp vào trang. |
insert | Shape | Chèn một bản sao của Shape được cung cấp vào trang. |
insert | Shape | Chèn một hình dạng vào trang. |
insert | Shape | Chèn một hình dạng vào trang. |
insert | Sheets | Chèn một biểu đồ Google Trang tính vào trang. |
insert | Sheets | Chèn một biểu đồ Google Trang tính vào trang với vị trí và kích thước được cung cấp. |
insert | Sheets | Chèn một bản sao của Sheets được cung cấp vào trang. |
insert | Image | Chèn biểu đồ Google Trang tính dưới dạng Image trên trang. |
insert | Image | 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. |
insert | Table | Chèn một bảng vào trang. |
insert | Table | Chèn một bảng vào trang với vị trí và kích thước được cung cấp. |
insert | Table | Chèn một bản sao của Table được cung cấp vào trang. |
insert | Shape | Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang. |
insert | Shape | Chèn một hộp văn bản Shape chứa chuỗi được cung cấp trên trang. |
insert | Video | 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. |
insert | Video | Chèn một video vào trang với vị trí và kích thước được cung cấp. |
insert | Video | Chèn một bản sao của Video được cung cấp vào trang. |
insert | Word | Chèn một bản sao của Word được cung cấp vào trang. |
remove() | void | Xoá trang. |
replace | Integer | Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế. |
replace | Integer | Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế. |
select | void | 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 đó. |
Tài liệu chi tiết
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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayouts()
getLines()
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 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ên | Loại | Mô tả |
|---|---|---|
id | String | Mã nhận dạng của phần tử trang đang được truy xuất. |
Cầu thủ trả bóng
PageElement|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
Trả về đối tượng trình giữ chỗ PageElement cho PlaceholderType hoặc null được chỉ định nếu không có trình giữ chỗ nào khớp.
Nếu có nhiều phần giữ chỗ cùng loại, thì phương thức 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 có cùng chỉ mục, thì phương thức này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp các phần tử trang của trang.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
placeholder | Placeholder | Loại phần giữ chỗ cần so khớp. |
Cầu thủ trả bóng
PageElement|null – Phần tử trang giữ chỗ hoặc null nếu không tìm thấy phần tử nào.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Trả về đối tượng phần giữ chỗ PageElement cho một PlaceholderType và chỉ mục phần giữ chỗ được 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ì phương thức này sẽ trả về phần giữ chỗ đầu tiên trong tập hợp các 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ên | Loại | Mô tả |
|---|---|---|
placeholder | Placeholder | Loại phần giữ chỗ cần so khớp. |
placeholder | Integer | Chỉ mục của phần giữ chỗ cần khớp. |
Cầu thủ trả bóng
PageElement|null – Phần tử trang giữ chỗ hoặc null nếu không tìm thấy phần tử nào.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
Trả về danh sách các đối tượng SheetsChart trên trang.
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
Nhóm tất cả các phần tử trang được chỉ định.
Phải có ít nhất 2 phần tử trang trên cùng một trang chưa có trong một nhóm khác. Bạn không thể nhóm một số phần tử trên trang, chẳng hạn như Videos, Tables và placeholder Shapes.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
page | Page | 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
group | Group | Nhóm cần sao chép và chèn. |
Cầu thủ trả bóng
Group – Nhóm được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ừ blob hình ảnh đã chỉ định.
Khi bạn chèn hình ảnh, hình ảnh đó sẽ được tìm nạp từ BlobSource một lần và một bản sao sẽ được lưu trữ để hiển thị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 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ên | Loại | Mô tả |
|---|---|---|
blob | Blob | Dữ liệu hình ảnh. |
Cầu thủ trả bóng
Image – Hình ảnh được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Chèn một hình ảnh vào trang với vị trí và kích thước được cung cấp từ blob hình ảnh đã chỉ định.
Hình ảnh được tìm nạp từ BlobSource đã 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ị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 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 sẽ được điều chỉnh 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ên | Loại | Mô tả |
|---|---|---|
blob | Blob | Dữ liệu hình ảnh. |
left | Number | Vị trí ngang của hình ảnh theo điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của hình ảnh theo điểm, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của hình ảnh, tính bằng điểm. |
height | Number | Chiều cao của hình ảnh tính bằng điểm. |
Cầu thủ trả bóng
Image – Hình ảnh được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào trang.
Vị trí của hình ảnh được chèn trên trang này được xác định dựa trên 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à một phần giữ chỗ đượ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 mẫu 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à một phần giữ chỗ đượ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 mẫu 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 bị 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ên | Loại | Mô tả |
|---|---|---|
image | Image | Hình ảnh cần sao chép và chèn. |
Cầu thủ trả bóng
Image – Hình ảnh được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Chèn một hình ảnh có kích thước mặc định vào góc trên cùng bên trái của trang từ URL được cung cấp.
Khi bạn chèn hình ảnh, hình ảnh đó sẽ được tìm nạp từ URL một lần và một bản sao sẽ được lưu trữ để hiển thị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 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. Bản thân URL được lưu bằng hình ảnh và hiển thị thông qua Image.getSourceUrl().
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
image | String | URL của hình ảnh. |
Cầu thủ trả bóng
Image – Hình ảnh được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Chèn một hình ảnh vào trang với vị trí và kích thước được cung cấp từ URL được cung cấp.
Khi bạn chèn hình ảnh, hình ảnh đó sẽ được tìm nạp từ URL một lần và một bản sao sẽ được lưu trữ để hiển thị trong bản trình bày. Hình ảnh phải có kích thước nhỏ hơn 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. Bản thân URL được lưu bằng 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 sẽ được điều chỉnh tỷ lệ và căn giữa theo kích thước được cung cấp.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
image | String | URL của hình ảnh. |
left | Number | Vị trí ngang của hình ảnh theo điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của hình ảnh theo điểm, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của hình ảnh, tính bằng điểm. |
height | Number | Chiều cao của hình ảnh tính bằng điểm. |
Cầu thủ trả bóng
Image – Hình ảnh được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
line | Line | Dòng cần sao chép và chèn. |
Cầu thủ trả bóng
Line – Dòng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Chèn một đường thẳng trên trang để kết nối hai connection sites. Hai trang web kết nối 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ên | Loại | Mô tả |
|---|---|---|
line | Line | Danh mục của dòng cần chèn. |
start | Connection | Vị trí kết nối nơi bắt đầu kết nối đường dây. |
end | Connection | Vị trí kết nối nơi đầu cuối của đường thẳng sẽ được kết nối. |
Cầu thủ trả bóng
Line – Dòng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Chèn một đường kẻ vào 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ên | Loại | Mô tả |
|---|---|---|
line | Line | Danh mục của dòng cần chèn. |
start | Number | Vị trí ngang của điểm bắt đầu của đường thẳng, được đo bằng điểm từ góc trên cùng bên trái của trang. |
start | Number | Vị trí thẳng đứng của điểm bắt đầu của đường thẳng, được đo bằng điểm từ góc trên cùng bên trái của trang. |
end | Number | Vị trí ngang của điểm cuối của đường thẳng, được đo bằng điểm từ góc trên cùng bên trái của trang. |
end | Number | Vị trí thẳng đứng của điểm cuối của đường thẳng, được đo bằng điểm từ góc trên cùng bên trái của trang. |
Cầu thủ trả bóng
Line – Dòng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
page | Page | Phần tử trang cần sao chép và chèn. |
Cầu thủ trả bóng
PageElement – Phần tử trang được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
shape | Shape | Hì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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
Chèn một hình dạng vào 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ên | Loại | Mô tả |
|---|---|---|
shape | Shape | Loạ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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào trang.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
shape | Shape | Loại hình dạng cần chèn. |
left | Number | Vị trí ngang của hình dạng, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của hình dạng, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của hình dạng. |
height | Number | Chiề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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Chèn một biểu đồ 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 sẽ được liên kết với biểu đồ nguồn trên Google Trang tính, nhờ đó bạn có thể 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ên | Loại | Mô tả |
|---|---|---|
source | Embedded | Biểu đồ trong bảng tính sẽ được chèn vào trang. |
Cầu thủ trả bóng
SheetsChart – Biểu đồ được chèn vào trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 đồ 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 đồ sẽ được điều chỉnh tỷ lệ và đặt ở giữa theo kích thước được cung cấp.
Biểu đồ được chèn sẽ được liên kết với biểu đồ nguồn trên Google Trang tính, nhờ đó bạn có thể 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ên | Loại | Mô tả |
|---|---|---|
source | Embedded | Biểu đồ trong bảng tính sẽ được chèn vào trang. |
left | Number | Vị trí ngang của biểu đồ theo điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của biểu đồ theo điểm, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của biểu đồ tính bằng điểm. |
height | Number | Chiều cao của biểu đồ tính bằng điểm. |
Cầu thủ trả bóng
SheetsChart – Biểu đồ được chèn vào trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
sheets | Sheets | Biểu đồ 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 bên trái của trang.
Hình ảnh biểu đồ được chèn không 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ên | Loại | Mô tả |
|---|---|---|
source | Embedded | Biểu đồ trong bảng tính sẽ được chèn vào trang. |
Cầu thủ trả bóng
Image – Hình ảnh biểu đồ được chèn vào trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 sẽ được điều chỉnh tỷ lệ và đặt ở giữa theo kích thước được cung cấp.
Hình ảnh được chèn của biểu đồ 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ên | Loại | Mô tả |
|---|---|---|
source | Embedded | Biểu đồ trong bảng tính sẽ được chèn vào trang. |
left | Number | Vị trí ngang của biểu đồ theo điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của biểu đồ theo điểm, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của biểu đồ tính bằng điểm. |
height | Number | Chiều cao của biểu đồ tính bằng điểm. |
Cầu thủ trả bóng
Image – Hình ảnh biểu đồ được chèn vào trang.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
Chèn một bảng vào trang.
Bảng nằm ở giữa trang với kích thước mặc định và các hàng, cột được phân phối đều.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
num | Integer | Số hàng trong bảng. |
num | Integer | Số cột trong bảng. |
Cầu thủ trả bóng
Table – Bảng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào trang với vị trí và kích thước được cung cấp.
Các hàng và cột được phân phối đều trong bảng đã tạo.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
num | Integer | Số hàng trong bảng. |
num | Integer | Số cột trong bảng. |
left | Number | Vị trí ngang của bảng, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của bảng, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của bảng. |
height | Number | Chiề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ư cỡ chữ. |
Cầu thủ trả bóng
Table – Bảng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
table | Table | Bảng cần sao chép và chèn. |
Cầu thủ trả bóng
Table – Bảng được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ên | Loại | Mô tả |
|---|---|---|
text | String | Chuỗ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 hộp văn bản được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ên | Loại | Mô tả |
|---|---|---|
text | String | Chuỗi mà hình dạng hộp văn bản phải chứa. |
left | Number | Vị trí ngang của hình hộp văn bản, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của hình hộp văn bản, được đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của hình hộp văn bản. |
height | Number | Chiều cao của hình hộp văn bản. |
Cầu thủ trả bóng
Shape – Hình hộp văn bản được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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ỉ video trên YouTube mới được hỗ trợ.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
video | String | URL 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Chèn một video vào trang với vị trí và kích thước được cung cấp.
Hiện tại, chỉ video trên YouTube mới được hỗ trợ.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
video | String | URL của video cần chèn. |
left | Number | Vị trí ngang của video theo điểm, được đo từ góc trên cùng bên trái của trang. |
top | Number | Vị trí thẳng đứng của video tính bằng điểm, đo từ góc trên cùng bên trái của trang. |
width | Number | Chiều rộng của video tính bằng điểm. |
height | Number | Chiề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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
video | Video | Video 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 vào 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à một phần giữ chỗ đượ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 mẫu hoặc trang bố cục cũng sẽ kế thừa trên phần tử được chèn.
Nếu phần tử được cung cấp là một phần giữ chỗ đượ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 mẫu 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ên | Loại | Mô tả |
|---|---|---|
word | Word | Nhóm cần sao chép và chèn. |
Cầu thủ trả bóng
WordArt – Chữ nghệ thuật được chèn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế. Nội dung tìm kiếm không phân biệt chữ hoa chữ thường.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
find | String | Văn bản cần tìm. |
replace | String | Văn bản sẽ thay thế văn bản trùng 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Thay thế tất cả các trường hợp văn bản khớp với văn bản tìm bằng văn bản thay thế.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
find | String | Văn bản cần tìm. |
replace | String | Văn bản sẽ thay thế văn bản trùng khớp. |
match | Boolean | Nếu true, thì tìm kiếm có phân biệt chữ hoa chữ thường; nếu false, thì tìm kiếm 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 đó.
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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/presentations.currentonly -
https://www.googleapis.com/auth/presentations