Class GmailAttachment

Tệp đính kèm trong Gmail. Đây là một Blob thông thường, ngoại trừ việc nó có thêm phương thức getSize() nhanh hơn việc gọi getBytes().length và không tính vào hạn mức đọc của 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(),
      );
    }
  }
}

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`copyBlob()`	`Blob`	Trả về một bản sao của blob này.
`getAs(contentType)`	`Blob`	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định.
`getBytes()`	`Byte[]`	Lấy dữ liệu được lưu trữ trong blob này.
`getContentType()`	`String\|null`	Lấy loại nội dung của các byte trong blob này.
`getDataAsString()`	`String`	Lấy dữ liệu của blob này dưới dạng một Chuỗi có phương thức mã hoá UTF-8.
`getDataAsString(charset)`	`String`	Lấy dữ liệu của blob này dưới dạng một chuỗi có phương thức mã hoá được chỉ định.
`getHash()`	`String`	Lấy hàm băm nội dung SHA1 cho tệp đính kèm này.
`getName()`	`String\|null`	Lấy tên của blob này.
`getSize()`	`Integer`	Lấy kích thước của tệp đính kèm này.
`isGoogleType()`	`Boolean`	Trả về liệu blob này có phải là tệp Google Workspace (Trang tính, Tài liệu, v.v.) hay không.
`setBytes(data)`	`Blob`	Đặt dữ liệu được lưu trữ trong blob này.
`setContentType(contentType)`	`Blob`	Đặt loại nội dung của các byte trong blob này.
`setContentTypeFromExtension()`	`Blob`	Đặt loại nội dung của các byte trong blob này dựa trên đuôi tệp.
`setDataFromString(string)`	`Blob`	Đặt dữ liệu của blob này từ một chuỗi có phương thức mã hoá UTF-8.
`setDataFromString(string, charset)`	`Blob`	Đặt dữ liệu của blob này từ một chuỗi có phương thức mã hoá được chỉ định.
`setName(name)`	`Blob`	Đặt tên cho blob này.

Các phương thức ngừng hoạt động

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`getAllBlobs()`	`Blob[]`	Lấy tất cả các blob có trong blob này (có thể là blob kết hợp).

Tài liệu chi tiết

`copyBlob()`

Trả về một bản sao của blob này.

Cầu thủ trả bóng

Blob – Bản sao mới.

`getAs(contentType)`

Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định. Phương thức này sẽ thêm đuôi thích hợp vào tên tệp, chẳng hạn như "myfile.pdf". Tuy nhiên, phương thức này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một tiện ích hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ trở thành "ShoppingList.12.25.pdf".

Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem Hạn mức cho các dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân thủ hạn mức nghiêm ngặt hơn.

Thông số

Tên	Loại	Mô tả
`contentType`	`String`	Loại MIME cần chuyển đổi. Đối với hầu hết các blob, `'application/pdf'` là lựa chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, mọi định dạng `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hoặc `'image/png'` cũng đều hợp lệ. Đối với tài liệu Google Tài liệu, `'text/markdown'` cũng hợp lệ.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng một blob.

`getBytes()`

Lấy dữ liệu được lưu trữ trong blob này.

Cầu thủ trả bóng

Byte[] – Số byte được lưu trữ.

`getContentType()`

Lấy loại nội dung của các byte trong blob này.

Cầu thủ trả bóng

String|null – Loại nội dung của dữ liệu này (nếu có) hoặc null.

`getDataAsString()`

Lấy dữ liệu của blob này dưới dạng một Chuỗi có phương thức mã hoá UTF-8.

Cầu thủ trả bóng

String – Dữ liệu dưới dạng một chuỗi.

`getDataAsString(charset)`

Lấy dữ liệu của blob này dưới dạng một chuỗi có phương thức mã hoá được chỉ định.

Thông số

Tên	Loại	Mô tả
`charset`	`String`	Bộ ký tự dùng để mã hoá dữ liệu trong blob này dưới dạng một chuỗi.

Cầu thủ trả bóng

String – Dữ liệu dưới dạng một chuỗi.

`getHash()`

Lấy hàm băm nội dung SHA1 cho tệp đính kèm này. Phương thức này không được tính vào hạn mức đọc Gmail.

Cầu thủ trả bóng

String – Hàm băm nội dung SHA1, dưới dạng chuỗi.

Ủy quyền

Những tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

https://mail.google.com/

`getName()`

Lấy tên của blob này.

Cầu thủ trả bóng

String|null – Tên của dữ liệu này (nếu có) hoặc null.

`getSize()`

Lấy kích thước của tệp đính kèm này. Phương thức này nhanh hơn so với việc gọi getBytes().length và không tính vào hạn mức đọc của Gmail.

Cầu thủ trả bóng

Integer – Kích thước của tệp đính kèm, tính bằng byte.

Ủy quyền

Những tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

https://mail.google.com/

`isGoogleType()`

Trả về liệu blob này có phải là tệp Google Workspace (Trang tính, Tài liệu, v.v.) hay không.

Cầu thủ trả bóng

Boolean – true nếu blob này là một tệp Google Workspace; false nếu không.

`setBytes(data)`

Đặt dữ liệu được lưu trữ trong blob này.