Google открыл комментарии через API: как передавать ошибки каталога
API Docs, Sheets и Slides получили работу с комментариями. Как проектировать проверку каталога с адресными замечаниями и контролем повторных запусков.
Содержание статьи
Google добавил программную работу с комментариями и предложениями в Docs, Sheets и Slides. Для команды магазина это открывает путь к проверке товарных материалов, которая отмечает проблему в нужном месте вместо молчаливого изменения данных. Интеграцию потребуется отдельно разработать и проверить: анонс не является готовым контролёром каталога.
Что доступно через интерфейсы программирования
По сообщению от 30 сентября API позволяют создавать, читать, обрабатывать комментарии и отвечать на них. В Docs поддерживаются предложения изменений текста, в Sheets комментарии связаны с ячейками, в Slides — с элементами презентации. Возможности через MCP объявлены как предварительная версия для разработчиков, поэтому её нельзя приравнивать к общему запуску обычных API. Доступ приложений остаётся под действующими административными настройками.
Выберите ошибку с проверяемым условием
Редакционный пример — в товарной таблице есть обязательная единица измерения, но в нескольких строках она отсутствует. Проверка может указать ячейку и объяснить, какого сведения не хватает. Она не должна угадывать миллиметры или сантиметры по похожему артикулу. Комментарий полезен именно как запрос проверенного исправления.
До разработки опишите правило простыми словами, набор входных полей и условия пропуска. Пустое значение, ноль и «не применяется» могут означать разные состояния. Если правило не различает их, автоматизация создаст много замечаний без полезного действия. Сначала проверьте логику на небольшой таблице с заранее известными ошибками.
Не превращайте повторный запуск в поток дублей
Для производственного сценария нужен способ связать замечание с конкретной строкой, полем и правилом. Повторная проверка того же неизменённого случая не должна бесконечно создавать новые одинаковые обсуждения. Способ хранения этой связи выбирается при реализации; сам факт появления API не подтверждает, что такая защита уже предусмотрена в вашем инструменте.
Заранее договоритесь, кто отвечает на замечание и кто закрывает вопрос. Источник правильного значения определяется правилами товарного справочника. Отсутствие открытого комментария не доказывает корректность поля, если обсуждение закрыли без изменения или сознательно приняли исключение.
Проверьте права и границы записи
Начинайте с тестового документа и минимально необходимого доступа. Отдельно проверьте создание замечания, ответ человека, исправление значения и повторный проход. Полезно включить строку, которую проверка не должна трогать, чтобы обнаружить слишком широкое условие.
В рабочем журнале сохраняйте правило, время запуска и результат, не размножая лишние копии содержимого документов. Программные комментарии могут сделать контроль заметнее и адреснее, но не гарантируют качество исходных характеристик. До передачи задачи разработчику стоит сформулировать именно этот процесс и критерий завершения, а уже затем выбирать API или предварительный MCP-интерфейс.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы