Class Layout

Tata letak

Tata letak dalam presentasi.

Setiap tata letak berfungsi sebagai {i>template<i} untuk {i>slide<i} yang mewarisinya, menentukan bagaimana konten {i>slide<i} itu diatur dan ditata.

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 pada 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 yang ditentukan atau null 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 disediakan di halaman.
insertImage(blobSource)ImageMenyisipkan gambar di sudut kiri atas halaman dengan ukuran default dari sebagai blob gambar.
insertImage(blobSource, left, top, width, height)ImageMenyisipkan gambar di halaman dengan posisi dan ukuran yang diberikan dari blob gambar yang ditentukan.
insertImage(image)ImageMenyisipkan salinan Image yang disediakan di halaman.
insertImage(imageUrl)ImageMenyisipkan gambar di sudut 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 diberikan.
insertLine(line)LineMenyisipkan salinan Line yang disediakan di halaman.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineMenyisipkan baris di halaman yang menghubungkan dua connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineMenyisipkan garis pada halaman.
insertPageElement(pageElement)PageElementMenyisipkan salinan PageElement yang disediakan di halaman.
insertShape(shape)ShapeMenyisipkan salinan Shape yang disediakan 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 pada 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 yang diberikan dan ukuran.
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 disediakan di halaman.
insertTextBox(text)ShapeMenyisipkan kotak teks Shape yang berisi string yang disediakan di halaman.
insertTextBox(text, left, top, width, height)ShapeMenyisipkan kotak teks Shape yang berisi string yang disediakan 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 disediakan.
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 contoh pencocokan teks temukan teks dengan teks pengganti.
replaceAllText(findText, replaceText, matchCase)IntegerMengganti semua contoh pencocokan teks temukan teks dengan teks pengganti.
selectAsCurrentPage()voidMemilih Page di presentasi aktif sebagai current page selection dan menghapus semua 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 kesamaan namespace.

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 pada halaman dengan ID yang diberikan, atau null jika tidak ada.

Parameter

NamaJenisDeskripsi
idStringID elemen halaman yang 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 yang ditentukan atau null jika placeholder yang cocok tidak ada.

Jika ada beberapa placeholder dengan jenis yang sama, placeholder dengan jenis yang sama akan ditampilkan indeks placeholder. Jika ada beberapa placeholder yang cocok dengan indeks yang sama, hasil yang ditampilkan {i>placeholder<i} pertama dari koleksi elemen laman laman.

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 yang ditentukan dan indeks placeholder, atau null jika placeholder tidak ada.

Jika ada beberapa placeholder dengan jenis dan indeks yang sama, metode ini akan menampilkan {i>placeholder<i} dari koleksi elemen laman laman.

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 pada halaman yang sama yang belum ada di halaman lain ras. Beberapa elemen halaman, seperti Videos, Tables, dan placeholder Shapes tidak dapat dikelompokkan.

Parameter

NamaJenisDeskripsi
pageElementsPageElement[]Elemen yang akan dikelompokkan bersama.

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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 sebagai blob gambar.

Menyisipkan gambar akan mengambilnya dari BlobSource satu kali 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.

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 di halaman dengan posisi dan ukuran yang diberikan dari blob gambar yang ditentukan.

Gambar diambil dari BlobSource yang disediakan satu kali pada waktu penyisipan dan salinannya disimpan untuk ditampilkan 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 aspek gambar, gambar diskalakan dan dipusatkan dengan memperhatikan ke ukuran yang disediakan.

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 sudut kiri atas halaman.
topNumberPosisi vertikal gambar dalam titik, yang diukur dari sudut kiri atas pada 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 di halamannya masing-masing.

Jika gambar yang diberikan adalah {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi dari gambar yang disisipkan.

Jika gambar yang diberikan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke gambar dari sumbernya presentasi. Jika gambar placeholder yang disalin kosong, tidak ada yang disisipkan dalam tujuan presentasi.

// 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 sudut kiri atas halaman dengan ukuran default dari URL yang diberikan.

Menyisipkan 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 lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

URL yang diberikan harus dapat diakses secara publik dan berukuran maksimal 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 diberikan.

Menyisipkan 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 lebih dari 25 megapiksel, dan harus dalam format PNG, JPEG, atau GIF.

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

Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan dengan memperhatikan ke ukuran yang disediakan.

Parameter

NamaJenisDeskripsi
imageUrlStringURL gambar.
leftNumberPosisi horizontal gambar dalam titik, yang diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal gambar dalam titik, yang diukur dari sudut kiri atas pada 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 — Garis 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. Dua situs koneksi harus ada 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 garis terhubung.
endConnectionSiteConnectionSiteSitus koneksi di mana ujung garis terhubung.

Pulang pergi

Line — Garis 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 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 dari titik awal garis, diukur dalam titik dari pojok kiri atas halaman.
startTopNumberPosisi vertikal dari titik awal garis, diukur dalam titik dari sudut kiri atas halaman.
endLeftNumberPosisi horizontal dari titik akhir garis, diukur dalam titik-titik dari sudut kiri atas halaman.
endTopNumberPosisi vertikal dari titik akhir garis, diukur dalam titik dari pojok kiri atas halaman.

Pulang pergi

Line — Garis 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

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

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

Parameter

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

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
sourceChartEmbeddedChartBagan dalam {i>spreadsheet<i} yang akan dimasukkan ke dalam 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 pada halaman dengan posisi dan ukuran yang disediakan.

Untuk mempertahankan rasio aspek diagram, diagram diskalakan dan dipusatkan dengan memperhatikan ke ukuran yang disediakan.

Diagram yang disisipkan ditautkan dengan diagram Google Spreadsheet sumber yang memungkinkannya 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
sourceChartEmbeddedChartBagan dalam {i>spreadsheet<i} yang akan dimasukkan ke dalam halaman.
leftNumberPosisi horizontal diagram dalam titik, yang diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal bagan dalam titik, yang diukur dari sudut kiri atas pada halaman.
widthNumberLebar diagram dalam poin.
heightNumberTinggi diagram dalam poin.

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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 ditautkan 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
sourceChartEmbeddedChartBagan dalam {i>spreadsheet<i} yang akan dimasukkan ke dalam 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 yang diberikan dan ukuran.

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

Gambar diagram yang disisipkan tidak ditautkan 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
sourceChartEmbeddedChartBagan dalam {i>spreadsheet<i} yang akan dimasukkan ke dalam halaman.
leftNumberPosisi horizontal diagram dalam titik, yang diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal bagan dalam titik, yang diukur dari sudut kiri atas pada halaman.
widthNumberLebar diagram dalam poin.
heightNumberTinggi diagram dalam poin.

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 berada di tengah halaman dengan ukuran default serta baris dan kolom yang didistribusikan secara merata.

Parameter

NamaJenisDeskripsi
numRowsIntegerJumlah baris dalam tabel.
numColumnsIntegerJumlah kolom di 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 di tabel.
leftNumberPosisi horizontal tabel, yang diukur dari sudut kiri atas tabel kami.
topNumberPosisi vertikal tabel, diukur dari sudut kiri atas halaman.
widthNumberLebar tabel.
heightNumberTinggi minimum tabel. Tinggi sebenarnya dari tabel yang dirender bergantung beberapa 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

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

Parameter

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

Parameter

NamaJenisDeskripsi
textStringString yang harus terdapat dalam bentuk kotak teks.
leftNumberPosisi horizontal dari bentuk kotak teks, diukur dari sudut kiri atas halaman.
topNumberPosisi vertikal dari bentuk kotak teks, diukur dari sudut kiri atas pada 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.

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

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 pada 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 {i>placeholder<i} yang disalin dari dalam presentasi saat ini, properti yang mewarisi dari halaman tata letak atau master juga mewarisi pada elemen yang disisipkan.

Jika elemen yang disediakan adalah {i>placeholder<i} yang disalin dari presentasi yang berbeda, properti yang mewarisi dari halaman tata letak atau master akan disalin ke elemen dari sumber presentasi.

// 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 — Kata seni 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 contoh pencocokan teks temukan teks dengan teks pengganti. Penelusuran ini dilakukan tidak peka.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks untuk mengganti 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 contoh pencocokan teks temukan teks dengan teks pengganti.

Parameter

NamaJenisDeskripsi
findTextStringTeks yang akan dicari.
replaceTextStringTeks untuk mengganti teks yang cocok.
matchCaseBooleanJika true, penelusuran peka huruf besar/kecil; jika false, penelusurannya adalah 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 di presentasi aktif sebagai current page selection dan menghapus semua 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