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

Class GmailAttachment

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

Методы

Метод	Тип возврата	Краткое описание
`copy Blob()`	`Blob`	Возвращает копию этого большого двоичного объекта.
`get As(contentType)`	`Blob`	Верните данные внутри этого объекта в виде большого двоичного объекта, преобразованного в указанный тип контента.
`get Bytes()`	`Byte[]`	Получает данные, хранящиеся в этом большом двоичном объекте.
`get Content Type()`	`String`	Получает тип содержимого байтов в этом большом двоичном объекте.
`get Data As String()`	`String`	Получает данные этого большого двоичного объекта в виде строки с кодировкой UTF-8.
`get Data As String(charset)`	`String`	Получает данные этого большого двоичного объекта в виде строки с указанной кодировкой.
`get Hash()`	`String`	Получает хэш содержимого SHA1 для этого вложения.
`get Name()`	`String`	Получает имя этого большого двоичного объекта.
`get Size()`	`Integer`	Получает размер этого вложения.
`is Google Type()`	`Boolean`	Возвращает, является ли этот большой двоичный объект файлом Google Workspace (Таблицы, Документы и т. д.).
`set Bytes(data)`	`Blob`	Устанавливает данные, хранящиеся в этом большом двоичном объекте.
`set Content Type(contentType)`	`Blob`	Устанавливает тип содержимого байтов в этом большом двоичном объекте.
`set Content Type From Extension()`	`Blob`	Устанавливает тип содержимого байтов в этом большом двоичном объекте на основе расширения файла.
`set Data From String(string)`	`Blob`	Устанавливает данные этого большого двоичного объекта из строки с кодировкой UTF-8.
`set Data From String(string, charset)`	`Blob`	Устанавливает данные этого большого двоичного объекта из строки с указанной кодировкой.
`set Name(name)`	`Blob`	Устанавливает имя этого большого двоичного объекта.

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

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

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

`copy Blob()`

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

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

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

`get As(contentType)`

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

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

Параметры

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

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

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

`get Bytes()`

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

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

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

`get Content Type()`

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

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

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

`get Data As String()`

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

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

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

`get Data As String(charset)`

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

Параметры

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

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

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

`get Hash()`

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

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

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

Авторизация

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

https://mail.google.com/

`get Name()`

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

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

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

`get Size()`

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

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

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

Авторизация

https://mail.google.com/

`is Google Type()`

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

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

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

`set Bytes(data)`

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