Class GmailAttachment

Tệp đính kèm của Gmail

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ứcLoại dữ liệu trả vềMô tả ngắn
copyBlob()BlobTrả về một bản sao của blob này.
getAs(contentType)BlobTrả 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()StringLấy loại nội dung của các byte trong blob này.
getDataAsString()StringLấy dữ liệu của blob này dưới dạng Chuỗi có bộ mã hoá UTF-8.
getDataAsString(charset)StringLấy dữ liệu của blob này dưới dạng chuỗi có mã hoá được chỉ định.
getHash()StringLấy hàm băm nội dung SHA1 cho tệp đính kèm này.
getName()StringLấy tên của blob này.
getSize()IntegerLấy kích thước của tệp đính kèm này.
isGoogleType()BooleanTrả 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.

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ênLoạiMô tả
contentTypeStringLoạ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ó mã hoá được chỉ định.

Tham số

TênLoạiMô tả
charsetStringBộ 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 đượ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 – 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 đượ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ề 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.

Tham số

TênLoạiMô tả
dataByte[]Dữ liệu mới.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

setContentType(contentType)

Đặt loại nội dung của các byte trong blob này.

Tham số

TênLoạiMô tả
contentTypeStringcontentType mới.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

setContentTypeFromExtension()

Đặt loại nội dung của các byte trong blob này dựa trên đuôi tệp. contentType là null nếu không thể đoán được từ phần mở rộng.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

setDataFromString(string)

Đặt dữ liệu của blob này từ một chuỗi có bộ mã hoá UTF-8.

Tham số

TênLoạiMô tả
stringStringDữ liệu chuỗi.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

setDataFromString(string, charset)

Đặt dữ liệu của blob này từ một chuỗi có mã hoá được chỉ định.

Tham số

TênLoạiMô tả
stringStringDữ liệu chuỗi.
charsetStringBộ ký tự dùng để diễn giải chuỗi dưới dạng byte.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

setName(name)

Đặt tên cho blob này.

Tham số

TênLoạiMô tả
nameStringTên mới.

Cầu thủ trả bóng

Blob – Blob này, để tạo chuỗi.

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