Skip to main content

​
Dropbox

ShanoneのDropbox連携は、個人向けファイル操作や共有に加えて、他の連携ではほとんど扱われないチーム管理系の機能(メンバー、グループ、フォルダ、容量制限)まで含む166個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにDropbox関連の作業を依頼(例: 「Q3レポートを財務チームと共有して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Dropboxアカウントを許可する

Shanoneに操作させたいアカウント(またはチーム)について、DropboxのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、dropbox_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはDropbox向けに166個のツールを、以下のカテゴリに整理して提供しています。
dropbox_list_folder, dropbox_list_folder_continue, dropbox_get_metadata, dropbox_create_folder, dropbox_create_folder_batch, dropbox_create_folder_batch_check, dropbox_delete, dropbox_delete_batch, dropbox_delete_batch_check, dropbox_move, dropbox_move_batch, dropbox_move_batch_check, dropbox_copy, dropbox_copy_batch, dropbox_copy_batch_check, dropbox_search
dropbox_upload_file, dropbox_upload_session_start, dropbox_upload_session_append, dropbox_upload_session_finish, dropbox_upload_session_start_batch, dropbox_upload_session_append_batch, dropbox_upload_session_finish_batch, dropbox_upload_session_finish_batch_check, dropbox_save_url, dropbox_save_url_check_status, dropbox_download_file, dropbox_download_zip, dropbox_get_thumbnail, dropbox_get_thumbnail_v2, dropbox_get_thumbnail_batch, dropbox_get_preview, dropbox_export
dropbox_list_revisions, dropbox_restore, dropbox_permanently_delete, dropbox_lock_file, dropbox_unlock_file, dropbox_unlock_file_batch, dropbox_get_file_lock, dropbox_get_file_lock_batch
dropbox_get_account_info, dropbox_get_account, dropbox_get_account_batch, dropbox_get_features, dropbox_delete_contacts, dropbox_account_set_profile_photo, dropbox_account_delete_profile_photo, dropbox_account_get_photo, dropbox_check_app, dropbox_check_user, dropbox_copy_reference_get, dropbox_copy_reference_save
dropbox_add_template, dropbox_get_template, dropbox_list_templates, dropbox_update_template, dropbox_add_properties, dropbox_update_properties, dropbox_remove_properties, dropbox_overwrite_properties, dropbox_search_properties, dropbox_add_tags, dropbox_get_tags, dropbox_remove_tags
dropbox_paper_create, dropbox_paper_update, dropbox_paper_docs_list, dropbox_paper_docs_get_folder_info, dropbox_paper_docs_download, dropbox_paper_docs_archive, dropbox_paper_docs_permanently_delete, dropbox_paper_docs_sharing_policy_get, dropbox_paper_docs_users_add, dropbox_paper_docs_users_list, dropbox_paper_docs_users_remove
dropbox_file_requests_create, dropbox_file_requests_get, dropbox_file_requests_list, dropbox_file_requests_list_continue, dropbox_file_requests_update, dropbox_file_requests_delete, dropbox_file_requests_delete_all_closed, dropbox_file_requests_count
dropbox_team_members_list, dropbox_team_members_list_continue, dropbox_team_members_get_info, dropbox_team_members_add, dropbox_team_members_add_job_status, dropbox_team_members_set_profile, dropbox_team_members_set_admin, dropbox_team_members_send_welcome_email, dropbox_team_member_set_profile_photo, dropbox_team_member_delete_profile_photo, dropbox_team_groups_list, dropbox_team_groups_list_continue, dropbox_team_groups_get_info, dropbox_team_groups_create, dropbox_team_groups_update, dropbox_team_groups_delete, dropbox_team_groups_members_add, dropbox_team_groups_members_remove, dropbox_team_groups_members_list, dropbox_team_groups_members_set_access
dropbox_team_get_info, dropbox_team_features_get_values, dropbox_team_member_roles_list, dropbox_team_log_get_events, dropbox_team_log_get_events_continue, dropbox_team_folder_list, dropbox_team_folder_list_continue, dropbox_team_folder_get_info, dropbox_team_folder_create, dropbox_team_folder_rename, dropbox_team_folder_archive, dropbox_team_folder_archive_check, dropbox_team_folder_activate, dropbox_team_folder_permanently_delete, dropbox_team_folder_update_sync_settings, dropbox_team_namespaces_list, dropbox_team_namespaces_list_continue, dropbox_team_devices_list, dropbox_team_member_devices_list, dropbox_team_linked_apps_list, dropbox_team_linked_apps_list_members, dropbox_team_sharing_allowlist_add, dropbox_team_sharing_allowlist_remove, dropbox_team_sharing_allowlist_list, dropbox_team_sharing_allowlist_list_continue, dropbox_team_member_space_limits_set, dropbox_team_member_space_limits_get, dropbox_team_member_space_limits_remove, dropbox_team_member_space_limits_excluded_add, dropbox_team_member_space_limits_excluded_remove, dropbox_team_member_space_limits_excluded_list, dropbox_team_member_space_limits_excluded_list_continue, dropbox_team_secondary_emails_add, dropbox_team_secondary_emails_delete, dropbox_team_secondary_emails_resend

​
よくあるユースケース

共有リンクの配布

ファイルをアップロードし、すぐに共有リンクを生成してクライアントに送る

チームオンボーディング

新しいチームメンバーを追加し、グループに割り当て、容量制限を一度の流れで設定する

ファイルリクエストによる回収

ファイルリクエストを作成し、Dropboxアカウントを持たない相手からもドキュメントをアップロードしてもらう

ストレージガバナンス

チームログのイベントと容量制限を監査し、過剰共有や容量超過を検知する

​
トラブルシューティング

おおよそ150MBを超えるファイルは、チャンク分割のアップロードセッションフローが必要です。単発のアップロード呼び出しの代わりに、dropbox_upload_session_start、dropbox_upload_session_append、dropbox_upload_session_finish(またはバッチ版)を使用してください。
dropbox_team_*系のツールには、接続先アカウントがDropbox Business/Teamの管理者であることが必要です。個人のDropboxアカウントや管理者権限のないチームメンバーは呼び出せません。
dropbox_share_folderやdropbox_transfer_folderなどの一部の共有操作は非同期で実行されます。完了するまで、返されたジョブIDを使ってdropbox_check_share_job_statusやdropbox_check_job_statusをポーリングしてください。