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

Class GmailAttachment

Tệp đính kèm từ Gmail. Đây là Blob thông thường, ngoại trừ việc có thêm một phương thức getSize() khác nhanh hơn lệnh 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.
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	Kiểu 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 thành loại nội dung được 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`	Nhận dữ liệu của blob này dưới dạng Chuỗi bằng 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 chuỗi với 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`	Xem 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à một tệp Google Workspace (Trang tính, Tài liệu, v.v.) hay không.
`setBytes(data)`	`Blob`	Thiết lập dữ liệu được lưu trữ trong blob này.
`setContentType(contentType)`	`Blob`	Thiết lập 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 bằng bộ mã hoá UTF-8.
`setDataFromString(string, charset)`	`Blob`	Thiết lập 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 của 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ả những giọt nước có trong tệp blob (có thể là tổng hợp) này.

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 thành loại nội dung được chỉ định. Phương thức này sẽ thêm phần mở rộng thích hợp vào tên tệp – ví dụ: "myfile.pdf". Tuy nhiên, giả định rằng phần tên tệp đứng sau dấu chấm gần nhất (nếu có) là một đuôi tệp hiện có 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 các Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời tuân theo định mức nghiêm ngặt hơn.

Các tham số

Tên	Loại	Nội dung 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à tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh có định dạng BMP, GIF, JPEG hoặc PNG, mọi giá trị `'image/bmp'`, `'image/gif'`, `'image/jpeg'` hay `'image/png'` 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[] – Các byte đã 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()`

Nhận dữ liệu của blob này dưới dạng Chuỗi bằng phương thức 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 với mã hoá được chỉ định.

Các tham số

Tên	Loại	Nội dung 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 được 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ưới dạng chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được 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 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()`

Xem kích thước của tệp đính kèm này. Phương thức này nhanh hơn 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 cần được 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 từ API REST có liên quan:

https://mail.google.com/

`isGoogleType()`

Trả về việc blob này có phải là một 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 phải.

`setBytes(data)`

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