Class CellImageBuilder

CellImageBuilder

ผู้รับสร้างบ้านสำหรับ CellImage เครื่องมือสร้างนี้จะสร้างค่ารูปภาพที่จำเป็นต่อการเพิ่ม รูปภาพลงในเซลล์

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
valueType	ValueType	ประเภทค่าของรูปภาพเซลล์ ซึ่งคือ ValueType.IMAGE

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
build()	CellImage	สร้างประเภทค่ารูปภาพที่จำเป็นในการเพิ่มรูปภาพลงในเซลล์
getAltTextDescription()	String	แสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้
getAltTextTitle()	String	แสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้
getContentUrl()	String	แสดง URL ของรูปภาพที่ Google โฮสต์
setAltTextDescription(description)	CellImage	ตั้งค่าคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้
setAltTextTitle(title)	CellImage	ตั้งชื่อข้อความแสดงแทนสำหรับรูปภาพนี้
setSourceUrl(url)	CellImageBuilder	ตั้งค่า URL แหล่งที่มาของรูปภาพ
toBuilder()	CellImageBuilder	สร้างเครื่องมือสร้างรูปภาพเซลล์ตามพร็อพเพอร์ตี้รูปภาพปัจจุบัน

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getUrl()	String	รับ URL แหล่งที่มาของรูปภาพ

เอกสารโดยละเอียด

build()

สร้างประเภทค่ารูปภาพที่จำเป็นในการเพิ่มรูปภาพลงในเซลล์ ค่ารูปภาพสร้างขึ้นจาก พร็อพเพอร์ตี้รูปภาพที่เพิ่มลงในเครื่องมือสร้าง เช่น URL แหล่งที่มา

รีเทิร์น

CellImage — การแสดงรูปภาพที่จะเพิ่มลงในเซลล์

---

getAltTextDescription()

แสดงคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้

รีเทิร์น

String — คำอธิบายข้อความแสดงแทน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getAltTextTitle()

แสดงชื่อข้อความแสดงแทนสำหรับรูปภาพนี้

รีเทิร์น

String - ชื่อข้อความแสดงแทน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getContentUrl()

แสดง URL ของรูปภาพที่ Google โฮสต์ URL นี้จะติดแท็กบัญชีของผู้ขอ ดังนั้นทุกคนที่มี URL จะเข้าถึงรูปภาพได้เหมือนกับผู้ขอเดิม คุณอาจเสียสิทธิ์เข้าถึงรูปภาพหากการตั้งค่าการแชร์ของสเปรดชีตมีการเปลี่ยนแปลง URL ที่แสดงจะหมดอายุ หลังจากผ่านไปในระยะเวลาสั้นๆ

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

รีเทิร์น

String — URL ของรูปภาพที่ Google โฮสต์

---

setAltTextDescription(description)

ตั้งค่าคำอธิบายข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
description	String	คำอธิบายข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

CellImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setAltTextTitle(title)

ตั้งชื่อข้อความแสดงแทนสำหรับรูปภาพนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
title	String	ชื่อข้อความแสดงแทนใหม่สำหรับรูปภาพ

รีเทิร์น

CellImage — รูปภาพนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setSourceUrl(url)

ตั้งค่า URL แหล่งที่มาของรูปภาพ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
url	String	URL ของรูปภาพ

รีเทิร์น

CellImageBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

---

toBuilder()

สร้างเครื่องมือสร้างรูปภาพเซลล์ตามพร็อพเพอร์ตี้รูปภาพปัจจุบัน ใช้ setSourceUrl(url) เพื่อตั้งค่า URL แหล่งที่มาของรูปภาพใหม่ จากนั้นคุณจะเพิ่มลงใน เซลล์ได้โดยใช้ Range.setValue(value) หรือ 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);
}

รีเทิร์น

CellImageBuilder - เครื่องมือสร้างที่สร้างประเภทค่ารูปภาพตามพร็อพเพอร์ตี้รูปภาพที่ระบุ

วิธีการที่เลิกใช้งานแล้ว

getUrl()

เลิกใช้งานแล้ว สำหรับรูปภาพที่เพิ่งแทรกส่วนใหญ่ URL แหล่งที่มาจะไม่พร้อมใช้งาน

รับ URL แหล่งที่มาของรูปภาพ แสดงผลสตริงว่างหาก URL ไม่พร้อมใช้งาน สำหรับรูปภาพที่เพิ่งแทรกใหม่ส่วนใหญ่ URL แหล่งที่มาจะไม่พร้อมใช้งานไม่ว่าจะแทรกรูปภาพอย่างไรก็ตาม

รีเทิร์น

String — URL แหล่งที่มาของรูปภาพ (หากมี) หรือแสดงผลสตริงว่าง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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