หน้านี้ได้รับการแปลโดย Cloud Translation API

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`	รับประเภทเนื้อหาของไบต์ใน 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`	ตั้งค่าประเภทเนื้อหาของไบต์ในบล็อกนี้ตามนามสกุลไฟล์
`setDataFromString(string)`	`Blob`	ตั้งค่าข้อมูลของ Blob นี้จากสตริงที่มีการเข้ารหัส UTF-8
`setDataFromString(string, charset)`	`Blob`	ตั้งค่าข้อมูลของ Blob นี้จากสตริงที่มีการเข้ารหัสที่ระบุ
`setName(name)`	`Blob`	ตั้งชื่อ Blob นี้

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getAllBlobs()`	`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

`getDataAsString()`

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

รีเทิร์น

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

`getDataAsString(charset)`

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

พารามิเตอร์

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

รีเทิร์น

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

`getHash()`

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

รีเทิร์น

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

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

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

https://mail.google.com/

`getName()`

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

รีเทิร์น

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

`getSize()`

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

รีเทิร์น

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

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

https://mail.google.com/

`isGoogleType()`

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

รีเทิร์น

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

`setBytes(data)`

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