Class Shape

Bentuk

PageElement yang mewakili bentuk umum yang tidak memiliki klasifikasi yang lebih spesifik. Mencakup kotak teks, persegi panjang, dan bentuk standar lainnya.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
alignOnPage(alignmentPosition)	Shape	Meratakan elemen ke posisi perataan yang ditentukan di halaman.
bringForward()	Shape	Meneruskan elemen halaman pada halaman dengan satu elemen.
bringToFront()	Shape	Membawa elemen halaman ke bagian depan halaman.
duplicate()	PageElement	Menduplikasi elemen halaman.
getAutofit()	Autofit	Menampilkan Autofit teks dalam bentuk ini.
getBorder()	Border	Menampilkan Border bentuk.
getConnectionSites()	ConnectionSite[]	Menampilkan daftar ConnectionSite pada elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.
getContentAlignment()	ContentAlignment	Menampilkan ContentAlignment dari teks dalam bentuk.
getDescription()	String	Menampilkan deskripsi teks alternatif elemen halaman.
getFill()	Fill	Menampilkan Fill bentuk.
getHeight()	Number	Mendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
getInherentHeight()	Number	Menampilkan tinggi inheren elemen dalam titik.
getInherentWidth()	Number	Menampilkan lebar inheren elemen dalam titik.
getLeft()	Number	Menampilkan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
getLink()	Link	Menampilkan Link atau null jika tidak ada link.
getObjectId()	String	Menampilkan ID unik untuk objek ini.
getPageElementType()	PageElementType	Menampilkan jenis elemen halaman, yang direpresentasikan sebagai enum PageElementType.
getParentGroup()	Group	Menampilkan grup tempat elemen halaman ini berada, atau null jika elemen tidak ada dalam grup.
getParentPage()	Page	Menampilkan halaman tempat elemen halaman ini berada.
getParentPlaceholder()	PageElement	Menampilkan elemen halaman induk placeholder.
getPlaceholderIndex()	Integer	Menampilkan indeks placeholder dari bentuk.
getPlaceholderType()	PlaceholderType	Menampilkan jenis placeholder bentuk, atau PlaceholderType.NONE jika bentuk bukan placeholder.
getRotation()	Number	Menampilkan sudut rotasi searah jarum jam elemen di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
getShapeType()	ShapeType	Menampilkan jenis bentuk.
getText()	TextRange	Menampilkan konten teks bentuk.
getTitle()	String	Menampilkan judul teks alternatif elemen halaman.
getTop()	Number	Mendapatkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
getTransform()	AffineTransform	Menampilkan transformasi elemen halaman.
getWidth()	Number	Menampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.
preconcatenateTransform(transform)	Shape	Melakukan prakoneksi transformasi yang disediakan ke transformasi elemen halaman yang ada.
remove()	void	Menghapus elemen halaman.
removeLink()	void	Menghapus Link.
replaceWithImage(blobSource)	Image	Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.
replaceWithImage(blobSource, crop)	Image	Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.
replaceWithImage(imageUrl)	Image	Mengganti bentuk ini dengan gambar.
replaceWithImage(imageUrl, crop)	Image	Mengganti bentuk ini dengan gambar.
replaceWithSheetsChart(sourceChart)	SheetsChart	Mengganti bentuk ini dengan diagram Google Spreadsheet.
replaceWithSheetsChartAsImage(sourceChart)	Image	Mengganti bentuk ini dengan gambar diagram Google Spreadsheet.
scaleHeight(ratio)	Shape	Menskalakan tinggi elemen berdasarkan rasio yang ditentukan.
scaleWidth(ratio)	Shape	Menskalakan lebar elemen berdasarkan rasio yang ditentukan.
select()	void	Hanya memilih PageElement dalam presentasi aktif dan menghapus semua pemilihan sebelumnya.
select(replace)	void	Memilih PageElement di presentasi aktif.
sendBackward()	Shape	Mengirim elemen halaman mundur pada halaman sebesar satu elemen.
sendToBack()	Shape	Mengirim elemen halaman ke bagian belakang halaman.
setContentAlignment(contentAlignment)	Shape	Menetapkan ContentAlignment teks dalam bentuk.
setDescription(description)	Shape	Menetapkan deskripsi teks alternatif elemen halaman.
setHeight(height)	Shape	Menetapkan tinggi elemen pada titik, yang merupakan tinggi kotak pembatas elemen jika elemen tidak memiliki rotasi.
setLeft(left)	Shape	Menetapkan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
setLinkSlide(slideIndex)	Link	Menetapkan Link ke Slide yang diberikan menggunakan indeks berbasis nol dari slide.
setLinkSlide(slide)	Link	Menetapkan Link ke Slide yang diberikan, link ditetapkan oleh ID slide yang diberikan.
setLinkSlide(slidePosition)	Link	Menetapkan Link ke Slide yang diberikan menggunakan posisi relatif slide.
setLinkUrl(url)	Link	Menetapkan Link ke string URL yang tidak kosong yang diberikan.
setRotation(angle)	Shape	Menyetel sudut rotasi searah jarum jam di sekitar pusatnya dalam derajat.
setTitle(title)	Shape	Menetapkan judul teks alternatif elemen halaman.
setTop(top)	Shape	Menetapkan posisi vertikal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
setTransform(transform)	Shape	Menetapkan transformasi elemen halaman dengan transformasi yang disediakan.
setWidth(width)	Shape	Menetapkan lebar elemen pada titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.

Dokumentasi mendetail

alignOnPage(alignmentPosition)

Meratakan elemen ke posisi perataan yang ditentukan di halaman.

Parameter

Name	Jenis	Deskripsi
alignmentPosition	AlignmentPosition	Posisi untuk menyelaraskan elemen halaman ini di halaman.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

---

bringForward()

Meneruskan elemen halaman pada halaman dengan satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

bringToFront()

Membawa elemen halaman ke bagian depan halaman.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

duplicate()

Menduplikasi elemen halaman.

Elemen halaman duplikat ditempatkan pada halaman yang sama dengan posisi yang sama dengan halaman aslinya.

Pulang pergi

PageElement — Duplikat baru dari elemen halaman ini.

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

---

getAutofit()

Menampilkan Autofit teks dalam bentuk ini. Ini adalah null jika bentuknya tidak mengizinkan teks.

Pulang pergi

Autofit — Pas otomatis teks dalam bentuk ini.

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

---

getBorder()

Menampilkan Border bentuk.

Pulang pergi

Border — Setelan batas bentuk ini.

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

---

getConnectionSites()

Menampilkan daftar ConnectionSite pada elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.

Pulang pergi

ConnectionSite[] — Daftar situs koneksi, yang mungkin kosong jika elemen ini tidak memiliki situs koneksi.

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

---

getContentAlignment()

Menampilkan ContentAlignment dari teks dalam bentuk.

Pulang pergi

ContentAlignment — Perataan teks dalam bentuk ini.

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

---

getDescription()

Menampilkan deskripsi teks alternatif elemen halaman. Deskripsi digabungkan dengan judul untuk menampilkan dan membaca teks alternatif.

Pulang pergi

String — Deskripsi teks alternatif elemen 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

---

getFill()

Menampilkan Fill bentuk.

Pulang pergi

Fill — Setelan isian bentuk ini.

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

---

getHeight()

Mendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Pulang pergi

Number — Tinggi elemen halaman dalam titik, atau null jika elemen halaman tidak memiliki tinggi.

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

---

getInherentHeight()

Menampilkan tinggi inheren elemen dalam titik.

Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran inheren bersama transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Tinggi elemen halaman dalam titik, atau null jika elemen halaman tidak memiliki tinggi.

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

---

getInherentWidth()

Menampilkan lebar inheren elemen dalam titik.

Transformasi elemen halaman relatif terhadap ukuran yang melekat. Gunakan ukuran inheren bersama transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Lebar yang melekat pada elemen halaman dalam poin, atau null jika elemen halaman tidak memiliki lebar.

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

---

getLeft()

Menampilkan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Pulang pergi

Number — Posisi horizontal elemen ini dalam titik, dari sudut kiri atas 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

---

getLink()

Menampilkan Link atau null jika tidak ada link.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Pulang pergi

Link

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

Menampilkan ID unik untuk objek ini. ID objek yang digunakan oleh halaman dan elemen halaman memiliki namespace yang sama.

Pulang pergi

String — ID unik untuk objek ini.

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

---

getPageElementType()

Menampilkan jenis elemen halaman, yang direpresentasikan sebagai enum PageElementType.

Pulang pergi

PageElementType — Jenis elemen 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

---

getParentGroup()

Menampilkan grup tempat elemen halaman ini berada, atau null jika elemen tidak ada dalam grup.

Pulang pergi

Group — Grup tempat elemen halaman ini berada, atau null.

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

---

getParentPage()

Menampilkan halaman tempat elemen halaman ini berada.

Pulang pergi

Page — Halaman tempat elemen ini berada.

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

---

getParentPlaceholder()

Menampilkan elemen halaman induk placeholder. Menampilkan null jika bentuknya bukan placeholder atau tidak memiliki induk.

Pulang pergi

PageElement — Elemen halaman induk placeholder bentuk ini, atau null jika bentuk ini bukan placeholder atau tidak memiliki induk.

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

---

getPlaceholderIndex()

Menampilkan indeks placeholder dari bentuk. Jika dua atau beberapa instance dari jenis placeholder yang sama ada di halaman yang sama, masing-masing instance memiliki nilai indeks uniknya sendiri. Menampilkan null jika bentuk bukan placeholder.

Pulang pergi

Integer — Indeks placeholder bentuk ini, atau null jika bentuknya bukan placeholder.

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

---

getPlaceholderType()

Menampilkan jenis placeholder bentuk, atau PlaceholderType.NONE jika bentuk bukan placeholder.

Pulang pergi

PlaceholderType — Jenis placeholder bentuk ini.

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

---

getRotation()

Menampilkan sudut rotasi searah jarum jam elemen di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.

Pulang pergi

Number — Sudut rotasi dalam derajat antara 0 (inklusif) dan 360 (eksklusif).

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

---

getShapeType()

Menampilkan jenis bentuk.

Pulang pergi

ShapeType — Jenis bentuk ini.

---

getText()

Menampilkan konten teks bentuk.

Teks dalam suatu bentuk selalu diakhiri dengan karakter baris baru.

Pulang pergi

TextRange — Konten teks bentuk ini.

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

---

getTitle()

Menampilkan judul teks alternatif elemen halaman. Judul digabungkan dengan deskripsi untuk menampilkan dan membaca teks alternatif.

Pulang pergi

String — Judul teks alternatif elemen 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

---

getTop()

Mendapatkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Pulang pergi

Number — Posisi vertikal elemen ini di titik, dari sudut kiri atas 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

---

getTransform()

Menampilkan transformasi elemen halaman.

Tampilan visual elemen halaman ditentukan oleh transformasi absolutnya. Untuk menghitung transformasi absolut, gabungkan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak berada dalam grup, transformasi absolutnya sama dengan nilai di kolom ini.

Pulang pergi

AffineTransform — Transformasi elemen 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

---

getWidth()

Menampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Pulang pergi

Number — Lebar yang melekat pada elemen halaman dalam poin, atau null jika elemen halaman tidak memiliki lebar.

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

---

preconcatenateTransform(transform)

Melakukan prakoneksi transformasi yang disediakan ke transformasi elemen halaman yang ada.

newTransform = argument * existingTransform

Misalnya, untuk memindahkan elemen halaman 36 poin ke kiri:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Anda juga dapat mengganti transformasi elemen halaman dengan setTransform(transform).

Parameter

Name	Jenis	Deskripsi
transform	AffineTransform	Transformasi untuk melakukan prakoneksi ke transformasi elemen halaman ini.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

Jika setelah operasi penghapusan, Group hanya berisi satu atau tidak berisi satu elemen halaman, grup itu sendiri juga akan dihapus.

Jika placeholder PageElement dihapus di master atau tata letak, placeholder pewarisan kosong juga akan dihapus.

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

---

removeLink()

Menghapus Link.

shape.removeLink();

---

replaceWithImage(blobSource)

Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.

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

Untuk mempertahankan rasio aspek gambar, gambar diskalakan dan dipusatkan sesuai dengan ukuran bentuk yang ada.

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

Parameter

Name	Jenis	Deskripsi
blobSource	BlobSource	Data gambar.

Pulang pergi

Image — Image yang menggantikan bentuk.

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

---

replaceWithImage(blobSource, crop)

Mengganti bentuk ini dengan gambar yang disediakan oleh BlobSource.

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

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parameter

Name	Jenis	Deskripsi
blobSource	BlobSource	Data gambar.
crop	Boolean	Jika true, memangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

Image — Image yang menggantikan bentuk.

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

---

replaceWithImage(imageUrl)

Mengganti bentuk ini dengan gambar.

Gambar akan diambil satu kali dari URL, 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 sesuai dengan ukuran bentuk yang ada.

Parameter

Name	Jenis	Deskripsi
imageUrl	String	URL gambar untuk mendownload gambar.

Pulang pergi

Image — Image yang mengganti bentuk.

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

---

replaceWithImage(imageUrl, crop)

Mengganti bentuk ini dengan gambar.

Gambar akan diambil satu kali dari URL, 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 tidak boleh lebih besar dari 2 kB. URL itu sendiri disimpan bersama gambar dan ditampilkan melalui Image.getSourceUrl().

Parameter

Name	Jenis	Deskripsi
imageUrl	String	URL gambar untuk mendownload gambar.
crop	Boolean	Jika true, memangkas gambar agar sesuai dengan ukuran bentuk yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

Image — Image yang menggantikan bentuk.

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

---

replaceWithSheetsChart(sourceChart)

Mengganti bentuk ini dengan diagram Google Spreadsheet.

Diagram ini 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];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parameter

Name	Jenis	Deskripsi
sourceChart	EmbeddedChart	Bagan dalam {i>spreadsheet<i} yang menggantikan bentuk.

Pulang pergi

SheetsChart — Diagram yang menggantikan bentuk.

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

---

replaceWithSheetsChartAsImage(sourceChart)

Mengganti bentuk ini dengan gambar diagram Google Spreadsheet.

Untuk mempertahankan rasio aspek diagram Google Spreadsheet, gambar diagram diskalakan dan dipusatkan sesuai dengan ukuran bentuk yang ada.

Gambar diagram tidak ditautkan dengan diagram Google Spreadsheet sumber.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parameter

Name	Jenis	Deskripsi
sourceChart	EmbeddedChart	Bagan dalam {i>spreadsheet<i} yang menggantikan bentuk.

Pulang pergi

Image — Gambar diagram yang menggantikan bentuk.

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

---

scaleHeight(ratio)

Menskalakan tinggi elemen berdasarkan rasio yang ditentukan. Tinggi elemen adalah tinggi kotak pembatasnya saat elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Name	Jenis	Deskripsi
ratio	Number	Rasio untuk menskalakan tinggi elemen halaman ini.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

scaleWidth(ratio)

Menskalakan lebar elemen berdasarkan rasio yang ditentukan. Lebar elemen adalah lebar kotak pembatasnya jika elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Name	Jenis	Deskripsi
ratio	Number	Rasio untuk menskalakan lebar elemen halaman ini.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

select()

Hanya memilih PageElement dalam presentasi aktif dan menghapus semua pemilihan sebelumnya. Ini sama dengan memanggil select(replace) dengan true.

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

Tindakan ini akan menetapkan Page induk dari PageElement sebagai current page selection.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

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

---

select(replace)

Memilih PageElement di presentasi aktif.

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

Teruskan true ke metode ini untuk hanya memilih PageElement dan menghapus pilihan sebelumnya. Tindakan ini juga menetapkan Page induk dari PageElement sebagai current page selection.

Teruskan false untuk memilih beberapa objek PageElement. Objek PageElement harus berada dalam Page yang sama.

Kondisi berikut harus dipenuhi saat memilih elemen halaman menggunakan parameter false:

1. Page induk dari objek PageElement harus berupa current page selection.
2. Tidak boleh ada beberapa objek Page yang dipilih.

Untuk memastikan hal itu, pendekatan yang disarankan adalah memilih Page induk terlebih dahulu menggunakan Page.selectAsCurrentPage(), lalu memilih elemen halaman di halaman tersebut.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parameter

Name	Jenis	Deskripsi
replace	Boolean	Jika true, pilihan akan menggantikan pilihan sebelumnya; jika tidak, pilihan akan ditambahkan ke pilihan sebelumnya.

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

---

sendBackward()

Mengirim elemen halaman mundur pada halaman sebesar satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

sendToBack()

Mengirim elemen halaman ke bagian belakang halaman.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

setContentAlignment(contentAlignment)

Menetapkan ContentAlignment teks dalam bentuk.

Metode ini otomatis menonaktifkan properti paskan otomatis teks pada bentuk yang diperbarui.

Parameter

Name	Jenis	Deskripsi
contentAlignment	ContentAlignment	Perataan yang akan ditetapkan.

Pulang pergi

Shape — Bentuk ini, untuk perantaian.

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

---

setDescription(description)

Menetapkan deskripsi teks alternatif elemen halaman.

Metode ini tidak didukung untuk elemen Group.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parameter

Name	Jenis	Deskripsi
description	String	String untuk menetapkan deskripsi teks alternatif.

Pulang pergi

Shape — Elemen halaman ini.

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

---

setHeight(height)

Menetapkan tinggi elemen pada titik, yang merupakan tinggi kotak pembatas elemen jika elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Name	Jenis	Deskripsi
height	Number	Tinggi baru elemen halaman ini yang akan ditetapkan, dalam poin.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

setLeft(left)

Menetapkan posisi horizontal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Parameter

Name	Jenis	Deskripsi
left	Number	Posisi horizontal baru yang akan ditetapkan, dalam poin.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

setLinkSlide(slideIndex)

Menetapkan Link ke Slide yang diberikan menggunakan indeks berbasis nol dari slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parameter

Name	Jenis	Deskripsi
slideIndex	Integer	Indeks berbasis nol ke slide.

Pulang pergi

Link — Link yang telah ditetapkan

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

---

setLinkSlide(slide)

Menetapkan Link ke Slide yang diberikan, link ditetapkan oleh ID slide yang diberikan.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parameter

Name	Jenis	Deskripsi
slide	Slide	Slide yang akan ditautkan.

Pulang pergi

Link — Link yang telah ditetapkan

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

---

setLinkSlide(slidePosition)

Menetapkan Link ke Slide yang diberikan menggunakan posisi relatif slide.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parameter

Name	Jenis	Deskripsi
slidePosition	SlidePosition	SlidePosition relatif.

Pulang pergi

Link — Link yang telah ditetapkan

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

---

setLinkUrl(url)

Menetapkan Link ke string URL yang tidak kosong yang diberikan.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parameter

Name	Jenis	Deskripsi
url	String	String URL.

Pulang pergi

Link — Link yang telah ditetapkan

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

---

setRotation(angle)

Menyetel sudut rotasi searah jarum jam di sekitar pusatnya dalam derajat.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Name	Jenis	Deskripsi
angle	Number	Sudut rotasi searah jarum jam baru yang akan ditetapkan, dalam derajat.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

setTitle(title)

Menetapkan judul teks alternatif elemen halaman.

Metode ini tidak didukung untuk elemen Group.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parameter

Name	Jenis	Deskripsi
title	String	String untuk menetapkan judul teks alternatif.

Pulang pergi

Shape — Elemen halaman ini.

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

---

setTop(top)

Menetapkan posisi vertikal elemen pada titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Parameter

Name	Jenis	Deskripsi
top	Number	Posisi vertikal baru yang akan ditetapkan, dalam poin.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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

---

setTransform(transform)

Menetapkan transformasi elemen halaman dengan transformasi yang disediakan.

Memperbarui transformasi grup akan mengubah transformasi absolut elemen halaman dalam kelompok tersebut, yang dapat mengubah tampilan visualnya.

Memperbarui transformasi elemen halaman yang berada dalam suatu grup hanya akan mengubah transformasi elemen halaman tersebut; hal ini tidak memengaruhi transformasi grup atau elemen halaman lainnya dalam grup.

Untuk mengetahui detail tentang pengaruh transformasi terhadap tampilan visual elemen halaman, lihat getTransform().

Parameter

Name	Jenis	Deskripsi
transform	AffineTransform	Transformasi yang disetel untuk elemen halaman ini.

Pulang pergi

Shape — Elemen ini, untuk perantaian.

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

---

setWidth(width)

Menetapkan lebar elemen pada titik, yang merupakan lebar kotak pembatas elemen jika elemen tidak memiliki rotasi.

Metode ini tidak kompatibel dengan semua elemen halaman. Untuk mempelajari elemen halaman mana yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

Name	Jenis	Deskripsi
width	Number	Lebar baru elemen halaman ini yang akan ditetapkan, dalam poin.

Pulang pergi

Shape — Elemen halaman ini, untuk perantaian.

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