Este artigo explica como os administradores podem configurar o Power BI para acessar a API da Udemy Business e consumir os dados aplicáveis para geração de relatórios.
Observe que este guia aborda especificamente o processo de conexão e uso do endpoint da API de Atividade do Usuário do Curso.
Atualmente, a Udemy não fornece modelos de Power BI para outros endpoints da API. Se você deseja se conectar a endpoints adicionais, precisará criar suas próprias consultas do Power BI usando o modelo fornecido como referência.
- Consulte as práticas recomendadas de API da Udemy Business.
- Saiba mais sobre a referência de API da Udemy Business.
Configurar o Power BI para acessar a API da Udemy Business
1. Faça login no domínio da sua organização com privilégios de administrador. Por exemplo, o URL da sua organização deve ser parecido com este: https://{your_domain}.udemy.com/organization/home/.
2. Ative a API na página de integração da API.
Acesse Gerenciar > Configurações > APIs e integrações > Selecione a guia API e, em seguida, "Criar credenciais"
(por exemplo: https://{your_domain}.udemy.com/organization-manage-v2/settings/lms-integration/)
3. Copie o ID e o segredo do cliente para um bloco de notas a partir desta tela e, em "documentação", clique no link da documentação da API. Em seguida, acesse "Listar atividades do curso do usuário" na barra lateral esquerda (exemplo: https://{your_domain}.udemy.com/developers/organization/reporting/methods/organizationusercourseactivity-list/get/).
4. Insira o ID e o segredo do cliente. Isso vai gerar o token de autorização que você usará no Power BI.
5. Copie a autorização, abra o arquivo PowerBI_template e substitua [insert-token] pela autorização; substitua [insert-customer-domain] pelo seu domínio; substitua [insert-AccountID] por Organization_ID e salve o arquivo.
6. Abra o Power BI Desktop.
7. Crie um novo DataSource Web, digite a página inicial da sua organização (exemplo: https://{your_domain}.udemy.com/), autenticação anônima.
Observação: se você estiver recebendo o erro "Acesso ao recurso proibido" com autenticação anônima, pule para a etapa 8.
8. Quando terminar de conectar, clique em "Cancelar" e acesse Obter dados > Consulta em branco.
9. Clique em "Editor avançado", selecione todas as informações que você salvou no PowerBI_template e copie e cole o modelo no Editor avançado. Em seguida, clique em "Concluído".
10. Aguarde até que os dados sejam totalmente carregados e você deverá ter todos os dados necessários do endpoint da API.
- Observação: se você receber a mensagem de erro "the column 'Column1' was not found" (a coluna "Column1" não foi encontrada), isso indica que não há dados.