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

Class GmailAttachment

Một tệp đính kèm từ Gmail. Đây là một Blob thông thường, ngoại trừ việc có một phương thức getSize() bổ sung nhanh hơn phương thức gọi getBytes().length và không được tính vào hạn mức đọc của Gmail.

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var 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ề 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 được chỉ định.
`getBytes()`	`Byte[]`	Lấy dữ liệu 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 một chuỗi 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`	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ề việc blob này có phải là tệp Google Workspace hay không (Trang tính, Tài liệu, v.v.).
`setBytes(data)`	`Blob`	Thiết lập dữ liệu 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`	Thiết lập 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ó kiểu 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ả blob có trong blob này (có thể là tổng hợp).

Tài liệu chi tiết

`copyBlob()`

Trả về 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 được chỉ định. Chiến dịch này sẽ thêm đuôi tệp thích hợp vào tên tệp (ví dụ: "myfile.pdf"). Tuy nhiên, việc này giả định rằng phần tên tệp tiếp sau dấu chấm cuối cùng (nếu có) là phần tên tệp hiện có tiện ích mở rộng cần được thay thế. Do đó, "ShoppingList.12.25.2014" 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 Google Dịch vụ. Các miền Google Workspace mới tạo có thể tạm thời bị áp dụng quy định nghiêm ngặt hơn hạn mức.

Tham 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, bất kỳ hình ảnh nào có định dạng `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hoặc `'image/png'` cũng hợp lệ. Đối với tài liệu trên 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 lưu trữ trong blob này.

Cầu thủ trả bóng

Byte[] — Các 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 đã biết 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ạng chuỗi.

`getDataAsString(charset)`

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

Tham số

Tên	Loại	Mô tả
`charset`	`String`	Bộ ký tự cần sử dụng khi 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ạ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 được tính vào Gmail hạn mức đọc.

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 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 dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

https://mail.google.com/

`isGoogleType()`

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

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)`

Thiết lập dữ liệu lưu trữ trong blob này.