Halaman ini diterjemahkan oleh Cloud Translation API.

Class Image

PageElement yang mewakili gambar.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`alignOnPage(alignmentPosition)`	`Image`	Meratakan elemen ke posisi perataan yang ditentukan di halaman.
`bringForward()`	`Image`	Memajukan elemen halaman di halaman dengan satu elemen.
`bringToFront()`	`Image`	Memindahkan elemen halaman ke bagian depan halaman.
`duplicate()`	`PageElement`	Menduplikasi elemen halaman.
`getAs(contentType)`	`Blob`	Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
`getBlob()`	`Blob`	Menampilkan data di dalam gambar ini sebagai blob.
`getBorder()`	`Border`	Menampilkan `Border` gambar.
`getConnectionSites()`	`ConnectionSite[]`	Menampilkan daftar `ConnectionSite` di elemen halaman, atau daftar kosong jika elemen halaman tidak memiliki situs koneksi.
`getContentUrl()`	`String`	Mendapatkan URL ke gambar.
`getDescription()`	`String`	Menampilkan deskripsi teks alternatif elemen halaman.
`getHeight()`	`Number`	Mendapatkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
`getInherentHeight()`	`Number`	Menampilkan tinggi bawaan elemen dalam poin.
`getInherentWidth()`	`Number`	Menampilkan lebar bawaan elemen dalam titik.
`getLeft()`	`Number`	Menampilkan posisi horizontal elemen dalam 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 berada dalam grup.
`getParentPage()`	`Page`	Menampilkan halaman tempat elemen halaman ini berada.
`getParentPlaceholder()`	`PageElement`	Menampilkan elemen halaman induk placeholder.
`getPlaceholderIndex()`	`Integer`	Menampilkan indeks gambar placeholder.
`getPlaceholderType()`	`PlaceholderType`	Menampilkan jenis placeholder gambar, atau `PlaceholderType.NONE` jika bentuknya bukan placeholder.
`getRotation()`	`Number`	Menampilkan sudut rotasi searah jarum jam elemen di sekitar pusatnya dalam derajat, dengan nol derajat berarti tidak ada rotasi.
`getSourceUrl()`	`String`	Mendapatkan URL sumber gambar, jika tersedia.
`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 saat elemen tidak memiliki rotasi.
`preconcatenateTransform(transform)`	`Image`	Menggabungkan transformasi yang disediakan ke transformasi elemen halaman yang ada.
`remove()`	`void`	Menghapus elemen halaman.
`removeLink()`	`void`	Menghapus `Link`.
`replace(blobSource)`	`Image`	Mengganti gambar ini dengan gambar yang dijelaskan oleh objek `BlobSource`.
`replace(blobSource, crop)`	`Image`	Mengganti gambar ini dengan gambar yang dijelaskan oleh objek `Image`, dengan opsi pemangkasan gambar agar sesuai.
`replace(imageUrl)`	`Image`	Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan.
`replace(imageUrl, crop)`	`Image`	Mengganti gambar ini dengan gambar lain yang didownload dari URL yang disediakan, dengan opsional memangkas gambar agar sesuai.
`scaleHeight(ratio)`	`Image`	Menskalakan tinggi elemen dengan rasio yang ditentukan.
`scaleWidth(ratio)`	`Image`	Menskalakan lebar elemen dengan rasio yang ditentukan.
`select()`	`void`	Hanya memilih `PageElement` dalam presentasi aktif dan menghapus pemilihan sebelumnya.
`select(replace)`	`void`	Memilih `PageElement` dalam presentasi aktif.
`sendBackward()`	`Image`	Mengirim elemen halaman ke belakang pada halaman dengan satu elemen.
`sendToBack()`	`Image`	Mengirim elemen halaman ke bagian belakang halaman.
`setDescription(description)`	`Image`	Menetapkan deskripsi teks alternatif elemen halaman.
`setHeight(height)`	`Image`	Menetapkan tinggi elemen dalam titik, yang merupakan tinggi kotak pembatas elemen saat elemen tidak memiliki rotasi.
`setLeft(left)`	`Image`	Menetapkan posisi horizontal elemen dalam 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.
`setRotation(angle)`	`Image`	Menetapkan sudut rotasi searah jarum jam elemen di sekitar pusatnya dalam derajat.
`setTitle(title)`	`Image`	Menetapkan judul teks alternatif elemen halaman.
`setTop(top)`	`Image`	Menetapkan posisi vertikal elemen dalam titik, yang diukur dari sudut kiri atas halaman saat elemen tidak memiliki rotasi.
`setTransform(transform)`	`Image`	Menetapkan transformasi elemen halaman dengan transformasi yang disediakan.
`setWidth(width)`	`Image`	Menetapkan lebar elemen dalam titik, yang merupakan lebar kotak pembatas elemen saat elemen tidak memiliki rotasi.

Dokumentasi mendetail

`alignOnPage(alignmentPosition)`

Meratakan elemen ke posisi perataan yang ditentukan di halaman.

Parameter

Nama	Jenis	Deskripsi
`alignmentPosition`	`AlignmentPosition`	Posisi untuk meratakan elemen halaman ini di halaman.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

`bringForward()`

Memajukan elemen halaman di halaman dengan satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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

Memindahkan elemen halaman ke bagian depan halaman.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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 di halaman yang sama pada posisi yang sama dengan elemen asli.

Pulang pergi

PageElement — Duplikat baru 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, hal ini menganggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

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

Parameter

Nama	Jenis	Deskripsi
`contentType`	`String`	Jenis 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, `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, atau `'image/png'` juga valid. Untuk dokumen Google Dokumen, `'text/markdown'` 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 di 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 secara efektif mengakses gambar sebagai pemohon asli. Akses ke gambar dapat 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 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 posisi.

Pulang pergi

Number — Tinggi bawaan 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 bawaan elemen dalam poin.

Transformasi elemen halaman bersifat relatif terhadap ukuran bawaannya. Gunakan ukuran bawaan bersama dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Tinggi bawaan 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 bawaan elemen dalam titik.

Transformasi elemen halaman bersifat relatif terhadap ukuran bawaannya. Gunakan ukuran bawaan bersama dengan transformasi elemen untuk menentukan tampilan visual akhir elemen.

Pulang pergi

Number — Lebar bawaan elemen halaman dalam titik, 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 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.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Pulang pergi

Link — Link atau null jika tidak ada 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 berada dalam grup.

Pulang pergi

Group — Grup yang berisi elemen halaman ini, 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 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 di halaman yang sama memiliki jenis yang sama, masing-masing gambar akan 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 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

`getSourceUrl()`

Mendapatkan URL sumber gambar, jika tersedia.

Saat gambar disisipkan dengan URL, 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 sudut 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, lakukan pra-penggabungan 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 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 posisi.

Pulang pergi

Number — Lebar bawaan elemen halaman dalam titik, 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)`

Menggabungkan transformasi yang disediakan ke transformasi elemen halaman yang ada.

newTransform = argument * existingTransform;

Misalnya, untuk memindahkan elemen halaman 36 poin ke kiri:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

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

Parameter

Nama	Jenis	Deskripsi
`transform`	`AffineTransform`	Transformasi untuk digabungkan terlebih dahulu ke transformasi elemen halaman ini.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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 ada elemen halaman, grup itu sendiri juga akan dihapus.

Jika placeholder PageElement dihapus di master atau tata letak, placeholder kosong yang mewarisi 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.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

Mengganti gambar ini dengan gambar yang dijelaskan oleh objek BlobSource.

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

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

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

Parameter

Nama	Jenis	Deskripsi
`blobSource`	`BlobSource`	Data gambar.

Pulang pergi

Image — Image ini 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, dengan opsi pemangkasan gambar agar sesuai.

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

Parameter

Nama	Jenis	Deskripsi
`blobSource`	`BlobSource`	Data gambar.
`crop`	`Boolean`	Jika `true`, memotong gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

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

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

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

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

Parameter

Nama	Jenis	Deskripsi
`imageUrl`	`String`	URL tempat gambar didownload.

Pulang pergi

Image — Image ini 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, dengan opsional memangkas gambar agar sesuai.

URL yang diberikan tidak boleh lebih besar dari 2 kB.

Parameter

Nama	Jenis	Deskripsi
`imageUrl`	`String`	URL tempat gambar didownload.
`crop`	`Boolean`	Jika `true`, memotong gambar agar sesuai dengan ukuran gambar yang ada. Jika tidak, gambar akan diskalakan dan dipusatkan.

Pulang pergi

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

Parameter

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

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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

Parameter

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

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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

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

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

Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat dengan 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:

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

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

const 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.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parameter

Nama	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 ke belakang pada halaman dengan satu elemen.

Elemen halaman tidak boleh berada dalam grup.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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 pembuatan rantai.

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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parameter

Nama	Jenis	Deskripsi
`description`	`String`	String yang akan ditetapkan sebagai 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, 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 posisi.

Parameter

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

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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

Nama	Jenis	Deskripsi
`left`	`Number`	Posisi horizontal baru yang akan ditetapkan, dalam titik.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parameter

Nama	Jenis	Deskripsi
`slideIndex`	`Integer`	Indeks berbasis nol ke slide.

Pulang pergi

Link — Link 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 diberikan, link ditetapkan oleh ID slide yang diberikan.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parameter

Nama	Jenis	Deskripsi
`slide`	`Slide`	`Slide` yang akan ditautkan.

Pulang pergi

Link — Link 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)`

Menetapkan Link ke Slide yang diberikan menggunakan posisi relatif slide.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parameter

Nama	Jenis	Deskripsi
`slidePosition`	`SlidePosition`	`SlidePosition` relatif.

Pulang pergi

Link — Link 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	String URL.

Pulang pergi

Link — Link 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 elemen 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 posisi.

Parameter

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

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parameter

Nama	Jenis	Deskripsi
`title`	`String`	String yang akan ditetapkan sebagai 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

Nama	Jenis	Deskripsi
`top`	`Number`	Posisi vertikal baru yang akan ditetapkan, dalam titik.

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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; hal ini tidak memengaruhi transformasi grup atau elemen halaman lain dalam grup.

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

Parameter

Nama	Jenis	Deskripsi
`transform`	`AffineTransform`	Transformasi yang ditetapkan untuk elemen halaman ini.

Pulang pergi

Image — Elemen ini, untuk pembuatan rantai.

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

Parameter

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

Pulang pergi

Image — Elemen halaman ini, untuk pembuatan rantai.

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