Class Image

Image

PageElement yang merepresentasikan gambar.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
alignOnPage(alignmentPosition)ImageMenyejajarkan elemen dengan posisi perataan yang ditentukan pada halaman.
bringForward()ImageMajukan elemen halaman di halaman sebanyak satu elemen.
bringToFront()ImageMenampilkan elemen halaman di bagian depan halaman.
duplicate()PageElementMenduplikasi elemen halaman.
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBlob()BlobMenampilkan data di dalam gambar ini sebagai blob.
getBorder()BorderMenampilkan Border gambar.
getConnectionSites()ConnectionSite[]Menampilkan daftar ConnectionSite pada elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.
getContentUrl()StringMendapatkan URL ke gambar.
getDescription()StringMenampilkan deskripsi teks alternatif elemen halaman.
getHeight()NumberMendapatkan tinggi elemen dalam poin, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
getInherentHeight()NumberMenampilkan tinggi inheren elemen dalam titik.
getInherentWidth()NumberMenampilkan lebar inheren elemen dalam titik.
getLeft()NumberMenampilkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
getLink()LinkMenampilkan Link atau null jika tidak ada link.
getObjectId()StringMenampilkan ID unik untuk objek ini.
getPageElementType()PageElementTypeMenampilkan jenis elemen halaman, yang diwakili sebagai enum PageElementType.
getParentGroup()GroupMenampilkan grup yang memiliki elemen halaman ini, atau null jika elemen tidak ada dalam grup.
getParentPage()PageMenampilkan halaman tempat elemen halaman ini aktif.
getParentPlaceholder()PageElementMenampilkan elemen halaman induk dari placeholder.
getPlaceholderIndex()IntegerMenampilkan indeks gambar placeholder.
getPlaceholderType()PlaceholderTypeMenampilkan jenis placeholder gambar, atau PlaceholderType.NONE jika bentuknya bukan placeholder.
getRotation()NumberMenampilkan sudut rotasi searah jarum jam pada pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
getSourceUrl()StringMendapatkan URL sumber gambar, jika tersedia.
getTitle()StringMenampilkan judul teks alternatif elemen halaman.
getTop()NumberMendapatkan posisi vertikal elemen dalam titik, yang diukur dari pojok kiri atas halaman saat elemen tidak memiliki rotasi.
getTransform()AffineTransformMenampilkan transformasi elemen halaman.
getWidth()NumberMenampilkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi.
preconcatenateTransform(transform)ImageMengonsolidasikan transformasi yang diberikan ke transformasi elemen halaman yang ada.
remove()voidMenghapus elemen halaman.
removeLink()voidMenghapus Link.
replace(blobSource)ImageMengganti gambar ini dengan gambar yang dijelaskan oleh objek BlobSource.
replace(blobSource, crop)ImageMengganti gambar ini dengan gambar yang dijelaskan oleh objek Image, secara opsional memangkas gambar agar sesuai.
replace(imageUrl)ImageMengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan.
replace(imageUrl, crop)ImageMengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan, secara opsional memangkas gambar agar sesuai.
scaleHeight(ratio)ImageMenskalakan tinggi elemen dengan rasio yang ditentukan.
scaleWidth(ratio)ImageMenskalakan lebar elemen berdasarkan rasio yang ditentukan.
select()voidHanya memilih PageElement di presentasi aktif dan menghapus pemilihan sebelumnya.
select(replace)voidMemilih PageElement di presentasi aktif.
sendBackward()ImageMengirimkan elemen halaman ke belakang pada halaman sebesar satu elemen.
sendToBack()ImageMengirim elemen halaman ke bagian belakang halaman.
setDescription(description)ImageMenetapkan deskripsi teks alternatif elemen halaman.
setHeight(height)ImageMenetapkan tinggi elemen dalam titik, yaitu tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
setLeft(left)ImageMenetapkan posisi horizontal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
setLinkSlide(slideIndex)LinkMenetapkan Link ke Slide yang ditentukan menggunakan indeks berbasis nol dari slide.
setLinkSlide(slide)LinkMenetapkan Link ke Slide yang ditentukan, link disetel oleh ID slide tertentu.
setLinkSlide(slidePosition)LinkMenyetel Link ke Slide yang ditentukan menggunakan posisi relatif slide.
setLinkUrl(url)LinkMenetapkan Link ke string URL yang tidak kosong.
setRotation(angle)ImageMenetapkan sudut rotasi searah jarum jam pada elemen di sekitar pusatnya dalam derajat.
setTitle(title)ImageMenetapkan judul teks alternatif elemen halaman.
setTop(top)ImageMenetapkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
setTransform(transform)ImageMenetapkan transformasi elemen halaman dengan transformasi yang disediakan.
setWidth(width)ImageMenetapkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi.

Dokumentasi mendetail

alignOnPage(alignmentPosition)

Menyejajarkan elemen dengan posisi perataan yang ditentukan pada halaman.

Parameter

NamaJenisDeskripsi
alignmentPositionAlignmentPositionPosisi untuk menyelaraskan elemen halaman ini pada halaman.

Pulang pergi

Image — Elemen halaman ini, untuk perantaian.


bringForward()

Majukan elemen halaman di halaman sebanyak satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

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

Menampilkan elemen halaman di bagian depan halaman.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Image — 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 pada posisi yang sama seperti 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

getAs(contentType)

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, diasumsikan bahwa bagian dari nama file yang mengikuti periode terakhir (jika ada) adalah ekstensi yang sudah ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat mungkin tunduk pada kuota yang lebih ketat untuk sementara.

Parameter

NamaJenisDeskripsi
contentTypeStringJenis MIME yang akan dikonversi. Untuk sebagian besar blob, 'application/pdf' adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, salah satu dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid.

Pulang pergi

Blob — Data sebagai blob.


getBlob()

Menampilkan data di dalam gambar ini sebagai blob.

Pulang pergi

Blob — Data gambar sebagai blob.


getBorder()

Menampilkan Border gambar.

Pulang pergi

Border — Batas gambar.

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

getContentUrl()

Mendapatkan URL ke gambar.

URL ini diberi tag dengan akun pemohon, sehingga siapa pun yang memiliki URL tersebut dapat mengakses gambar secara efektif sebagai pemohon asli. Akses ke gambar mungkin hilang jika setelan berbagi presentasi berubah. Masa berlaku URL yang ditampilkan akan berakhir setelah beberapa saat.

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

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

getHeight()

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

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

Pulang pergi

Number — Tinggi inheren 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 seiring dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Tinggi inheren 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 seiring dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Lebar 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 dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Pulang pergi

Number — Posisi cakrawala 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

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 diwakili 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 yang memiliki elemen halaman ini, 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 aktif.

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 dari placeholder. Menampilkan null jika gambar bukan placeholder atau tidak memiliki induk.

Pulang pergi

PageElement — Elemen halaman induk dari placeholder gambar ini, atau null jika gambar 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 gambar placeholder. Jika dua atau beberapa gambar placeholder pada halaman yang sama berjenis sama, masing-masing memiliki nilai indeks yang unik. Menampilkan null jika gambar bukan placeholder.

Pulang pergi

Integer — Indeks placeholder gambar ini, atau null jika gambar 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 gambar, atau PlaceholderType.NONE jika bentuknya bukan placeholder.

Pulang pergi

PlaceholderType — Jenis placeholder gambar 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 pada 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

getSourceUrl()

Mendapatkan URL sumber gambar, jika tersedia.

Jika gambar disisipkan oleh URL, akan menampilkan URL yang diberikan selama penyisipan gambar.

Pulang pergi

String — URL gambar atau null jika gambar tidak memiliki URL sumber.

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 pojok kiri atas halaman saat elemen tidak memiliki rotasi.

Pulang pergi

Number — Posisi vertikal 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

getTransform()

Menampilkan transformasi elemen halaman.

Tampilan visual elemen halaman ditentukan oleh transformasi absolutnya. Untuk menghitung transformasi absolut, pra-gabungkan transformasi elemen halaman dengan transformasi semua grup induknya. Jika elemen halaman tidak ada dalam grup, transformasi absolutnya sama dengan nilai dalam 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 saat elemen tidak memiliki rotasi.

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

Pulang pergi

Number — Lebar 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)

Mengonsolidasikan transformasi yang diberikan 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

NamaJenisDeskripsi
transformAffineTransformTransformasi yang akan digabungkan dengan transformasi elemen halaman ini.

Pulang pergi

Image — 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 tanpa elemen halaman, grup tersebut juga akan dihapus.

Jika placeholder PageElement dihapus pada 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

Menghapus Link.

shape.removeLink();

replace(blobSource)

Mengganti gambar ini dengan gambar yang dijelaskan oleh objek BlobSource.

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

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

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

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.

Pulang pergi

Image — Ini adalah Image setelah penggantian.

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

replace(blobSource, crop)

Mengganti gambar ini dengan gambar yang dijelaskan oleh objek Image, secara opsional memangkas gambar agar sesuai.

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

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

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceData gambar.
cropBooleanJika true, pangkas gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

Image — Ini adalah Image setelah penggantian.

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

replace(imageUrl)

Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan.

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

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

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

Parameter

NamaJenisDeskripsi
imageUrlStringURL tempat gambar akan didownload.

Pulang pergi

Image — Ini adalah Image setelah penggantian.

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

replace(imageUrl, crop)

Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan, secara opsional memangkas gambar agar sesuai.

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

URL yang diberikan tidak boleh lebih dari 2 kB.

Parameter

NamaJenisDeskripsi
imageUrlStringURL tempat gambar akan didownload.
cropBooleanJika true, pangkas gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

Image — Ini adalah Image setelah penggantian.

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 dengan 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 yang tidak kompatibel dengan metode ini, lihat batasan ukuran dan penempatan.

Parameter

NamaJenisDeskripsi
ratioNumberRasio untuk menskalakan tinggi elemen halaman ini.

Pulang pergi

Image — 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 saat elemen tidak memiliki rotasi.

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

Parameter

NamaJenisDeskripsi
ratioNumberRasio untuk menskalakan lebar elemen halaman ini.

Pulang pergi

Image — 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 di presentasi aktif dan menghapus pemilihan sebelumnya. Ini sama dengan memanggil select(replace) dengan true.

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

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 dengan presentasi.

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

Teruskan false untuk memilih beberapa objek PageElement. Objek PageElement harus ada di 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 bahwa pendekatan yang diinginkan 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

NamaJenisDeskripsi
replaceBooleanJika true, pilihan tersebut 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()

Mengirimkan elemen halaman ke belakang pada halaman sebesar satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Image — 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

Image — 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

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

NamaJenisDeskripsi
descriptionStringString untuk menetapkan deskripsi teks alternatif.

Pulang pergi

Image — 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 dalam titik, yaitu tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.

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

Parameter

NamaJenisDeskripsi
heightNumberKetinggian baru elemen halaman ini yang akan ditetapkan, dalam poin.

Pulang pergi

Image — 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 dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Parameter

NamaJenisDeskripsi
leftNumberPosisi horizontal baru yang akan ditetapkan, dalam titik.

Pulang pergi

Image — 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 ditentukan menggunakan indeks berbasis nol dari slide.

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

Parameter

NamaJenisDeskripsi
slideIndexIntegerIndeks berbasis nol ke slide.

Pulang pergi

LinkLink yang 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 ditentukan, link disetel oleh ID slide tertentu.

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

Parameter

NamaJenisDeskripsi
slideSlideSlide yang akan ditautkan.

Pulang pergi

LinkLink yang 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)

Menyetel Link ke Slide yang ditentukan menggunakan posisi relatif slide.

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

Parameter

NamaJenisDeskripsi
slidePositionSlidePositionSlidePosition relatif.

Pulang pergi

LinkLink yang 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.

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

Parameter

NamaJenisDeskripsi
urlStringString URL.

Pulang pergi

LinkLink yang 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)

Menetapkan sudut rotasi searah jarum jam pada elemen di sekitar pusatnya dalam derajat.

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

Parameter

NamaJenisDeskripsi
angleNumberSudut rotasi searah jarum jam yang baru untuk disetel, dalam derajat.

Pulang pergi

Image — 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

NamaJenisDeskripsi
titleStringString untuk menetapkan judul teks alternatif.

Pulang pergi

Image — 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 dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.

Parameter

NamaJenisDeskripsi
topNumberPosisi vertikal baru yang akan ditetapkan, dalam titik.

Pulang pergi

Image — 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 grup tersebut, yang dapat mengubah tampilan visualnya.

Memperbarui transformasi elemen halaman yang ada dalam grup hanya akan mengubah transformasi elemen halaman tersebut; perubahan tersebut tidak memengaruhi transformasi grup atau elemen halaman lainnya dalam grup.

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

Parameter

NamaJenisDeskripsi
transformAffineTransformTransformasi yang ditetapkan untuk elemen halaman ini.

Pulang pergi

Image — 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 dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi.

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

Parameter

NamaJenisDeskripsi
widthNumberLebar baru elemen halaman yang akan ditetapkan, dalam titik.

Pulang pergi

Image — 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