使用 REST API 將 Power BI 報表匯出至 PDF、PPTX 或 PNG 檔案

Power BI 新增了一組功能，可讓您使用 REST 呼叫，將 Power BI 報表匯出至下列檔案格式：PDF、PPTX (PowerPoint) 及 PNG。

您有多種方式可以使用此匯出至檔案 API：

• 建立傳送至輸出按鈕 - 在您的應用程式中建立按一下就會觸發匯出作業按鈕。此作業可將您檢視過的報表匯出至 PDF 或 PPTX，而且當匯出一完成，使用者就能下載該檔案。因為這是非同步 API，所以可能需要一些時間，檔案才能使用。
• 電子郵件附件 - 在設定的時間間隔，傳送附加了 PDF 報表的自動化電子郵件。若您需要自動將每週報表傳送給主管，此法十分實用。

當您呼叫匯出至檔案 API 時，其會觸發匯出作業。當觸發匯出作業之後，請使用輪詢 API 追蹤該作業，直到完成為止。當匯出作業完成時，輪詢 API 呼叫會傳回 Power BI URL (此 URL 的有限期限為 24 小時)，以便取得檔案。API 支援同時匯出工作要求。這是您可以同時執行的作業數，取決於您報表所在的 SKU。

以下是此新 API 提供的功能：

• 匯出選取的報表頁面 - 指定您要匯出的頁面及匯出順序。
• 書籤 - 使用書籤功能，在套用篩選之後，匯出特定狀態的報表。
• 資料列層級安全性 (RLS) - 使用 資料列層級安全性 (RLS) 匯出報表，以顯示只有特定使用者才看得見的資料。例如，若要匯出依據區域角色定義的銷售報表，可以透過程式設計的方式篩選報表，以只顯示特定區域。
• 資料保護 - PDF 與 PPTX 格式支援敏感度標籤。若將具有敏感度標籤的報表匯出至 PDF 或 PPTX，則匯出的檔案在顯示該報表時，也會顯示其敏感度標籤。
• 當地語系化 - 您可以在使用 API 時，使用您所需要的當地語系。當地語系化設定會影響報表的顯示方式，例如，報表會依據選取的地區變更格式設定。

請注意，您要匯出的報表與報表資料集，必須位在進階或內嵌容量上。其他預覽功能限制詳述於將報表匯出至檔案 (英文) 一文。

另請注意在所有新的 Power BI API 中，只有 Power BI API .NET SDK v3 才提供匯出至檔案 API。

深入了解。

<p"> </p">