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 ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า

พารามิเตอร์

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

รีเทิร์น

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


getBytes()

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

รีเทิร์น

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


getContentType()

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

รีเทิร์น

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


getDataAsString()

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

รีเทิร์น

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


getDataAsString(charset)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 นี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dataByte[]ข้อมูลใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่


setContentType(contentType)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentTypeStringcontentType ใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่


setContentTypeFromExtension()

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

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่


setDataFromString(string)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
stringStringข้อมูลสตริง

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่


setDataFromString(string, charset)

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

พารามิเตอร์

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

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่


setName(name)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อใหม่

รีเทิร์น

Blob — BLOB นี้สำหรับการทำสายโซ่

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