Dropbox

實體、作業和動作

所有整合連接器都為已連結應用程式的物件提供一層抽象層。您只能透過這個抽象層存取應用程式的物件。抽象概念會以實體、作業和動作的形式提供給您。

• 實體： 實體可視為已連結應用程式或服務中的物件或屬性集合。實體的定義與連接器至連接器的定義不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可對實體執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 Operations 清單中不會列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會包含一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

動作

本節列出連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

CopyResource 動作

這個動作可讓您將檔案或資料夾複製到使用者 Dropbox 中的其他位置。

CopyResource 動作的輸入參數

如需 CopyResource 動作的設定範例，請參閱「動作範例」。

CreateFolder 動作

這項動作可讓您在指定路徑中建立資料夾。

CreateFolder 動作的輸入參數

如需 CreateFolder 動作的設定範例，請參閱「動作範例」。

DeleteResource 動作

這項操作可讓您刪除指定路徑中的檔案或資料夾。如果路徑是資料夾，系統也會一併刪除資料夾中的所有內容。

DeleteResource 動作的輸入參數

如需 DeleteResource 動作的設定範例，請參閱「動作範例」。

MoveResource 動作

將檔案或資料夾移至使用者 Dropbox 中的其他位置。如果來源路徑是資料夾，系統會移動該資料夾的所有內容。請注意，我們目前不支援僅變更大小寫的重新命名作業。

MoveResource 動作的輸入參數

如需 MoveResource 動作的設定範例，請參閱「動作範例」。

RenameResource 動作

這個動作可讓您提供路徑和新名稱，藉此重新命名資源。

RenameResource 動作的輸入參數

如需 RenameResource 動作的設定範例，請參閱「動作範例」。

UnshareFolder 動作

這項操作可讓你取消共用資料夾。需要使用 sharing.write 範圍。

UnshareFolder 動作的輸入參數

如需 UnshareFolder 動作的設定範例，請參閱「動作範例」。

DownloadFile 動作

這項動作可讓您下載檔案。需要 files.content.read 權限範圍。

DownloadFile 動作的輸入參數

如需 DownloadFile 動作的設定範例，請參閱「動作範例」。

行動號召範例

本節說明如何在這個連接器中執行部分動作。

範例：複製資源

以下範例說明如何將具有指定路徑的資源複製到其他路徑：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 CopyResource 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "From_Path": "/DropboxFolder/pptxFile.pptx",
     "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx"
   }

如果動作成功，CopyResource 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[ { "Success": "true", "metadata_.tag": "file", 
  "metadata_name": "pptxFile.pptx", 
  "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", 
  "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", 
  "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w",
  "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z",
  "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", 
  "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267",
  "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", 
  "metadata_is_downloadable": "true", 
  "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]

範例：建立資料夾

以下範例說明如何在指定路徑中建立資料夾：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 CreateFolder 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Path": "/TestDrobBoxFolder/newFolder"
   }

如果動作成功，CreateFolder 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]

範例：刪除資源

以下範例說明如何刪除資源：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DeleteResource 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Path": "/TestingDropBox/FolderToBeDeletedName"
   }

如果動作成功，DeleteResource 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
"Status": "Success"
}]

範例：移動資源

以下範例說明如何移動資源：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 MoveResource 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf",
     "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf"
   }

如果動作成功，MoveResource 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Status": "Success"
  }]

範例：重新命名資源

以下範例說明如何重新命名資源：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 RenameResource 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Path": "/TestDropBox/abcd",
     "NewName": "abcded"
   }

如果動作成功，RenameResource 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
"Status": "Success"
}]

範例：取消共用資料夾

以下範例說明如何取消共用資料夾：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnshareFolder 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "FolderId": "3336772979"
   }

如果動作成功，UnshareFolder 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
"Status": "Success"
}]

範例：下載檔案

以下範例說明如何下載檔案：

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DownloadFile 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Id": "id:8-07A6kHAoIAAAAAAAABcg",
     "FileType": "file"
   }

如果動作成功，DownloadFile 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[ { "Success": "true", "Name": "license.txt", 
  "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", 
  "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", 
  "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt",
   "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt",
    "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, 
  "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null,
  "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067",
  "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", 
  "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]