Эта страница переведена с помощью Cloud Translation API.

Class GmailAttachment

Вложение из 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`	Устанавливает имя этого большого двоичного объекта.

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

Метод	Тип возврата	Краткое описание
`getAllBlobs()`	`Blob[]`	Получает все большие двоичные объекты, содержащиеся в этом (возможно составном) большом двоичном объекте.

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

`copyBlob()`

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

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

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

`getAs(contentType)`

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

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

Параметры

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

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

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 (Таблицы, Документы и т. д.).

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

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

`setBytes(data)`

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