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». Однако предполагается, что часть имени файла, следующая за последней точкой (если таковая имеется), является существующим расширением, которое следует заменить. Следовательно, «Список покупок.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 (Таблицы, Документы и т. д.).

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

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 — этот объект для связывания.

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