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 นี้