Class GmailAttachment

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

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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\|null`	รับประเภทเนื้อหาของไบต์ใน Blob นี้
`getDataAsString()`	`String`	รับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัส UTF-8
`getDataAsString(charset)`	`String`	รับข้อมูลของ Blob นี้เป็นสตริงที่มีการเข้ารหัสที่ระบุ
`getHash()`	`String`	รับแฮชเนื้อหา SHA1 สำหรับไฟล์แนบนี้
`getName()`	`String\|null`	รับชื่อของ 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 นี้

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getAllBlobs()`	`Blob[]`	รับ Blob ทั้งหมดที่อยู่ใน Blob นี้ (อาจเป็น Blob แบบคอมโพสิต)

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

`copyBlob()`

ส่งกลับสำเนาของ Blob นี้

รีเทิร์น

Blob — ข้อความใหม่

`getAs(contentType)`

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

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

พารามิเตอร์

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

รีเทิร์น

Blob — ข้อมูลเป็น Blob

`getBytes()`

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

รีเทิร์น

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

`getContentType()`

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

รีเทิร์น

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

`getDataAsString()`

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

รีเทิร์น

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

`getDataAsString(charset)`

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

พารามิเตอร์

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

รีเทิร์น

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

`getHash()`

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

รีเทิร์น

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

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

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

https://mail.google.com/

`getName()`

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

รีเทิร์น

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

`getSize()`

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

รีเทิร์น

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

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

https://mail.google.com/

`isGoogleType()`

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

รีเทิร์น

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

`setBytes(data)`

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