CGTrader （預覽版）
從 CGTrader 取得連線帳戶的模型
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
使用此連接器可從 Power Apps 和 Power Automate 內的 CGTrader 瀏覽和下載 3D 模型。
先決條件
製作者必須擁有 CGTrader API 的有效 API 金鑰 （OAuth 用戶端 ID 和用戶端密碼）。 這些可以從以下位置請求 https://www.cgtrader.com/developers
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 用戶端識別碼 | securestring | CGTrader API 的 OAuth 用戶端 ID。 可以在以下網址提出要求： https://www.cgtrader.com/developers | 對 |
| 用戶端密碼 | securestring | CGTrader API 的 OAuth 用戶端密碼。 可以在以下網址提出要求： https://www.cgtrader.com/developers | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 下載具有指定 ID 和檔案類型的模型 |
下載具有指定 ID 和檔案類型的模型。 |
| 取得具有指定 ID 的模型資訊 |
取得具有指定 ID 的模型資訊。 |
| 取得可用的類別名稱和識別碼 |
取得可用的類別名稱和識別碼。 |
| 根據給定的過濾器從 CGTrader 搜索模型 |
根據給定的過濾器從 CGTrader 搜索模型。 |
下載具有指定 ID 和檔案類型的模型
下載具有指定 ID 和檔案類型的模型。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
型號標識碼
|
model_id | True | number |
CGTrader 的型號 ID 號碼。 |
|
檔案類型
|
file_type | True | string |
要下載的首選檔案類型。 範例：glb、obj、stl |
傳回
檔案的內容。
- 檔案內容
- binary
取得具有指定 ID 的模型資訊
取得具有指定 ID 的模型資訊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
型號標識碼
|
model_id | True | number |
CGTrader 的型號 ID 號碼。 |
傳回
- 身體
- ModelInfo
取得可用的類別名稱和識別碼
取得可用的類別名稱和識別碼。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id
|
Id | number |
型號識別碼 |
|
Title
|
Title | string |
型號名稱 |
根據給定的過濾器從 CGTrader 搜索模型
根據給定的過濾器從 CGTrader 搜索模型。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋查詢
|
keywords | string |
搜尋要查詢的關鍵字。 |
|
|
副檔名
|
extensions | string |
依副檔名篩選模型。 用逗號分隔，例如：“glb，obj，stl” |
|
|
排序選項
|
sort | string |
排序模型依下列方式：best_match、銷售、最新、最舊、lower_price higher_price |
|
|
類別標識碼
|
category_id | number |
按類別篩選模型。 類別識別碼可透過 GetCategories 取得。 |
|
|
僅限低多邊形
|
low_poly | boolean |
包括或排除低多邊形模型。 |
|
|
最高價格
|
max_price | number |
最高價格限制。 預設搜尋免費模型。 |
|
|
最低價格
|
min_price | number |
最低價格限制。 預設搜尋免費模型。 |
|
|
頁碼
|
page | number |
搜尋結果會分成頁面，使用此值可瀏覽冗長的結果 |
|
|
每頁型號
|
per_page | number |
每頁模型數，預設為25 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
總數
|
Total | number |
總結果 |
|
Models
|
Models | array of ModelInfo |
定義
ModelInfo
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
Id | number |
型號識別碼 |
|
Title
|
Title | string |
型號名稱 |
|
Description
|
Description | string |
型號說明 |
|
網址
|
Url | string |
模型網址 |
|
作者姓名
|
AuthorName | string |
模型作者 |
|
許可證
|
License | string |
示範授權 |
|
價格
|
Price | number |
型號價格 |
|
可用的檔案副檔名
|
AvailableFileExtensions | array of string |
可用的副檔名 |
|
縮圖
|
Thumbnail | string |
預覽縮圖 |
二進位
這是基本數據類型 『binary』。