Dropbox
Загрузка, скачивание, обмен и управление файлами в Dropbox
Dropbox — это популярная платформа облачного хранения и совместной работы, которая позволяет отдельным пользователям и командам безопасно хранить, получать доступ и делиться файлами из любого места. Dropbox разработан для легкого управления файлами, синхронизации и мощной совместной работы, независимо от того, работаете ли вы в одиночку или в группе.
С Dropbox в AACFlow вы можете:
- Загружать и скачивать файлы: Бесшовно загружать любые файлы в ваш Dropbox или получать контент по запросу
- Перечислять содержимое папок: Просматривать файлы и папки в любом каталоге Dropbox
- Создавать новые папки: Организовывать ваши файлы, программно создавая новые папки в вашем Dropbox
- Искать файлы и папки: Находить документы, изображения или другие элементы по имени или содержимому
- Генерировать общие ссылки: Быстро создавать общедоступные или приватные ссылки для файлов и папок
- Управлять файлами: Перемещать, удалять или переименовывать файлы и папки как часть автоматизированных рабочих процессов
Эти возможности позволяют вашим агентам AACFlow автоматизировать операции Dropbox непосредственно в ваших рабочих процессах — от резервного копирования важных файлов до распространения контента и поддержания организованных папок. Используйте Dropbox как источник и место назначения для файлов, обеспечивая бесшовное управление облачным хранилищем как часть ваших бизнес-процессов.
Интегрируйте Dropbox в ваш рабочий процесс для управления файлами, обмена и совместной работы. Загружайте файлы, скачивайте контент, создавайте папки, управляйте общими ссылками и многое другое.
Загрузить файл в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь в Dropbox, куда должен быть сохранен файл (например, /folder/document.pdf) |
file | file | Нет | Файл для загрузки (объект UserFile) |
fileContent | string | Нет | Устаревшее: содержимое файла в кодировке base64 |
fileName | string | Нет | Опциональное имя файла (используется, если путь является папкой) |
mode | string | Нет | Режим записи: add (по умолчанию) или overwrite |
autorename | boolean | Нет | Если true, переименовать файл при конфликте |
mute | boolean | Нет | Если true, не уведомлять пользователя об этой загрузке |
| Параметр | Тип | Описание |
|---|
file | object | Метаданные загруженного файла |
↳ id | string | Уникальный идентификатор файла |
↳ name | string | Имя файла |
↳ path_display | string | Отображаемый путь файла |
↳ path_lower | string | Путь файла в нижнем регистре |
↳ size | number | Размер файла в байтах |
↳ client_modified | string | Время изменения клиентом |
↳ server_modified | string | Время изменения сервером |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хэш содержимого файла |
Скачать файл из Dropbox с метаданными и содержимым
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла для скачивания (например, /folder/document.pdf) |
| Параметр | Тип | Описание |
|---|
file | file | Скачанный файл, сохраненный в файлах выполнения |
metadata | json | Метаданные файла |
temporaryLink | string | Временная ссылка для скачивания файла (действительна ~4 часа) |
content | string | Содержимое файла в кодировке base64 (если получено) |
Перечислить содержимое папки в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь папки для перечисления (используйте "" для корневой папки) |
recursive | boolean | Нет | Если true, перечислять содержимое рекурсивно |
includeDeleted | boolean | Нет | Если true, включать удаленные файлы/папки |
includeMediaInfo | boolean | Нет | Если true, включать медиа-информацию для фото/видео |
limit | number | Нет | Максимальное количество результатов для возврата (по умолчанию: 500) |
| Параметр | Тип | Описание |
|---|
entries | array | Содержимое папки |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя элемента |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
↳ size | number | Размер в байтах (только для файлов) |
↳ client_modified | string | Время изменения клиентом |
↳ server_modified | string | Время изменения сервером |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хэш содержимого |
↳ is_downloadable | boolean | Можно ли скачать файл |
↳ has_explicit_shared_members | boolean | Есть ли явные общие участники |
cursor | string | Курсор для постраничной навигации |
has_more | boolean | Есть ли еще результаты |
Создать новую папку в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь новой папки (например, /folder/new_folder) |
autorename | boolean | Нет | Если true, переименовать папку при конфликте |
| Параметр | Тип | Описание |
|---|
folder | object | Метаданные созданной папки |
↳ id | string | Уникальный идентификатор папки |
↳ name | string | Имя папки |
↳ path_display | string | Отображаемый путь папки |
↳ path_lower | string | Путь папки в нижнем регистре |
Удалить файл или папку из Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки для удаления |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные удаленного элемента |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя элемента |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
Переместить или переименовать файл или папку в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
fromPath | string | Да | Текущий путь файла или папки |
toPath | string | Да | Новый путь файла или папки |
autorename | boolean | Нет | Если true, переименовать при конфликте |
allowOwnershipTransfer | boolean | Нет | Если true, разрешить передачу владения |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные перемещенного элемента |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя элемента |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
↳ size | number | Размер в байтах (только для файлов) |
↳ client_modified | string | Время изменения клиентом |
↳ server_modified | string | Время изменения сервером |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хэш содержимого |
Получить метаданные для файла или папки в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки для получения метаданных |
includeMediaInfo | boolean | Нет | Если true, включать медиа-информацию для фото/видео |
includeDeleted | boolean | Нет | Если true, включать удаленные файлы в результатах |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные файла или папки |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя элемента |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
↳ size | number | Размер в байтах (только для файлов) |
↳ client_modified | string | Время изменения клиентом |
↳ server_modified | string | Время изменения сервером |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хэш содержимого |
Создать общую ссылку для файла или папки в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки для общего доступа |
requestedVisibility | string | Нет | Видимость: public, team_only или password |
linkPassword | string | Нет | Пароль для общей ссылки (только если видимость password) |
expires | string | Нет | Дата истечения срока в формате ISO 8601 (например, 2025-12-31T23:59:59Z) |
| Параметр | Тип | Описание |
|---|
sharedLink | object | Созданная общая ссылка |
↳ url | string | URL общей ссылки |
↳ name | string | Имя общего элемента |
↳ path_lower | string | Путь общего элемента в нижнем регистре |
↳ expires | string | Дата истечения срока, если установлена |
↳ link_permissions | object | Разрешения для общей ссылки |
Искать файлы и папки в Dropbox
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос |
path | string | Нет | Путь папки Dropbox для ограничения области поиска (например, /folder/subfolder) |
fileExtensions | string | Нет | Разделенный запятыми список расширений файлов для фильтрации (например, pdf,xlsx) |
maxResults | number | Нет | Максимальное количество результатов для возврата (по умолчанию: 100) |
| Параметр | Тип | Описание |
|---|
matches | array | Результаты поиска |
↳ match_type | object | Тип совпадения: filename, content или both |
↳ metadata | object | Метаданные файла или папки |
hasMore | boolean | Есть ли еще результаты |
cursor | string | Курсор для постраничной навигации |
