勞工統計局 （獨立發行者） （預覽版）
存取勞工統計局 （BLS） 資料集，包括時間序列、熱門序列、調查清單和調查中繼資料。 提供就業、通貨膨脹、工資等經濟指標。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 勞工統計局開發人員 |
| URL | https://www.bls.gov/developers/ |
| webmaster@bls.gov |
| 連接器中繼資料 | |
|---|---|
| Publisher | 克勞特羅克 |
| 網站 | https://www.bls.gov/developers/ |
| 隱私策略 | https://www.bls.gov/bls/bls-privacy.htm |
| 類別 | 金融 |
美國勞工統計局 （BLS） API 連接器
美國勞工統計局 （BLS） API 提供對美國勞動力市場和經濟數據的公眾訪問。 使用此連接器，您可以直接在 Power Platform 中查詢問卷中繼資料並從 BLS 資料集中擷取時間序列資料。
發行商：丹·羅馬諾
先決條件
您必須擁有有效的 BLS API 金鑰。 雖然某些端點無需金鑰即可使用，但大多數進階功能 （目錄中繼資料、計算、年度平均值、層面） 都需要金鑰。
支援的作業
調查
獲取所有調查
檢索所有 BLS 調查的元數據。取得調查中繼資料
使用特定調查的縮寫（例如 CPS、CES）檢索特定調查的元數據。
數列
取得單一系列
擷取單一系列識別碼的資料。 範例：CUUR0000SA0（消費者物價指數、所有城市消費者、美國城市平均值、所有項目）。取得多個系列
張貼數列 ID 和選用參數 （開始年份、結束年份、目錄、計算、年度平均值、方面） 清單，以擷取一或多個數列的資料。獲取熱門系列
檢索最需要的 BLS 系列。
取得憑證
- 前往 BLS API 註冊頁面。
- 提交您的電子郵件地址以接收 API 金鑰。
- 呼叫 API 端點時，請使用此索引鍵作為
registrationkey查詢參數。
已知問題和限制
- BLS API 偶爾會傳回
Results為物件或陣列，視要求而定。 連接器會使用無結構描述定義來規範此情況，以避免 Power Platform 中的執行階段錯誤。 - 適用速率限制。 如果超過臨界值，您可能會收到
429 Too Many Requests錯誤。 - 某些系列 ID 需要特定的調查知識;有關詳細信息，請參閱 BLS 調查文件 。
進一步閱讀
- BLS 公共數據 API 文檔
- BLS 數據查找器 （探索可用的系列 ID）
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| APIKEY | securestring | 此 API 的 apikey | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得單一系列資料 |
使用選擇性參數擷取單一 BLS 系列識別碼的資料。 |
| 取得多個系列數據 |
在單一要求中擷取一或多個 BLS 系列識別碼的資料。 |
| 取得調查中繼資料 |
擷取特定 BLS 調查的中繼資料。 |
| 獲取所有調查 |
檢索所有可用 BLS 調查的列表。 |
| 獲取熱門系列 |
擷取常用存取的 BLS 系列識別碼的資料。 |
取得單一系列資料
使用選擇性參數擷取單一 BLS 系列識別碼的資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
系列識別碼
|
series_id | True | string |
單一 BLS 系列 ID （例如，LAUCN040010000000005）。 |
|
開始年份
|
startyear | string |
第一年要擷取的資料 （YYYY）。 |
|
|
結束年份
|
endyear | string |
去年要檢索的資料 （YYYY）。 |
|
|
包含目錄資訊
|
catalog | boolean |
設定為 以 |
|
|
包括計算
|
calculations | boolean |
設定為 |
|
|
包括年平均值
|
annualaverage | boolean |
設定為 |
|
|
包含方面
|
aspects | boolean |
設定為 以 |
傳回
- response
- object
取得多個系列數據
在單一要求中擷取一或多個 BLS 系列識別碼的資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
系列 ID
|
seriesid | True | array of string |
一或多個 BLS 系列 ID。 |
|
開始年份
|
startyear | string |
第一年要擷取的資料 （YYYY）。 |
|
|
結束年份
|
endyear | string |
去年要檢索的資料 （YYYY）。 |
|
|
包含目錄資訊
|
catalog | boolean |
設定為 以 |
|
|
包括計算
|
calculations | boolean |
設定為 |
|
|
包括年平均值
|
annualaverage | boolean |
設定為 |
|
|
包含方面
|
aspects | boolean |
設定為 以 |
傳回
- response
- object
取得調查中繼資料
擷取特定 BLS 調查的中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
調查 ID
|
survey_id | True | string |
調查的縮寫（例如，CPS、CES）。 |
傳回
- response
- object
獲取所有調查
獲取熱門系列
定義
物件
這是類型 'object'。