Class GmailAttachment

GmailAttachment

ไฟล์แนบจาก Gmail นี่คือ Blob ทั่วไป เว้นแต่มีเมธอด getSize() เพิ่มเติมซึ่งเร็วกว่าการเรียกใช้ getBytes().length และไม่นับรวมในโควต้าการอ่านของ Gmail

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var k = 0; k < attachments.length; k++) {
      Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
                 msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
    }
  }
}

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
copyBlob()Blobแสดงสำเนาของ Blob นี้
getAs(contentType)Blobแสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ
getBytes()Byte[]รับข้อมูลที่จัดเก็บไว้ใน Blob นี้
getContentType()Stringรับประเภทเนื้อหาของไบต์ใน Blob นี้
getDataAsString()Stringรับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัส UTF-8
getDataAsString(charset)Stringรับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัสที่ระบุ
getHash()Stringรับแฮชเนื้อหา SHA1 สำหรับไฟล์แนบนี้
getName()Stringรับชื่อของ Blob นี้
getSize()Integerรับขนาดของไฟล์แนบนี้
isGoogleType()Booleanแสดงผลว่า Blob นี้เป็นไฟล์ Google Workspace (ชีต, เอกสาร ฯลฯ) หรือไม่
setBytes(data)Blobตั้งค่าข้อมูลที่จัดเก็บไว้ใน Blob นี้
setContentType(contentType)Blobตั้งค่าประเภทเนื้อหาของไบต์ใน Blob นี้
setContentTypeFromExtension()Blobตั้งค่าประเภทเนื้อหาของไบต์ใน Blob นี้โดยขึ้นอยู่กับนามสกุลไฟล์
setDataFromString(string)Blobตั้งค่าข้อมูลของ Blob นี้จากสตริงที่มีการเข้ารหัส UTF-8
setDataFromString(string, charset)Blobตั้งค่าข้อมูลของ BLOB นี้จากสตริงด้วยการเข้ารหัสที่ระบุ
setName(name)Blobตั้งชื่อของ Blob นี้

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

copyBlob()

แสดงสำเนาของ Blob นี้

รีเทิร์น

Blob — สำเนาใหม่


getAs(contentType)

แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ วิธีนี้จะเพิ่มส่วนขยายที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม สมมติว่าส่วนของชื่อไฟล์ที่อยู่หลังเครื่องหมายจุดสุดท้าย (ถ้ามี) เป็นส่วนขยายที่มีอยู่แล้วซึ่งควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" จะกลายเป็น "ShoppingList.12.25.pdf"

ดูโควต้ารายวันสำหรับ Conversion ได้ที่โควต้าสำหรับบริการของ Google โดเมน Google Workspace ที่สร้างใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดเป็นการชั่วคราว

พารามิเตอร์

ชื่อTypeคำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลงเป็น สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณสามารถใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB


getBytes()

รับข้อมูลที่จัดเก็บไว้ใน Blob นี้

รีเทิร์น

Byte[] — ไบต์ที่จัดเก็บไว้


getContentType()

รับประเภทเนื้อหาของไบต์ใน Blob นี้

รีเทิร์น

String — ประเภทเนื้อหาของข้อมูลนี้ (หากทราบ) หรือ null


getDataAsString()

รับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัส UTF-8

รีเทิร์น

String — ข้อมูลเป็นสตริง


getDataAsString(charset)

รับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัสที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
charsetStringชุดอักขระที่จะใช้ในการเข้ารหัสข้อมูลใน Blob นี้เป็นสตริง

รีเทิร์น

String — ข้อมูลเป็นสตริง


getHash()

รับแฮชเนื้อหา SHA1 สำหรับไฟล์แนบนี้ วิธีนี้จะไม่นับรวมในโควต้าการอ่านของ Gmail

รีเทิร์น

String — แฮชเนื้อหา SHA1 เป็นสตริง

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

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

  • https://mail.google.com/

getName()

รับชื่อของ Blob นี้

รีเทิร์น

String — ชื่อของข้อมูลนี้ (หากทราบ) หรือ null


getSize()

รับขนาดของไฟล์แนบนี้ วิธีนี้เร็วกว่าการเรียกใช้ getBytes().length และไม่นับรวมในโควต้าการอ่านของ Gmail

รีเทิร์น

Integer — ขนาดของไฟล์แนบในหน่วยไบต์

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

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

  • https://mail.google.com/

isGoogleType()

แสดงผลว่า Blob นี้เป็นไฟล์ Google Workspace (ชีต, เอกสาร ฯลฯ) หรือไม่

รีเทิร์น

Booleantrue หาก Blob นี้เป็นไฟล์ Google Workspace falseหากไม่ใช่


setBytes(data)

ตั้งค่าข้อมูลที่จัดเก็บไว้ใน Blob นี้

พารามิเตอร์

ชื่อTypeคำอธิบาย
dataByte[]ข้อมูลใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน


setContentType(contentType)

ตั้งค่าประเภทเนื้อหาของไบต์ใน Blob นี้

พารามิเตอร์

ชื่อTypeคำอธิบาย
contentTypeStringcontentType ใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน


setContentTypeFromExtension()

ตั้งค่าประเภทเนื้อหาของไบต์ใน Blob นี้โดยขึ้นอยู่กับนามสกุลไฟล์ contentType จะเป็น null หากเดาจากส่วนขยายไม่ได้

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน


setDataFromString(string)

ตั้งค่าข้อมูลของ Blob นี้จากสตริงที่มีการเข้ารหัส UTF-8

พารามิเตอร์

ชื่อTypeคำอธิบาย
stringStringข้อมูลสตริง

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน


setDataFromString(string, charset)

ตั้งค่าข้อมูลของ BLOB นี้จากสตริงด้วยการเข้ารหัสที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
stringStringข้อมูลสตริง
charsetStringชุดอักขระที่จะใช้ตีความสตริงเป็นไบต์

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน


setName(name)

ตั้งชื่อของ Blob นี้

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำเชน

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