CGTrader (versão prévia)
Obtém modelos do CGTrader para a conta conectada
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
Use esse conector para navegar e baixar modelos 3D do CGTrader dentro do Power Apps e do Power Automate.
Pré-requisitos
Os criadores devem ter uma chave de API válida (ID do cliente OAuth e segredo do cliente) para a API do CGTrader. Eles podem ser solicitados de https://www.cgtrader.com/developers
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente | secureString | A ID do cliente OAuth para a API do CGTrader. Isso pode ser solicitado em https://www.cgtrader.com/developers | Verdade |
| Segredo de Cliente | secureString | O segredo do cliente OAuth para a API do CGTrader. Isso pode ser solicitado em https://www.cgtrader.com/developers | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Baixa um modelo com a ID e o tipo de arquivo fornecidos |
Baixa um modelo com a ID e o tipo de arquivo fornecidos. |
| Obtém as informações de um modelo com a ID fornecida |
Obtém as informações de um modelo com a ID fornecida. |
| Obtém os nomes e as IDs de categoria disponíveis |
Obtém os nomes e as IDs de categoria disponíveis. |
| Pesquisa modelos do CGTrader com base nos filtros determinados |
Pesquisa modelos do CGTrader com base nos filtros especificados. |
Baixa um modelo com a ID e o tipo de arquivo fornecidos
Baixa um modelo com a ID e o tipo de arquivo fornecidos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ModelID
|
model_id | True | number |
Número de ID do modelo do CGTrader. |
|
Tipo de Arquivo
|
file_type | True | string |
O tipo de arquivo preferencial a ser baixado. Exemplos: glb, obj, stl |
Retornos
O conteúdo do ficheiro.
- Conteúdo do ficheiro
- binary
Obtém as informações de um modelo com a ID fornecida
Obtém as informações de um modelo com a ID fornecida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ModelID
|
model_id | True | number |
Número de ID do modelo do CGTrader. |
Retornos
- Corpo
- ModelInfo
Obtém os nomes e as IDs de categoria disponíveis
Obtém os nomes e as IDs de categoria disponíveis.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID
|
Id | number |
ID do modelo |
|
Title
|
Title | string |
Título do modelo |
Pesquisa modelos do CGTrader com base nos filtros determinados
Pesquisa modelos do CGTrader com base nos filtros especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Consulta de pesquisa
|
keywords | string |
Pesquise palavras-chave para consultar. |
|
|
Extensões de arquivo
|
extensions | string |
Filtrar modelos por extensão de arquivo. Separado com vírgulas, exemplo: "glb, obj,stl" |
|
|
Opção de classificação
|
sort | string |
Classificar modelos por: best_match, vendas, mais recentes, mais antigas, lower_price, higher_price |
|
|
ID da categoria
|
category_id | number |
Filtrar modelos por categoria. As IDs de categoria estão disponíveis por meio de GetCategories. |
|
|
Somente poli baixo
|
low_poly | boolean |
Inclua ou exclua modelos poly baixos. |
|
|
Preço máximo
|
max_price | number |
Limite máximo de preço. Pesquisa modelos gratuitos por padrão. |
|
|
Preço mínimo
|
min_price | number |
Limite de preço mínimo. Pesquisa modelos gratuitos por padrão. |
|
|
Número da página
|
page | number |
Os resultados da pesquisa são divididos em páginas, use esse valor para procurar resultados longos |
|
|
Modelos por página
|
per_page | number |
Número de modelos por página, o padrão é 25 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total
|
Total | number |
Total de resultados |
|
Models
|
Models | array of ModelInfo |
Definições
ModelInfo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | number |
ID do modelo |
|
Title
|
Title | string |
Título do modelo |
|
Description
|
Description | string |
Descrição do modelo |
|
URL
|
Url | string |
URL do modelo |
|
Nome do autor
|
AuthorName | string |
Autor do modelo |
|
Licença
|
License | string |
Licença de modelo |
|
Preço
|
Price | number |
Preço do modelo |
|
AvailableFileExtensions
|
AvailableFileExtensions | array of string |
Extensões de arquivo disponíveis |
|
Miniatura
|
Thumbnail | string |
Miniatura de visualização |
binário
Esse é o tipo de dados básico 'binary'.