Начните с одного разрешённого тестового файла и его ID. Сравните прямое получение файла и поиск в каталоге под тем пользователем, от которого реально выполняется скрипт. Если получение работает, а список пуст, проблема может быть в области поиска; если не работает и получение, сначала разберите полномочия и поддержку общего диска.
Shared drive и чужой файл с доступом — разные случаи
Общий диск организации — отдельная модель Google Drive. Папка коллеги, которой поделились, не становится shared drive из-за нескольких участников. Зафиксируйте, где лежит объект, какой API его читает и кто исполняет ручной запуск, триггер или приложение. Доступ человека в соседней вкладке браузера не описывает контекст всех этих запусков.
| Наблюдение | Что отделить |
|---|---|
| Файл открывается человеком | Личность в браузере и при выполнении |
| По ID доступен, в списке отсутствует | Чтение объекта и область листинга |
| Список обрывается | Пагинацию и полноту обхода |
| Название найдено несколько раз | Имя файла и устойчивый ID |
| Отказ после переноса в shared drive | Модель ресурса и поддержка клиента |
Для общего диска проверьте поддерживаемый сервис
Документация DriveApp рекомендует advanced Drive service для доступа к файлам и папкам shared drives. В руководстве Drive API описаны supportsAllDrives и параметры включения таких объектов в список. Источники проверены 24 октября 2026 года. Эти параметры объявляют поддержку и область запроса, но не предоставляют пользователю новые права.
Условная диагностика, не готовый API-вызов:
исполнитель -> разрешённый тестовый файл по ID
прямое чтение -> статус и безопасная причина
листинг -> выбранный drive/corpus и условия
страницы -> обработаны до конца
результат -> сопоставлен по ID, а не первому имениСверьте версию используемого API и параметры конкретного метода: настройка поиска не обязательно относится к прямому получению. Не добавляйте одинаковый набор флагов во все вызовы без проверки документации. В Apps Script отдельно подтвердите подключение advanced service и необходимые согласованные разрешения проекта.
Для листинга задавайте подходящую область и обрабатывайте все страницы ответа. Если нужен определённый общий диск, лучше выразить это явно, чем искать одно имя во всём доступном пространстве. Пустой результат не должен автоматически создавать новую копию файла: так временная ошибка превращается в дубли документов.
Ошибка доступа и отсутствие объекта не всегда различимы удобным текстом для клиента. Не обходите отказ публикацией документа «для всех по ссылке». Проверьте допустимый доступ исполнителя у администратора и повторите минимальную операцию. В журналы не отправляйте токены, содержимое документов и полный список участников.
Приёмка сравнивает способы запуска
- Прочитать тестовый файл по ID вручную из скрипта.
- Повторить предусмотренным триггером или приложением.
- Найти тот же ID через листинг нужного диска.
- Проверить последнюю страницу списка.
- Проверить безопасный отказ для недоступного файла без создания дубля.
Перенос файлов и изменение прав проверяйте только на разрешённом тестовом наборе. Если рабочий процесс создаёт или изменяет объект, идемпотентность этой операции проектируется отдельно от чтения. Исправление листинга не доказывает права записи и не даёт основания переносить весь архив.
Для разбора подготовьте тип диска, способ запуска, метод и обезличенные параметры поиска. Результат — скрипт находит нужный объект по устойчивому ID во всех заявленных режимах и честно останавливается при недопустимом доступе, не расширяя публичность данных.