Como acessar APIs REST do Power BI programaticamente

Como acessar APIs REST do Power BI programaticamente

Como acessar APIs REST do Power BI programaticamente 1
cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br


Neste artigo, vou explicar como usar a API REST do Power BI para acessar programaticamente os recursos do Serviço do Power BI. Também discutirei a base da API REST e como usar as APIs usando o Postman. Usando a API REST do Power BI, você pode gerenciar programaticamente os serviços administrativos, como obter uma lista de painéis e áreas de trabalho, atualizar um conjunto de dados, copiar um painel de uma área de trabalho para outra e assim por diante.

Para acessar com segurança a API REST do Power BI, primeiro precisamos solicitar um token de incorporação usando o qual podemos chamar as APIs e executar nossas funções. Embora várias operações possam ser executadas usando as APIs REST, neste artigo, investigaremos especificamente como autorizar um aplicativo e chamaremos as APIs usando o Postman.

O que é uma API REST?

A abreviação de DESCANSAR apoia de apresentação State Ttransferência e API apoia UMAaplicação Pprogramação Euinterface. Vamos supor que você esteja tentando encontrar as pontuações de futebol para seu time favorito. Você abre o navegador, pesquisa sua equipe e pressiona enter, e os resultados são exibidos na tela conforme o esperado. Uma API REST também funciona de maneira semelhante. Usando a API REST, você pode procurar por alguns itens e os resultados serão retornados do serviço que você iniciou a solicitação.

A API REST consiste em anatomia simples, como a seguir:

  • O ponto final: Este é o URL do recurso ao qual vamos fazer as solicitações. Por exemplo, https://api.powerbi.com/v1.0/myorg/
  • O método: Embora existam vários métodos para chamar uma API REST, os mais comuns são GET e POST. O GET é usado para recuperar informações enquanto o POST é usado para enviar informações ao recurso na web
  • Os cabeçalhos: O modo de autenticação e os tipos de conteúdo
  • Os dados (corpo): Dados textuais no formato JSON, que precisam ser enviados ao recurso

Neste artigo, usaremos uma ferramenta conhecida como Postman para fazer chamadas de API. Um carteiro é uma ferramenta gratuita com a qual você pode fazer chamadas GET ou POST para vários URLs e salvar os resultados em uma coleção. Você pode baixar a ferramenta no site oficial do Postman.

Leia Também  Semana de treinamento gratuita: como eu uso o kit primeiro respondedor - sp_BlitzIndex

Registrar um aplicativo para Power BI

Para usar a API REST do Power BI, precisamos criar um aplicativo no portal do desenvolvedor do Power BI. Este aplicativo nos fornecerá um ID do cliente reutilizável e uma chave secreta do cliente, usando a qual podemos gerar o token de incorporação necessário para a API REST.

Navegue para https://dev.powerbi.com/apps e faça login com as credenciais da sua conta.

Registrar aplicativo para API REST do Power BI

Figura 1 – Entre com suas credenciais da conta

Depois de fazer login com suas credenciais, você verá seu nome na Etapa 1. Clique em Próximo continuar.

Conectado com credenciais do Power BI

Figura 2 – Conectado com credenciais do Power BI

Na próxima etapa, precisamos registrar o aplicativo. Forneça um Nome da Aplicação para o aplicativo e escolha um tipo de aplicativo. Existem dois tipos de aplicativos – nativos e do lado do servidor. Para os fins deste tutorial, vou usar o Aplicativo Web do lado do servidor. Providencie um URL da Página incial e um URL de redirecionamento, conforme mostrado na figura abaixo.

Registrar aplicação

Figura 3 – Registro do aplicativo

Se você rolar abaixo, poderá ver que existem várias permissões de acesso à API com as quais precisamos definir nosso aplicativo. Como vamos ler os recursos, por enquanto, vamos fornecer o acesso básico de leitura necessário para a leitura dos conjuntos de dados, painéis, relatórios e áreas de trabalho da conta. Clique em Registro Uma vez feito.

Permissões de acesso à API

Figura 4 – Permissões de acesso à API

Depois de clicar em Registrar, o aplicativo será criado e você receberá uma chave e um segredo do aplicativo. Copie as duas credenciais para um local seguro, pois as usaremos nas próximas etapas ao chamar a API REST do Power BI.

Aplicativo registrado com êxito

Figura 5 – Aplicativo registrado com êxito

Autorizar Usuário

Depois que o aplicativo for criado, a próxima etapa é autorizar o usuário ao aplicativo usando o ID do aplicativo e recuperar o token de acesso. Este token de acesso será usado na próxima etapa para chamar as outras APIs.

Para autorizar o usuário, precisamos permitir que ele entre no aplicativo e recupere o token de acesso. Vamos preparar o URL de login primeiro. O URL é https://login.microsoftonline.com/common/oauth2/authorize e aceita os seguintes parâmetros.

  • ID do Cliente

  • ResponseType

  • RedirectURI

  • ResponseMode

  • Escopo

  • Estado

Uma amostra para o URL inteiro seria algo como abaixo.

https://login.microsoftonline.com/common/oauth2/authorize?client_id= <> & response_type = código & redirect_uri = http: // localhost / redirect / & response_mode = query & scope = openid & state = 12345

Cole o URL no navegador e pressione Enter. Uma caixa de diálogo é exibida, exibindo o consentimento do usuário exigido pelo aplicativo para permitir as permissões necessárias. Clique em Aceitar.

Permissões do aplicativo

cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br

Figura 6 – Permissões do aplicativo

Depois que o usuário for autorizado, a página será redirecionada para o URI de redirecionamento mencionado na solicitação da API. Idealmente, essa solicitação possui um código que pode ser usado como o método de autorização para chamar as APIs com segurança. Como não temos nenhum aplicativo da Web em execução em nosso host local, receberemos uma página de erro como abaixo. Se você vir o URL solicitado seção, há algum texto após a palavra código. Copie o texto inteiro e armazene-o com segurança.

Redirecionar URL com código

Figura 7 – URL de redirecionamento com código

Gerar token de acesso

Agora que obtivemos o código, vamos em frente e gerar o token de acesso. Para gerar o token de acesso, precisamos chamar um terminal usando o método Post com informações específicas que retornarão o token de acesso. O URL do recurso é https://login.microsoftonline.com/common/oauth2/v2.0/token. Os seguintes campos precisam ser passados ​​no corpo da solicitação. Usaremos o Postman para chamar o terminal.

  • ID do Cliente

  • ClientSecret

  • Escopo

  • Código

  • RedirectURL

  • GrantScope

Postar solicitação para obter token de acesso

Figura 8 – Solicitar postagem para obter o token de acesso

Quando você chama o terminal acima, os resultados são retornados da seguinte maneira. o access_token é o valor que precisamos usar ao chamar a API REST do Power BI. Copie e armazene o valor do token de acesso em um local seguro.

Obter resultado do token de acesso

Figura 9 – Resultado do token de acesso

Obter lista de relatórios

Agora que obtivemos o token de acesso, podemos chamar a API REST do Power BI e buscar os detalhes conforme necessário. Vamos tentar obter uma lista de todos os relatórios no meu espaço de trabalho pessoal. O ponto final para buscar a lista de relatórios é “https://api.powerbi.com/v1.0/myorg/reports”. Você pode consultar a documentação oficial da Microsoft sobre os pontos de extremidade disponíveis.

Para chamar esse ponto de extremidade, precisamos passar o token de acesso como um método de autorização no cabeçalho da solicitação GET. Você pode consultar a figura abaixo e gerar sua solicitação GET.

Obter relatórios no My Workspace Power BI

Figura 10 – Obter relatórios no meu espaço de trabalho

Como você pode ver na figura acima, buscamos uma lista de todos os relatórios disponíveis na área de trabalho em um formato JSON.

Obter lista de conjuntos de dados

Vamos agora tentar buscar uma lista de todos os conjuntos de dados disponíveis no meu espaço de trabalho usando o mesmo método. O URL para buscar a lista de conjuntos de dados é “https://api.powerbi.com/v1.0/myorg/datasets”.

Obter conjuntos de dados na área de trabalho

Figura 11 – Obter conjuntos de dados na área de trabalho

Conclusão

Neste artigo, expliquei os conceitos básicos de como usar a API REST do Power BI para gerenciar os recursos do Power BI programaticamente. Nos próximos artigos, discutirei mais detalhadamente sobre outros métodos que podem ser usados ​​pela API REST do Power BI para gerenciar vários outros recursos nos espaços de trabalho do Power BI.

Aveek Das
Últimas mensagens de Aveek Das (ver todos)

cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br