Trang này được dịch bởi Cloud Translation API.

Class GmailAttachment

Tệp đính kèm trong Gmail. Đây là một Blob thông thường, ngoại trừ việc có thêm một phương thức getSize() 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.

// 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	Loại 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 thành loại nội dung đã chỉ định.
`getBytes()`	`Byte[]`	Lấy dữ liệu được lưu trữ trong blob này.
`getContentType()`	`String`	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 Chuỗi có bộ mã hoá UTF-8.
`getDataAsString(charset)`	`String`	Lấy dữ liệu của blob này dưới dạng chuỗi có bộ 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`	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ề kết quả cho biết 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ó bộ mã hoá UTF-8.
`setDataFromString(string, charset)`	`Blob`	Đặt dữ liệu của blob này từ một chuỗi 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	Loại 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 tổng 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 thành loại nội dung đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm 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 đuôi tệp 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 bài viết Hạn mức cho 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 theo hạn mức nghiêm ngặt hơn.

Tham số

Tên	Loại	Mô tả
`contentType`	`String`	Loại MIME cần chuyển đổi sang. Đối với hầu hết các blob, `'application/pdf'` là tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hoặc `'image/png'` nào 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 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 – 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 Chuỗi có bộ mã hoá UTF-8.

Cầu thủ trả bóng

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

`getDataAsString(charset)`

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

Tham 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 chuỗi.

Cầu thủ trả bóng

String – Dữ liệu dưới dạng 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 tính vào hạn mức đọc của Gmail.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 – 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

Các tập lệnh sử dụng phương thức này yêu cầu 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ề kết quả cho biết 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à tệp Google Workspace; false nếu không.

`setBytes(data)`

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