Ограничения API дополнения для хранилища Drive

Дополнение для хранилища Drive увеличивает общий объем хранилища для учетных записей TrekMail. Агенты могут просматривать состояние дополнения и цены, но не могут покупать дополнение, увеличивать или уменьшать его объем, отменять его или иным образом менять подписку с помощью операций записи API или MCP.

На этой странице описано данное ограничение, которое позволяет использовать полезную автоматизацию, не превращая решения об оплате в фоновые действия агентов.

Что могут просматривать агенты

С разрешением drive:addon:read интеграция может просматривать:

• Текущее состояние дополнения Drive.
• Объем и расчетный период, если дополнение активно.
• Варианты цен для поддерживаемых валют.
• Предварительную информацию об отмене, если она доступна.
• Данные об использовании хранилища, которые помогают определить, может ли понадобиться дополнительный объем.

Этого достаточно для агентов, создающих отчеты, панелей управления, средств мониторинга хранилища и процессов поддержки.

Что агенты не могут менять

API и сервер MCP не предоставляют операций записи для следующих действий:

• Покупка дополнения Drive.
• Увеличение или уменьшение объема дополнения.
• Изменение расчетного периода или способа оплаты.
• Отмена или повторная активация дополнения.
• Инициирование списаний с карты или изменений подписки.

Разрешения drive:addon:write не существует. На сервере MCP нет инструментов для покупки, изменения объема или отмены.

Зачем нужно это ограничение

Изменения объема хранилища могут влиять на счета, валюту, планирование емкости и хранение данных. Полезный агент может заметить высокий уровень использования и объяснить доступные варианты, но заключительный шаг, связанный с оплатой, должен выполняться на панели управления, где человек видит цену и подтверждает действие.

Это также уменьшает ущерб при неправильной настройке агента. Токен с узкими правами для мониторинга хранилища может сообщить, что квота почти исчерпана, но не сможет потратить деньги или отменить дополнительный объем.

Рекомендуемая схема автоматизации

1. Предоставьте drive:addon:read и необходимое разрешение на чтение Drive.
2. Поручите агенту проверить использование и состояние дополнения.
3. Если в хранилище остается мало места, поручите агенту подготовить краткую рекомендацию.
4. Для покупки, изменения объема или отмены направьте пользователя на страницу дополнения Drive на панели управления.

Пример ответа агента:

Ваша учетная запись использует 91% общего хранилища. Текущее дополнение Drive активно. С учетом нынешних темпов роста рекомендуем проверить объем дополнения на панели управления перед следующей группой загрузок.

Льготный период и состояние только для чтения

После отмены дополнения может действовать льготный период, в течение которого файлы остаются доступными для чтения, но запись ограничена. Агенты должны сообщать об этом состоянии, а не пытаться исправить его автоматически. Пользователь может решить, следует ли восстановить объем, удалить файлы или экспортировать данные.

Связанные статьи

• Цены и планы дополнения Drive
• Разрешения и области доступа API Drive
• Как устроены квоты хранилища