Class GmailAttachment

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
GmailПриложение

Вложение из Gmail. Это обычный большой двоичный объект, за исключением того, что у него есть дополнительный метод Blob getSize() , который работает быстрее, чем вызов getBytes() .length , и не учитывается в квоте чтения 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());
    }
  }
}

Методы

Метод Тип возврата Краткое описание
copyBlob() Blob Возвращает копию этого большого двоичного объекта.
getAs(contentType) Blob Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
getBytes() Byte[] Получает данные, хранящиеся в этом большом двоичном объекте.
getContentType() String Получает тип содержимого байтов в этом большом двоичном объекте.
getDataAsString() String Получает данные этого большого двоичного объекта в виде строки с кодировкой UTF-8.
getDataAsString(charset) String Получает данные этого большого двоичного объекта в виде строки с указанной кодировкой.
getHash() String Получает хэш содержимого SHA1 для этого вложения.
getName() String Получает имя этого большого двоичного объекта.
getSize() Integer Получает размер этого вложения.
isGoogleType() Boolean Возвращает, является ли этот большой двоичный объект файлом Google Workspace (Таблицы, Документы и т. д.).
setBytes(data) Blob Задает данные, хранящиеся в этом большом двоичном объекте.
setContentType(contentType) Blob Задает тип содержимого байтов в этом большом двоичном объекте.
setContentTypeFromExtension() Blob Задает тип содержимого байтов в этом большом двоичном объекте на основе расширения файла.
setDataFromString(string) Blob Задает данные этого большого двоичного объекта из строки с кодировкой UTF-8.
setDataFromString(string, charset) Blob Задает данные этого большого двоичного объекта из строки с указанной кодировкой.
setName(name) Blob Задает имя этого большого двоичного объекта.

Подробная документация

copyBlob()

Возвращает копию этого большого двоичного объекта.

Возвращаться

Blob — новая копия.


getAs(contentType)

Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента. Этот метод добавляет к имени файла соответствующее расширение, например, «myfile.pdf». Однако предполагается, что часть имени файла, которая следует за последней точкой (если она есть), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.12.25.2014» становится «Список покупок.12.25.pdf».

Чтобы просмотреть дневные квоты на конверсии, см. Квоты для сервисов Google . На вновь созданные домены Google Workspace могут временно распространяться более строгие квоты.

Параметры

Имя Тип Описание
contentType String Тип MIME для преобразования. Для большинства BLOB 'application/pdf' . Для изображений в формате BMP, GIF, JPEG или PNG допустимо любое из значений 'image/bmp' , 'image/gif' , 'image/jpeg' или 'image/png' .

Возвращаться

Blob — данные в виде большого двоичного объекта.


getBytes()

Получает данные, хранящиеся в этом большом двоичном объекте.

Возвращаться

Byte[] — сохраненные байты.


getContentType()

Получает тип содержимого байтов в этом большом двоичном объекте.

Возвращаться

String — тип содержимого этих данных, если он известен, или null .


getDataAsString()

Получает данные этого большого двоичного объекта в виде строки с кодировкой UTF-8.

Возвращаться

String — данные в виде строки.


getDataAsString(charset)

Получает данные этого большого двоичного объекта в виде строки с указанной кодировкой.

Параметры

Имя Тип Описание
charset String Набор символов, используемый для кодирования данных в этом большом двоичном объекте в виде строки.

Возвращаться

String — данные в виде строки.


getHash()

Получает хэш содержимого SHA1 для этого вложения. Этот метод не учитывается в квоте чтения Gmail.

Возвращаться

String — Хэш содержимого SHA1 в виде строки.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

  • https://mail.google.com/

getName()

Получает имя этого большого двоичного объекта.

Возвращаться

String — Имя этих данных, если известно, или null .


getSize()

Получает размер этого вложения. Этот метод работает быстрее, чем вызов getBytes() .length , и не учитывается в квоте чтения Gmail.

Возвращаться

Integer — размер вложения в байтах.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей или соответствующих областей из соответствующего REST API :

  • https://mail.google.com/

isGoogleType()

Возвращает, является ли этот большой двоичный объект файлом Google Workspace (Таблицы, Документы и т. д.).

Возвращаться

Booleantrue , если этот большой двоичный объект является файлом Google Workspace; false , если нет.


setBytes(data)

Задает данные, хранящиеся в этом большом двоичном объекте.

Параметры

Имя Тип Описание
data Byte[] Новые данные.

Возвращаться

Blob — этот блоб для цепочки.


setContentType(contentType)

Задает тип содержимого байтов в этом большом двоичном объекте.

Параметры

Имя Тип Описание
contentType String Новый тип содержимого.

Возвращаться

Blob — этот блоб для цепочки.


setContentTypeFromExtension()

Задает тип содержимого байтов в этом большом двоичном объекте на основе расширения файла. ContentType имеет значение null , если его нельзя угадать по расширению.

Возвращаться

Blob — этот блоб для цепочки.


setDataFromString(string)

Задает данные этого большого двоичного объекта из строки с кодировкой UTF-8.

Параметры

Имя Тип Описание
string String Строковые данные.

Возвращаться

Blob — этот блоб для цепочки.


setDataFromString(string, charset)

Задает данные этого большого двоичного объекта из строки с указанной кодировкой.

Параметры

Имя Тип Описание
string String Строковые данные.
charset String Набор символов, используемый при интерпретации строки как байтов.

Возвращаться

Blob — этот блоб для цепочки.


setName(name)

Задает имя этого большого двоичного объекта.

Параметры

Имя Тип Описание
name String Новое имя.

Возвращаться

Blob — этот блоб для цепочки.

Устаревшие методы