Если письмо приходит без файла, сначала убедитесь, что выполняется именно перегрузка `MailApp.sendEmail` с объектом options и полем `attachments`. Вложения передаются массивом BlobSource. Сам `fileId`, URL Drive или объект метаданных письма вложением не становятся.
Разделите проверку на три операции: скрипт получает File, превращает его в Blob и только затем отправляет. Так сразу видно, сломался доступ к Drive, экспорт Google-документа или сборка письма.
Минимальный тест на одном файле
function sendTestAttachment() {
const file = DriveApp.getFileById('TEST_FILE_ID');
const blob = file.getBlob().setName(file.getName());
console.log({
name: blob.getName(),
type: blob.getContentType(),
bytes: blob.getBytes().length,
});
MailApp.sendEmail('recipient@example.com', 'Тест',
'Файл приложен к письму.', { attachments: [blob] });
}Используйте отдельный тестовый файл без персональных данных. Если `getFileById` падает, вызов MailApp ещё не выполнялся. Если Blob имеет ожидаемое имя, тип и ненулевой размер, но письмо без вложения, проверьте, что production-код не вызывает другую сигнатуру sendEmail и не перезаписывает options.
Кто запускает скрипт, тот и читает Drive
Ручной запуск редактором и time-driven trigger могут выполняться в разном контексте. Файл доступен владельцу сценария, но не аккаунту, от имени которого работает конкретное развёртывание или триггер. Запишите активного пользователя там, где это допустимо, и проверьте доступ к точному fileId под этим контекстом.
| Симптом | Граница сбоя | Что сравнить |
|---|---|---|
| File not found или access denied | Drive | fileId, владельца, shared drive и пользователя выполнения |
| Blob пустой или неожиданного типа | Преобразование | getBlob/getAs, MIME type и размер |
| Письмо не отправлено | MailApp или авторизация | Execution log, scope send_mail и исключение |
| Письмо есть, вложения нет | Параметры вызова | options.attachments и фактически исполненную ветку кода |
Google Docs и обычный PDF требуют разных решений
Загруженный PDF уже содержит готовые байты, поэтому обычно подходит `getBlob()`. Нативный Google Docs, Sheets или Slides чаще нужно экспортировать через `getAs(MimeType.PDF)` или другой поддерживаемый формат. Имя итогового Blob задайте явно, иначе получатель увидит техническое или неожиданное расширение.
Не выполняйте дорогую конвертацию внутри цикла получателей. Подготовьте Blob один раз, затем используйте для согласованной партии писем, если содержимое одинаковое. Для персонализированных файлов связывайте генерацию и адресата уникальным идентификатором, чтобы не приложить чужой документ.
Большие вложения и пакетная отправка
Перед отправкой измерьте суммарный размер blobs. Ограничения почты и время выполнения могут меняться, поэтому не зашивайте случайное число без сверки с актуальными квотами вашего Workspace. Для больших материалов безопаснее отправить контролируемую ссылку с правильными правами, чем пытаться прикрепить файл любой ценой.
- Не публикуйте Drive-файл по ссылке автоматически ради обхода ошибки доступа.
- Не записывайте содержимое Blob и адреса получателей в общий лог.
- Обрабатывайте каждого адресата отдельно, если вложение персональное.
- Сохраняйте message context и fileId, но маскируйте их в отчёте поддержки.
Контрольный запуск перед включением триггера
Запустите функцию вручную и триггером с одним тестовым адресатом. В обоих случаях сравните execution principal, имя Blob, MIME type, размер и результат MailApp. Затем намеренно уберите доступ к копии файла: скрипт должен остановиться с понятной ошибкой до отправки письма, а не прислать пустое сообщение.
Для разбора достаточно минимальной функции, типа файла, сведений о shared drive, контекста запуска и обезличенного execution log. Содержимое вложения, OAuth-токены и реальные адреса получателей не нужны.