Файлы и экспорт MCP

Загрузка видео

MCP-сервер не читает локальный путь на компьютере клиента. Создайте upload для purpose content-lab или publishing с MIME-типом, точным размером и именем; отправьте байты на выданный uploadUrl с тем же Content-Type. Проверьте статус READY и используйте upload ID при создании эксперимента или публикации с ключом идемпотентности. Один файл нельзя повторно потребить для другой операции.

Состояния и ограничения

Созданная загрузка живёт один час. До отправки можно проверить состояние или отменить её; отмена использованного файла не удаляет уже созданный ресурс. Несовпадение MIME или размера отклоняется, другой контент для того же upload вызывает 409. Одновременно допускается до 20 активных загрузок на workspace; размер ограничен политикой загрузки видео и доступным хранилищем. При истечении срока создайте новую загрузку.

CSV-экспорт

Небольшой CSV приходит inline с filename, mimeType, sizeBytes, sha256 и content. Большой экспорт даёт downloadUrl и срок один час; скачивайте его с тем же доступом, пока он активен. Максимум экспорта — 32 МиБ; при 413 уменьшите выборку или используйте пагинацию. Текст CSV — UTF-8; при открытии в таблице учитывайте интерпретацию формул и проверяйте недоверенные значения.

Повторы, ограничения и восстановление

MCP/OAuth доступен только при включённом MCP_ENABLED. Регистрация клиента ограничена 10/IP/час, 100/инстанс/час и 10 000 сохранённых клиентов; при недоступной защите возвращается 503. Неиспользуемая регистрация удаляется через 24 часа; активное подключение сохраняет клиента, затем применяется 30 дней неактивности. Подтверждение показывает аккаунт и права. Refresh-token evidence сохраняется до абсолютного срока действия.

Direct автоматически повторяется не более трёх сетевых попыток на операцию, включая повторную очередь. Задержки — 5 и 15 минут. Потерянный ответ означает UNKNOWN: сообщение могло дойти, поэтому каждая потенциально доставленная попытка расходует квоту. Доказанный отказ освобождает резерв. После трёх попыток проверьте переписку; последовательные дубли возможны. Старые неоднозначные резервы автоматически не освобождаются.

Аналитика читает сохранённые снимки; запрос страницы не вызывает Instagram. Очередь обновляет метрики не чаще одного раза в час с общим пределом четырёх одновременных запросов. По умолчанию страница содержит 50 записей, максимум 100; nextCursor открывает следующую страницу. Общие totals относятся ко всему набору. Дата обновления и признак неполных или устаревших данных помогают отличить отсутствие метрик от нуля.