Class CellImage

CellImage

Menampilkan nilai gambar dalam sel. Untuk menambahkan gambar ke sel, Anda harus membuat nilai gambar baru untuk gambar menggunakan SpreadsheetApp.newCellImage() dan CellImageBuilder. Kemudian, Anda dapat menggunakan Range.setValue(value) atau Range.setValues(values) untuk menambahkan nilai gambar ke sel.

Properti

Properti	Jenis	Deskripsi
valueType	ValueType	Jenis nilai gambar sel, yaitu ValueType.IMAGE.

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getAltTextDescription()	String	Menampilkan deskripsi teks alternatif untuk gambar ini.
getAltTextTitle()	String	Menampilkan judul teks alternatif untuk gambar ini.
getContentUrl()	String	Menampilkan URL yang dihosting Google ke gambar.
toBuilder()	CellImageBuilder	Membuat builder gambar sel berdasarkan properti gambar saat ini.

Metode yang tidak digunakan lagi

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getUrl()	String	Mendapatkan URL sumber gambar.

Dokumentasi mendetail

getAltTextDescription()

Menampilkan deskripsi teks alternatif untuk gambar ini.

Pulang pergi

String — Deskripsi teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAltTextTitle()

Menampilkan judul teks alternatif untuk gambar ini.

Pulang pergi

String — Judul teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getContentUrl()

Menampilkan URL yang dihosting Google 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 spreadsheet berubah. URL yang ditampilkan akan berakhir setelah jangka waktu singkat.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Pulang pergi

String — URL gambar yang dihosting Google.

---

toBuilder()

Membuat builder gambar sel berdasarkan properti gambar saat ini. Gunakan CellImageBuilder.setSourceUrl(url) untuk menyetel URL sumber gambar baru. Kemudian, Anda dapat menambahkannya ke sel menggunakan Range.setValue(value) atau Range.setValues(values).

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

Pulang pergi

CellImageBuilder — Builder yang membuat jenis nilai gambar berdasarkan properti gambar yang diberikan.

Metode yang tidak digunakan lagi

getUrl()

Tidak digunakan lagi. Untuk sebagian besar gambar yang baru disisipkan, URL sumber tidak tersedia.

Mendapatkan URL sumber gambar. Menampilkan string kosong jika URL tidak tersedia. Untuk sebagian besar gambar yang baru disisipkan, URL sumber tidak tersedia, terlepas dari cara gambar disisipkan.

Pulang pergi

String — URL sumber gambar jika tersedia; menampilkan string kosong jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets