Class CellImage

รูปภาพเซลล์

แสดงภาพเพื่อเพิ่มในเซลล์ หากต้องการเพิ่มรูปภาพลงในเซลล์ คุณต้องสร้างค่ารูปภาพใหม่สําหรับรูปภาพโดยใช้ SpreadsheetApp.newCellImage() และ CellImageBuilder จากนั้นจึงใช้ Range.setValue(value) หรือ Range.setValues(values) เพื่อเพิ่มค่ารูปภาพในเซลล์

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

พร็อพเพอร์ตี้ประเภทคำอธิบาย
valueTypeValueTypeตั้งค่าช่องเป็น ValueType.IMAGE แล้ว ซึ่งจะแสดงประเภทค่ารูปภาพ

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getAltTextDescription()Stringแสดงคําอธิบายข้อความสํารองสําหรับรูปภาพนี้
getAltTextTitle()Stringแสดงผลชื่อข้อความแสดงแทนสําหรับรูปภาพนี้
getContentUrl()Stringแสดงผล URL ที่โฮสต์โดย Google ไปยังรูปภาพ
getUrl()Stringรับ URL แหล่งที่มาของรูปภาพ แสดงผล null หาก URL ไม่พร้อมใช้งาน
toBuilder()CellImageBuilderสร้างเครื่องมือสร้างที่เปลี่ยนรูปภาพเป็นประเภทค่ารูปภาพเพื่อให้คุณวางลงในเซลล์ได้

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

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 ที่แสดงจะหมดอายุ ในไม่ช้า

ไปกลับ

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

getUrl()

รับ URL แหล่งที่มาของรูปภาพ แสดงผล null หาก URL ไม่พร้อมใช้งาน หาก URL แทรกรูปภาพโดยใช้ API เมธอดนี้จะแสดงผล URL ที่ระบุระหว่างการแทรกรูปภาพ

ไปกลับ

String — URL ของรูปภาพ (หากมี) แสดงผล null หากรูปภาพไม่พร้อมใช้งานหรือไม่มี URL แหล่งที่มา

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

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

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

toBuilder()

สร้างเครื่องมือสร้างที่เปลี่ยนรูปภาพเป็นประเภทค่ารูปภาพเพื่อให้คุณวางลงในเซลล์ได้ ก่อนที่รูปภาพจะถูกวางในเซลล์ จะต้องสร้างเป็นประเภทค่าของรูปภาพ จากนั้นจึงเพิ่มลงในเซลล์โดยใช้ Range.setValue(value) หรือ Range.setValues(values)

ไปกลับ

CellImageBuilder — เครื่องมือสร้างประเภทค่ารูปภาพโดยอิงตามคุณสมบัติของรูปภาพนั้นๆ