# 透過 API 取用資料產品

啟用 API 端點，跨工具與生態系統查詢、篩選及取用您的資料。端點啟用後，您即可透過符合 OData 規範的 API 存取您的資料。

資訊備註您需要下列其中一個訂閱項目：

* Qlik Talend Cloud 企業版
* Qlik Talend Cloud 進階版
* Qlik Cloud 分析進階版
* Qlik Cloud Analytics 企業
* Qlik Sense Enterprise SaaS

## 啟用 API 端點

資訊備註您需要管理資料產品的權限。

1. 從 資料產品 選單中，按一下您要啟用 API 端點的資料產品。

2. 從 概觀 索引標籤，按一下 編輯 > API 端點。

   就會開啟編輯資料產品視窗。

3. 選取您要啟用 API 端點的資料集。

4. 按一下儲存。

   您已返回 概觀 索引標籤，且右上角的 動作 功能表中已提供 API 端點 選項。

   API 端點已建立，您可以進行設定。

當資料產品在市集上啟用時，API 端點也會在市集上的作用中版本中啟用。

## 設定 API 端點

啟用 API 端點後，您可以設定必須用來取用資料集的連線。

檔案型端點會在與資料集相同的儲存體中取用。

1. 在 概觀 索引標籤中，按一下 the 動作圖示 icon > 使用於 > API 端點。

   API 端點視窗已開啟。

2. 如有需要，請選取其他連線。

   您的變更會自動儲存。

## 使用 API

啟用 API 端點後，您就可以使用查詢在其他工具中取用您的資料。

使用 OData 通訊協定。如需詳細資訊，請參閱 [Microsoft 文件](https://learn.microsoft.com/en-us/odata/overview)。

Power Query 或 PowerBI 中的查詢格式為：`= OData.Feed("url-of-the-dataset", null, [Headers = [Authorization = "Bearer your-api-key"]])`

您需要根據您的使用需求調整以下內容：

* `url-of-the-dataset`. 將此部分替換為 API 端點視窗中的 URL。

  ![API 端點視窗中的資料集 URL](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/di-endpoints-url.png)

* `your-api-key`. 將此部分替換為您的 API 金鑰。

警告備註您可以使用這些 API 僅讀取您的資料，而無法寫入資料。

1. 啟用 API 端點。請參閱上述程序。

2. 如果您尚未擁有 API 金鑰，請產生一個。如需詳細資訊，請參閱 [產生與管理 API 金鑰](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm)。

3. 開啟您選擇的工具以擷取資料。在此範例中，使用的是 PowerBI。

4. 按一下 取得資料 > 空白查詢。

5. 輸入查詢。

   以下是一個查詢範例，您可以加以調整並在 Power Query 或 PowerBI 中使用，以從單一資料集擷取資料。

   `= OData.Feed("https://qcs.us.qlikcloud.com/api/data-governance/data-access/data-products/687e50d58d4773120e843007/datasets/687e508ee636a966d6a6f9e4/connections/9d0d8a52-33a8-4d46-be28-068b4fd06282", null, [Headers = [Authorization = "Bearer your-api-key"]])`

6. 如果您想要從其他資料集擷取資料，請為每個資料集建立一個查詢。

7. 按一下 關閉並套用 以套用您的查詢。

8. 資料匯入後，定義資料表之間的關聯。

9. 按一下 管理關聯性 > 新增關聯性。

10. 選取資料表並儲存。

11. 視需要建立任意數量的關聯。

    設定關聯後，您可以在圖表中檢視資料。