Class Layout

Tata letak

Tata letak dalam presentasi.

Setiap tata letak berfungsi sebagai template untuk slide yang diwarisi darinya, yang menentukan bagaimana konten di slide tersebut disusun dan diberi gaya.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getBackground()PageBackgroundMendapatkan latar belakang halaman.
getColorScheme()ColorSchemeMendapatkan ColorScheme yang terkait dengan halaman.
getGroups()Group[]Menampilkan daftar objek Group di halaman.
getImages()Image[]Menampilkan daftar objek Image di halaman.
getLayoutName()StringMendapatkan nama tata letak.
getLines()Line[]Menampilkan daftar objek Line di halaman.
getMaster()MasterMendapatkan master yang menjadi dasar tata letak.
getObjectId()StringMendapatkan ID unik untuk halaman.
getPageElementById(id)PageElementMenampilkan PageElement di halaman dengan ID yang diberikan, atau null jika tidak ada.
getPageElements()PageElement[]Menampilkan daftar objek PageElement yang dirender di halaman.
getPageType()PageTypeMendapatkan jenis halaman.
getPlaceholder(placeholderType)PageElementMenampilkan objek PageElement placeholder untuk PlaceholderType atau null yang ditentukan jika tidak ada placeholder yang cocok.
getPlaceholder(placeholderType, placeholderIndex)PageElementMenampilkan objek PageElement placeholder untuk PlaceholderType dan indeks placeholder yang ditentukan, atau null jika placeholder tidak ada.
getPlaceholders()PageElement[]Menampilkan daftar objek PageElement placeholder di halaman.
getShapes()Shape[]Menampilkan daftar objek Shape di halaman.
getSheetsCharts()SheetsChart[]Menampilkan daftar objek SheetsChart di halaman.
getTables()Table[]Menampilkan daftar objek Table di halaman.
getVideos()Video[]Menampilkan daftar objek Video di halaman.
getWordArts()WordArt[]Menampilkan daftar objek WordArt di halaman.
group(pageElements)GroupMengelompokkan semua elemen halaman yang ditentukan.
insertGroup(group)GroupMenyisipkan salinan Group yang disediakan di halaman.
insertImage(blobSource)ImageMenyisipkan gambar di sudut kiri atas halaman dengan ukuran default dari blob gambar yang ditentukan.
insertImage(blobSource, left, top, width, height)ImageMenyisipkan gambar pada halaman dengan ukuran dan posisi yang diberikan dari blob gambar tertentu.
insertImage(image)ImageMenyisipkan salinan Image yang disediakan di halaman.
insertImage(imageUrl)ImageMenyisipkan gambar di pojok kiri atas halaman dengan ukuran default dari URL yang disediakan.
insertImage(imageUrl, left, top, width, height)ImageMenyisipkan gambar pada halaman dengan posisi dan ukuran yang disediakan dari URL yang disediakan.
insertLine(line)LineMenyisipkan salinan Line yang disediakan di halaman.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineMenyisipkan baris pada halaman yang menghubungkan dua connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineMenyisipkan baris pada halaman.
insertPageElement(pageElement)PageElementMenyisipkan salinan PageElement yang disediakan di halaman.
insertShape(shape)ShapeMenyisipkan salinan Shape yang disediakan di halaman.
insertShape(shapeType)ShapeMenyisipkan bentuk pada halaman.
insertShape(shapeType, left, top, width, height)ShapeMenyisipkan bentuk pada halaman.
insertSheetsChart(sourceChart)SheetsChartMenyisipkan diagram Google Spreadsheet di halaman.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartMenyisipkan diagram Google Spreadsheet di halaman dengan posisi dan ukuran yang disediakan.
insertSheetsChart(sheetsChart)SheetsChartMenyisipkan salinan SheetsChart yang disediakan di halaman.
insertSheetsChartAsImage(sourceChart)ImageMenyisipkan diagram Google Spreadsheet sebagai Image di halaman.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageMenyisipkan diagram Google Spreadsheet sebagai Image di halaman dengan posisi dan ukuran yang diberikan.
insertTable(numRows, numColumns)TableMenyisipkan tabel pada halaman.
insertTable(numRows, numColumns, left, top, width, height)TableMenyisipkan tabel pada halaman dengan posisi dan ukuran yang diberikan.
insertTable(table)TableMenyisipkan salinan Table yang disediakan di halaman.
insertTextBox(text)ShapeMenyisipkan kotak teks Shape yang berisi string yang disediakan pada halaman tersebut.
insertTextBox(text, left, top, width, height)ShapeMenyisipkan kotak teks Shape yang berisi string yang disediakan pada halaman tersebut.
insertVideo(videoUrl)VideoMenyisipkan video di pojok kiri atas halaman dengan ukuran default.
insertVideo(videoUrl, left, top, width, height)VideoMenyisipkan video di halaman dengan posisi dan ukuran yang diberikan.
insertVideo(video)VideoMenyisipkan salinan Video yang disediakan di halaman.
insertWordArt(wordArt)WordArtMenyisipkan salinan WordArt yang disediakan di halaman.
remove()voidMenghapus halaman.
replaceAllText(findText, replaceText)IntegerMengganti semua instance pencocokan teks temukan teks dengan ganti teks.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua instance pencocokan teks temukan teks dengan ganti teks.
selectAsCurrentPage()voidMemilih Page dalam presentasi aktif sebagai current page selection dan menghapus pilihan sebelumnya.

Dokumentasi mendetail

getBackground()

Mendapatkan latar belakang halaman.

Pulang pergi

PageBackground — Latar belakang halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getColorScheme()

Mendapatkan ColorScheme yang terkait dengan halaman.

Pulang pergi

ColorScheme — Skema warna halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getGroups()

Menampilkan daftar objek Group di halaman.

Pulang pergi

Group[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getImages()

Menampilkan daftar objek Image di halaman.

Pulang pergi

Image[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getLayoutName()

Mendapatkan nama tata letak.

Pulang pergi

String

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getLines()

Menampilkan daftar objek Line di halaman.

Pulang pergi

Line[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getMaster()

Mendapatkan master yang menjadi dasar tata letak.

Pulang pergi

Master

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getObjectId()

Mendapatkan ID unik untuk halaman. ID objek yang digunakan oleh halaman dan elemen halaman menggunakan namespace yang sama.

Pulang pergi

String

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPageElementById(id)

Menampilkan PageElement di halaman dengan ID yang diberikan, atau null jika tidak ada.

Parameter

NamaJenisDeskripsi
idStringID elemen halaman yang sedang diambil.

Pulang pergi

PageElement — Elemen halaman dengan ID yang diberikan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPageElements()

Menampilkan daftar objek PageElement yang dirender di halaman.

Pulang pergi

PageElement[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPageType()

Mendapatkan jenis halaman.

Pulang pergi

PageType — Jenis halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPlaceholder(placeholderType)

Menampilkan objek PageElement placeholder untuk PlaceholderType atau null yang ditentukan jika tidak ada placeholder yang cocok.

Jika ada beberapa placeholder dengan jenis yang sama, placeholder akan menampilkan placeholder dengan indeks placeholder minimal. Jika ada beberapa placeholder yang cocok dengan indeks yang sama, placeholder pertama akan ditampilkan dari koleksi elemen halaman halaman.

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

Parameter

NamaJenisDeskripsi
placeholderTypePlaceholderType

Pulang pergi

PageElement

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPlaceholder(placeholderType, placeholderIndex)

Menampilkan objek PageElement placeholder untuk PlaceholderType dan indeks placeholder yang ditentukan, atau null jika placeholder tidak ada.

Jika ada beberapa placeholder dengan jenis dan indeks yang sama, placeholder pertama akan ditampilkan dari koleksi elemen halaman halaman.

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

Parameter

NamaJenisDeskripsi
placeholderTypePlaceholderType
placeholderIndexInteger

Pulang pergi

PageElement

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getPlaceholders()

Menampilkan daftar objek PageElement placeholder di halaman.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

Pulang pergi

PageElement[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getShapes()

Menampilkan daftar objek Shape di halaman.

Pulang pergi

Shape[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getSheetsCharts()

Menampilkan daftar objek SheetsChart di halaman.

Pulang pergi

SheetsChart[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getTables()

Menampilkan daftar objek Table di halaman.

Pulang pergi

Table[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getVideos()

Menampilkan daftar objek Video di halaman.

Pulang pergi

Video[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getWordArts()

Menampilkan daftar objek WordArt di halaman.

Pulang pergi

WordArt[]

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

group(pageElements)

Mengelompokkan semua elemen halaman yang ditentukan.

Setidaknya harus ada dua elemen halaman di halaman yang sama yang belum ada di grup lain. Beberapa elemen halaman, seperti Videos, Tables, dan placeholder Shapes tidak dapat dikelompokkan.

Parameter

NamaJenisDeskripsi
pageElementsPageElement[]Elemen yang akan dikelompokkan.

Pulang pergi

Group — Grup baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertGroup(group)

Menyisipkan salinan Group yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

Parameter

NamaJenisDeskripsi
groupGroupGrup yang akan disalin dan disisipkan.

Pulang pergi

Group — Grup yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertImage(blobSource)

Menyisipkan gambar di sudut kiri atas halaman dengan ukuran default dari blob gambar yang ditentukan.

Menyisipkan gambar akan mengambilnya dari BlobSource satu kali dan salinannya akan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

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

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.

Pulang pergi

Image — Gambar yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan gambar pada halaman dengan ukuran dan posisi yang diberikan dari blob gambar tertentu.

Gambar diambil dari BlobSource yang disediakan satu kali pada waktu penyisipan dan salinannya disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

Untuk mempertahankan rasio lebar tinggi gambar, gambar diskalakan dan dipusatkan sehubungan dengan ukuran yang diberikan.

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

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.
leftNumberPosisi horizontal gambar dalam titik, yang diukur dari pojok kiri atas halaman.
topNumberPosisi vertikal gambar dalam titik, diukur dari sudut kiri atas halaman.
widthNumberLebar gambar dalam titik.
heightNumberTinggi gambar dalam titik.

Pulang pergi

Image — Gambar yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertImage(image)

Menyisipkan salinan Image yang disediakan di halaman.

Posisi gambar yang disisipkan pada halaman ini ditentukan dari posisi gambar sumber pada halamannya masing-masing.

Jika gambar yang diberikan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi gambar yang disisipkan.

Jika gambar yang diberikan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak disalin ke gambar dari presentasi sumber. Jika gambar placeholder yang disalin kosong, tidak ada yang disisipkan dalam presentasi tujuan.

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

Parameter

NamaJenisDeskripsi
imageImageGambar yang akan disalin dan disisipkan.

Pulang pergi

Image — Gambar yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertImage(imageUrl)

Menyisipkan gambar di pojok kiri atas halaman dengan ukuran default dari URL yang disediakan.

Menyisipkan gambar akan mengambilnya dari URL sekali dan salinannya akan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

URL yang diberikan harus dapat diakses secara publik dan tidak lebih dari 2 kB. URL itu sendiri disimpan dengan gambar dan ditampilkan melalui Image.getSourceUrl().

Parameter

NamaJenisDeskripsi
imageUrlStringURL gambar.

Pulang pergi

Image — Gambar yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan gambar pada halaman dengan posisi dan ukuran yang disediakan dari URL yang disediakan.

Menyisipkan gambar akan mengambilnya dari URL sekali dan salinannya akan disimpan untuk ditampilkan di dalam presentasi. Gambar harus berukuran kurang dari 50 MB, tidak boleh melebihi 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

URL yang diberikan harus dapat diakses secara publik dan tidak lebih dari 2 kB. URL itu sendiri disimpan dengan gambar dan ditampilkan melalui Image.getSourceUrl().

Untuk mempertahankan rasio lebar tinggi gambar, gambar diskalakan dan dipusatkan sehubungan dengan ukuran yang diberikan.

Parameter

NamaJenisDeskripsi
imageUrlStringURL gambar.
leftNumberPosisi horizontal gambar dalam titik, yang diukur dari pojok kiri atas halaman.
topNumberPosisi vertikal gambar dalam titik, diukur dari sudut kiri atas halaman.
widthNumberLebar gambar dalam titik.
heightNumberTinggi gambar dalam titik.

Pulang pergi

Image — Gambar yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertLine(line)

Menyisipkan salinan Line yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

Parameter

NamaJenisDeskripsi
lineLineBaris yang akan disalin dan disisipkan.

Pulang pergi

Line — Baris yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

Menyisipkan baris pada halaman yang menghubungkan dua connection sites. Kedua situs koneksi harus berada di halaman ini.

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

Parameter

NamaJenisDeskripsi
lineCategoryLineCategoryKategori garis yang akan disisipkan.
startConnectionSiteConnectionSiteSitus koneksi tempat awal baris akan dihubungkan.
endConnectionSiteConnectionSiteSitus koneksi tempat ujung baris akan dihubungkan.

Pulang pergi

Line — Baris yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan baris pada halaman.

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

Parameter

NamaJenisDeskripsi
lineCategoryLineCategoryKategori garis yang akan disisipkan.
startLeftNumberPosisi horizontal titik awal garis, diukur dalam titik dari pojok kiri atas halaman.
startTopNumberPosisi vertikal titik awal garis, diukur dalam titik dari pojok kiri atas halaman.
endLeftNumberPosisi horizontal titik akhir garis, diukur dalam titik dari pojok kiri atas halaman.
endTopNumberPosisi vertikal titik akhir garis, diukur dalam titik dari pojok kiri atas halaman.

Pulang pergi

Line — Baris yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertPageElement(pageElement)

Menyisipkan salinan PageElement yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

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

Parameter

NamaJenisDeskripsi
pageElementPageElementElemen halaman yang akan disalin dan disisipkan.

Pulang pergi

PageElement — Elemen halaman yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertShape(shape)

Menyisipkan salinan Shape yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

Parameter

NamaJenisDeskripsi
shapeShapeBentuk yang akan disalin dan disisipkan.

Pulang pergi

Shape — Bentuk yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertShape(shapeType)

Menyisipkan bentuk pada halaman.

Bentuk akan disisipkan dengan ukuran default di sudut kiri atas halaman.

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

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

Parameter

NamaJenisDeskripsi
shapeTypeShapeTypeJenis bentuk yang akan disisipkan.

Pulang pergi

Shape — Bentuk yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan bentuk pada halaman.

Parameter

NamaJenisDeskripsi
shapeTypeShapeTypeJenis bentuk yang akan disisipkan.
leftNumberPosisi horizontal bentuk, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal bentuk, diukur dari pojok kiri atas halaman.
widthNumberLebar bentuk.
heightNumberTinggi bentuk.

Pulang pergi

Shape — Bentuk yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertSheetsChart(sourceChart)

Menyisipkan diagram Google Spreadsheet di halaman.

Diagram disisipkan dengan ukuran default di pojok kiri atas halaman.

Diagram yang disisipkan ditautkan dengan diagram Google Spreadsheet sumber yang memungkinkannya untuk diperbarui. Kolaborator lain dapat melihat link ke spreadsheet sumber.

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

Parameter

NamaJenisDeskripsi
sourceChartEmbeddedChartDiagram dalam spreadsheet yang akan disisipkan di halaman.

Pulang pergi

SheetsChart — Diagram yang disisipkan di halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan diagram Google Spreadsheet di halaman dengan posisi dan ukuran yang disediakan.

Untuk mempertahankan rasio lebar tinggi diagram, diagram diskalakan dan dipusatkan sehubungan dengan ukuran yang diberikan.

Diagram yang disisipkan ditautkan dengan diagram Google Spreadsheet sumber yang memungkinkannya untuk diperbarui. Kolaborator lain dapat melihat link ke spreadsheet sumber.

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

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

Parameter

NamaJenisDeskripsi
sourceChartEmbeddedChartDiagram dalam spreadsheet yang akan disisipkan di halaman.
leftNumberPosisi horizontal diagram dalam titik, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal diagram dalam titik, diukur dari sudut kiri atas halaman.
widthNumberLebar diagram dalam titik.
heightNumberTinggi diagram dalam titik.

Pulang pergi

SheetsChart — Diagram yang disisipkan di halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertSheetsChart(sheetsChart)

Menyisipkan salinan SheetsChart yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

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

Parameter

NamaJenisDeskripsi
sheetsChartSheetsChartDiagram sheet yang akan disalin dan disisipkan.

Pulang pergi

SheetsChart — Diagram sheet yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertSheetsChartAsImage(sourceChart)

Menyisipkan diagram Google Spreadsheet sebagai Image di halaman.

Gambar diagram disisipkan dengan ukuran default di sudut kiri atas halaman.

Gambar diagram yang disisipkan tidak tertaut dengan diagram Google Spreadsheet sumber.

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

Parameter

NamaJenisDeskripsi
sourceChartEmbeddedChartDiagram dalam spreadsheet yang akan disisipkan di halaman.

Pulang pergi

Image — Gambar diagram yang disisipkan di halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan diagram Google Spreadsheet sebagai Image di halaman dengan posisi dan ukuran yang diberikan.

Untuk mempertahankan rasio lebar tinggi gambar diagram, gambar diskalakan dan dipusatkan dengan menghormati ukuran yang diberikan.

Gambar diagram yang disisipkan tidak tertaut dengan diagram Google Spreadsheet sumber.

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

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

Parameter

NamaJenisDeskripsi
sourceChartEmbeddedChartDiagram dalam spreadsheet yang akan disisipkan di halaman.
leftNumberPosisi horizontal diagram dalam titik, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal diagram dalam titik, diukur dari sudut kiri atas halaman.
widthNumberLebar diagram dalam titik.
heightNumberTinggi diagram dalam titik.

Pulang pergi

Image — Gambar diagram yang disisipkan di halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertTable(numRows, numColumns)

Menyisipkan tabel pada halaman.

Tabel dipusatkan pada halaman dengan ukuran default dan baris serta kolom yang terdistribusi secara merata.

Parameter

NamaJenisDeskripsi
numRowsIntegerJumlah baris dalam tabel.
numColumnsIntegerJumlah kolom dalam tabel.

Pulang pergi

Table — Tabel yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan tabel pada halaman dengan posisi dan ukuran yang diberikan.

Baris dan kolom didistribusikan secara merata di tabel yang dibuat.

Parameter

NamaJenisDeskripsi
numRowsIntegerJumlah baris dalam tabel.
numColumnsIntegerJumlah kolom dalam tabel.
leftNumberPosisi horizontal tabel, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal tabel, diukur dari sudut kiri atas halaman.
widthNumberLebar tabel.
heightNumberTinggi minimum tabel. Ketinggian sebenarnya dari tabel yang dirender bergantung pada faktor seperti ukuran font teks.

Pulang pergi

Table — Tabel yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertTable(table)

Menyisipkan salinan Table yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

Parameter

NamaJenisDeskripsi
tableTableTabel yang akan disalin dan disisipkan.

Pulang pergi

Table — Tabel yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertTextBox(text)

Menyisipkan kotak teks Shape yang berisi string yang disediakan pada halaman tersebut.

Bentuk kotak teks disisipkan dengan ukuran default di pojok kiri atas halaman.

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

Parameter

NamaJenisDeskripsi
textStringString yang bentuknya berisi kotak teks.

Pulang pergi

Shape — Bentuk kotak teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan kotak teks Shape yang berisi string yang disediakan pada halaman tersebut.

// 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

Parameter

NamaJenisDeskripsi
textStringString yang bentuknya berisi kotak teks.
leftNumberPosisi horizontal bentuk kotak teks, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal bentuk kotak teks, diukur dari sudut kiri atas halaman.
widthNumberLebar bentuk kotak teks.
heightNumberTinggi bentuk kotak teks.

Pulang pergi

Shape — Bentuk kotak teks yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertVideo(videoUrl)

Menyisipkan video di pojok kiri atas halaman dengan ukuran default.

Hanya video YouTube yang saat ini didukung.

Parameter

NamaJenisDeskripsi
videoUrlStringURL video yang akan disisipkan.

Pulang pergi

Video — Video yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

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

Menyisipkan video di halaman dengan posisi dan ukuran yang diberikan.

Hanya video YouTube yang saat ini didukung.

Parameter

NamaJenisDeskripsi
videoUrlStringURL video yang akan disisipkan.
leftNumberPosisi horizontal video dalam titik, yang diukur dari pojok kiri atas halaman.
topNumberPosisi vertikal video dalam titik, yang diukur dari sudut kiri atas halaman.
widthNumberLebar video dalam poin.
heightNumberTinggi video dalam poin.

Pulang pergi

Video — Video yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertVideo(video)

Menyisipkan salinan Video yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

Parameter

NamaJenisDeskripsi
videoVideoVideo yang akan disalin dan disisipkan.

Pulang pergi

Video — Video yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

insertWordArt(wordArt)

Menyisipkan salinan WordArt yang disediakan di halaman.

Posisi elemen yang disisipkan pada halaman ini ditentukan dari posisi elemen sumber pada halamannya masing-masing.

Jika elemen yang disediakan adalah placeholder yang disalin dari dalam presentasi saat ini, properti yang diwarisi dari halaman master atau tata letak juga mewarisi elemen yang disisipkan.

Jika elemen yang disediakan adalah placeholder yang disalin dari presentasi yang berbeda, properti yang diwarisi dari halaman master atau tata letak akan disalin ke elemen dari presentasi sumber.

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

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

Parameter

NamaJenisDeskripsi
wordArtWordArtGrup yang akan disalin dan disisipkan.

Pulang pergi

WordArt — Seni kata yang disisipkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

remove()

Menghapus halaman.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replaceAllText(findText, replaceText)

Mengganti semua instance pencocokan teks temukan teks dengan ganti teks. Penelusuran tidak peka huruf besar/kecil.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.

Pulang pergi

Integer — jumlah kejadian berubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replaceAllText(findText, replaceText, matchCase)

Mengganti semua instance pencocokan teks temukan teks dengan ganti teks.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks yang akan menggantikan teks yang cocok.
matchCaseBooleanJika true, penelusuran peka huruf besar/kecil; jika false, penelusuran tidak peka huruf besar/kecil.

Pulang pergi

Integer — jumlah kejadian berubah

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

selectAsCurrentPage()

Memilih Page dalam presentasi aktif sebagai current page selection dan menghapus pilihan sebelumnya.

Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan presentasi.

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

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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