Class CellImage

CellImage

Merepresentasikan 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

PropertiJenisDeskripsi
valueTypeValueTypeJenis nilai gambar sel, yaitu ValueType.IMAGE.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getAltTextDescription()StringMenampilkan deskripsi teks alternatif untuk gambar ini.
getAltTextTitle()StringMenampilkan judul teks alternatif untuk gambar ini.
getContentUrl()StringMenampilkan URL yang dihosting Google ke gambar.
toBuilder()CellImageBuilderMembuat builder gambar sel berdasarkan properti gambar saat ini.

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 sebagai pemohon asli. Akses ke gambar mungkin hilang jika setelan berbagi spreadsheet berubah. URL yang ditampilkan akan berakhir masa berlakunya setelah beberapa saat. 

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 menetapkan URL sumber image 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