存取和下載批次中的檔案
若要存取檔案的特定詳細資料,請將檔案識別碼({FILE_ID}
)搭配資料存取API使用,包括其名稱、位元組大小以及下載連結。
回應包含資料陣列。 根據ID指向的檔案是個別檔案還是目錄,傳回的資料陣列可能會包含單一專案或屬於該目錄的檔案清單。 每個檔案元素都包含檔案的詳細資訊。
API格式
GET /files/{FILE_ID}
屬性 | 說明 |
---|---|
{FILE_ID} | 等於"dataSetFileId" ,要存取的檔案識別碼。 |
要求
curl -X GET https://platform.adobe.io/data/foundation/export/files/{FILE_ID} \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
單一檔案回應
{
"data": [
{
"name": "{FILE_NAME}",
"length": "{LENGTH}",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID}?path={FILE_NAME}"
}
}
}
],
"_page": {
"limit": 100,
"count": 1
}
}
屬性 | 說明 |
---|---|
data.name | 檔案的名稱(例如,profiles.parquet )。 |
data.length | 檔案的大小(位元組)。 |
data._links.self.href | 下載檔案的URL。 |
目錄回應
{
"data": [
{
"dataSetFileId": "{FILE_ID_1}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_1}"
}
}
},
{
"dataSetFileId": "{FILE_ID_2}",
"dataSetViewId": "string",
"version": "1.0.0",
"created": "string",
"updated": "string",
"isValid": true,
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/export/files/{FILE_ID_2}"
}
}
}
],
"_page": {
"limit": 100,
"count": 2
}
}
傳回目錄時,該目錄會包含目錄中所有檔案的陣列。
屬性 | 說明 |
---|---|
data.name | 檔案的名稱(例如,profiles.parquet )。 |
data._links.self.href | 下載檔案的URL。 |
存取檔案的內容
您也可以使用Data Access API來存取檔案的內容。 然後,您可以將內容下載到外部來源。
API格式
GET /files/{dataSetFileId}?path={FILE_NAME}
屬性 | 說明 |
---|---|
{FILE_NAME} | 您嘗試存取的檔案名稱。 |
要求
curl -X GET https://platform.adobe.io/data/foundation/export/files/{FILE_ID}?path={FILE_NAME} \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
屬性 | 說明 |
---|---|
{FILE_ID} | 資料集中檔案的ID。 |
{FILE_NAME} | 檔案的完整名稱(例如,profiles.parquet )。 |
回應
Contents of the file
其他程式碼範例
如需其他範例,請參閱資料存取教學課程。
訂閱資料擷取事件
您可以透過Adobe Developer Console訂閱特定的高值事件。 例如,您可以訂閱資料擷取事件,以接收潛在延遲和失敗的通知。 如需詳細資訊,請參閱有關訂閱Adobe事件通知的教學課程。