Class Layout

Tata letak

Tata letak dalam presentasi.

Setiap tata letak berfungsi sebagai template untuk slide yang mewarisinya, yang menentukan cara 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 placeholder yang cocok tidak ada.
getPlaceholder(placeholderType, placeholderIndex)PageElementMenampilkan objek PageElement placeholder untuk PlaceholderType yang ditentukan dan indeks placeholder, 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 diberikan 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 di halaman dengan posisi dan ukuran yang disediakan dari blob gambar yang ditentukan.
insertImage(image)ImageMenyisipkan salinan Image yang diberikan di halaman.
insertImage(imageUrl)ImageMenyisipkan gambar di pojok kiri atas halaman dengan ukuran default dari URL yang diberikan.
insertImage(imageUrl, left, top, width, height)ImageMenyisipkan gambar di halaman dengan posisi dan ukuran yang diberikan dari URL yang disediakan.
insertLine(line)LineMenyisipkan salinan Line yang diberikan di halaman.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineMenyisipkan baris di halaman yang menghubungkan dua connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineMenyisipkan garis di halaman.
insertPageElement(pageElement)PageElementMenyisipkan salinan PageElement yang diberikan di halaman.
insertShape(shape)ShapeMenyisipkan salinan Shape yang diberikan di halaman.
insertShape(shapeType)ShapeMenyisipkan bentuk di halaman.
insertShape(shapeType, left, top, width, height)ShapeMenyisipkan bentuk di 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 diberikan 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 di halaman.
insertTable(numRows, numColumns, left, top, width, height)TableMenyisipkan tabel di halaman dengan posisi dan ukuran yang disediakan.
insertTable(table)TableMenyisipkan salinan Table yang diberikan di halaman.
insertTextBox(text)ShapeMenyisipkan kotak teks Shape yang berisi string yang diberikan di halaman.
insertTextBox(text, left, top, width, height)ShapeMenyisipkan kotak teks Shape yang berisi string yang diberikan di halaman.
insertVideo(videoUrl)VideoMenyisipkan video di sudut 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 diberikan di halaman.
insertWordArt(wordArt)WordArtMenyisipkan salinan WordArt yang diberikan di halaman.
remove()voidMenghapus halaman.
replaceAllText(findText, replaceText)IntegerMengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua instance teks yang cocok dengan teks temukan dengan teks ganti.
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 memiliki 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 placeholder yang cocok tidak ada.

Jika ada beberapa placeholder dengan jenis yang sama, metode ini akan menampilkan placeholder dengan indeks placeholder minimum. Jika ada beberapa placeholder yang cocok dengan indeks yang sama, metode ini akan menampilkan placeholder pertama dari koleksi elemen halaman halaman.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 yang ditentukan dan indeks placeholder, 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.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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.

const 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.

Harus ada minimal dua elemen halaman di halaman yang sama yang belum ada dalam 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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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.

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 sekali dan salinan 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.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
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 di halaman dengan posisi dan ukuran yang disediakan dari blob gambar yang ditentukan.

Gambar diambil dari BlobSource yang disediakan sekali pada waktu penyisipan dan salinan 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.

Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan dengan mempertimbangkan ukuran yang diberikan.

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);

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.
leftNumberPosisi horizontal gambar dalam titik, diukur dari sudut 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 diberikan di halaman.

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

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

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

// 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);

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 diberikan.

Penyisipan gambar akan mengambilnya dari URL 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.

URL yang diberikan harus dapat diakses secara publik dan tidak lebih besar 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 di halaman dengan posisi dan ukuran yang diberikan dari URL yang disediakan.

Penyisipan gambar akan mengambilnya dari URL 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.

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

Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan dengan mempertimbangkan ukuran yang diberikan.

Parameter

NamaJenisDeskripsi
imageUrlStringURL gambar.
leftNumberPosisi horizontal gambar dalam titik, diukur dari sudut 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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 di 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.
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],
);

Parameter

NamaJenisDeskripsi
lineCategoryLineCategoryKategori baris yang akan disisipkan.
startConnectionSiteConnectionSiteSitus koneksi tempat awal garis akan dihubungkan.
endConnectionSiteConnectionSiteSitus koneksi tempat ujung garis 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 garis di halaman.

// 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,
);

Parameter

NamaJenisDeskripsi
lineCategoryLineCategoryKategori baris yang akan disisipkan.
startLeftNumberPosisi horizontal titik awal garis, diukur dalam titik dari sudut kiri atas halaman.
startTopNumberPosisi vertikal titik awal garis, diukur dalam titik dari sudut kiri atas halaman.
endLeftNumberPosisi horizontal titik akhir garis, yang diukur dalam titik dari sudut kiri atas halaman.
endTopNumberPosisi vertikal titik akhir garis, diukur dalam titik dari sudut 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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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);

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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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.

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 di halaman.

Bentuk disisipkan dengan ukuran default di sudut kiri atas halaman.

// 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);

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 di halaman.

Parameter

NamaJenisDeskripsi
shapeTypeShapeTypeJenis bentuk yang akan disisipkan.
leftNumberPosisi horizontal bentuk, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal bentuk, diukur dari sudut 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 sudut kiri atas halaman.

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

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);

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 aspek diagram, diagram diskalakan dan dipusatkan sesuai dengan ukuran yang diberikan.

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

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,
);

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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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);

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 ditautkan dengan diagram Google Spreadsheet sumber.

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.

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 aspek gambar diagram, gambar diskalakan dan dipusatkan berdasarkan ukuran yang diberikan.

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

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,
);

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 di halaman.

Tabel dipusatkan di halaman dengan ukuran default serta baris dan kolom yang didistribusikan 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 di halaman dengan posisi dan ukuran yang disediakan.

Baris dan kolom didistribusikan secara merata dalam 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. Tinggi sebenarnya 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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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.

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 diberikan di halaman.

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

// 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.

Parameter

NamaJenisDeskripsi
textStringString yang harus berisi 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

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

Menyisipkan kotak teks Shape yang berisi string yang diberikan di halaman.

// 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.

Parameter

NamaJenisDeskripsi
textStringString yang harus berisi bentuk 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 sudut kiri atas halaman dengan ukuran default.

Saat ini, hanya video YouTube yang 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.

Saat ini, hanya video YouTube yang didukung.

Parameter

NamaJenisDeskripsi
videoUrlStringURL video yang akan disisipkan.
leftNumberPosisi horizontal video dalam titik, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal video dalam titik, diukur dari sudut kiri atas halaman.
widthNumberLebar video dalam titik.
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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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.

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 diberikan di halaman.

Posisi elemen yang disisipkan di halaman ini ditentukan dari posisi elemen sumber di 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 diwarisi pada 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.
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);

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 teks yang cocok dengan teks temukan dengan teks ganti. Penelusuran tidak peka huruf besar/kecil.

Parameter

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

Pulang pergi

Integer — jumlah kemunculan yang diubah

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 teks yang cocok dengan teks temukan dengan teks ganti.

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 kemunculan yang diubah

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.
const 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