Perguntas frequentes do início rápido do Microsoft Graph

Estas FAQ respondem a perguntas relacionadas com o guia de introdução do Microsoft Graph.

Acerca dos exemplos de início rápido

Os exemplos de início rápido mostram como acessar os recursos do Microsoft Graph. Estes exemplos acedem a dois serviços com uma autenticação: Microsoft Entra ID e Outlook. Cada exemplo de início rápido acede às informações do perfil de um utilizador da conta Microsoft e apresenta mensagens da respetiva caixa de entrada.

O guia de introdução envolve três passos:

1. Escolha o seu idioma.
2. Obtenha o ID de cliente (ID da aplicação).
3. Transfira e execute o exemplo.

Quando você completar o início rápido, você possui um aplicativo pronto para ser executado.

Pré-requisitos

Todos os exemplos de início rápido requerem acesso a uma conta Microsoft pessoal com uma caixa de correio no Outlook.com ou a uma conta escolar ou profissional da Microsoft com uma caixa de correio Exchange Online. Se não tiver uma conta Microsoft, existem algumas opções para obter uma conta gratuita:

• Pode inscrever-se numa nova conta Microsoft pessoal.
• Pode qualificar-se para uma subscrição de programador do Microsoft 365 através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ.
• Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

Perguntas frequentes

Posso obter o código de início rápido sem fazer o download através da página de início rápido?

Com certeza! Cada transferência de exemplo de início rápido baseia-se num tutorial do Microsoft Graph, pelo que tem duas outras opções para obter o mesmo código fonte:

• Crie o código por conta própria seguindo tutorial passo a passo.
• Faça o download do projeto concluído a partir do repositório GitHub correspondente e siga as instruções no README para configurar e executar a amostra.

Para ver uma tabela dos tutoriais e repositórios do GitHub correspondentes, veja Tutoriais do Microsoft Graph.

Por que nenhum dos exemplos de início rápido mostra casos de uso de autenticação avançados?

Os exemplos de início rápido oferecem uma introdução à autenticação e às chamadas à API do Microsoft Graph. Pode saber mais sobre outros fluxos de autenticação na documentação do Microsoft Entra.

E se eu tiver um erro inesperado ou um problema com um início rápido?

Se tiver problemas para que o início rápido funcione corretamente, abra um problema no repositório do GitHub correspondente. Para ver uma tabela dos tutoriais e repositórios do GitHub correspondentes, veja Tutoriais do Microsoft Graph.

Problemas conhecidos

Ao executar um guia de introdução, recebo uma mensagem de erro AADSTS50011.

A mensagem de erro "AADSTS50011: O URL de resposta especificado no pedido não corresponde aos URLs de resposta configurados para a aplicação" indica um problema com o registo da aplicação para o início rápido.

Quando transfere um exemplo de início rápido a partir da página de início rápido do Microsoft Graph , criamos o registo da aplicação e configuramos um URL de resposta (também conhecido como URL de redirecionamento) que corresponde ao URL predefinido utilizado pelo projeto de exemplo. Se alterar o URL, o registo da aplicação deixará de corresponder e poderá causar este erro.

Para resolve este erro, consulte o ficheiro README.md incluído no projeto de início rápido para obter instruções sobre como criar um registo de aplicações e configurá-lo no código de exemplo.

Depois de iniciar sessão, dizem-me que preciso da aprovação do administrador.

Depois de iniciar sessão num dos exemplos de início rápido, poderá ver a seguinte mensagem: "Precisa de aprovação de administrador: O Tutorial XXX precisa de permissão para aceder aos recursos na sua organização que apenas um administrador pode conceder. Peça a um administrador para conceder permissão a esta aplicação antes de poder utilizá-la."

Este não é um erro com o exemplo. Nenhum dos exemplos de início rápido solicita quaisquer âmbitos de permissão do Microsoft Graph que , por predefinição, exijam o consentimento do administrador. Os administradores inquilinos podem desativar a sua capacidade de dar consentimento aos âmbitos de permissão do Microsoft Graph para quaisquer aplicações que não tenham aprovado. Nesse caso, verá este erro.

Para resolve este erro, trabalhe com os administradores para obter aprovação, utilizar uma conta Microsoft pessoal (Outlook.com) ou utilizar um inquilino de teste do Microsoft 365 com Exchange Online.

Não consegue encontrar o que precisa?

Se estas FAQ não resolverem uma questão ou problema que encontrou com um ou mais exemplos de início rápido, informe-nos através da seguinte secção Feedback .

Estas FAQ respondem a perguntas relacionadas com o guia de introdução do Microsoft Graph.

Acerca dos exemplos de início rápido

Os exemplos de início rápido mostram como acessar os recursos do Microsoft Graph. Estes exemplos acedem a dois serviços com uma autenticação: Microsoft Entra ID e Outlook. Cada exemplo de início rápido acede às informações do perfil de um utilizador da conta Microsoft e apresenta mensagens da respetiva caixa de entrada.

O guia de introdução envolve três passos:

1. Escolha o seu idioma.
2. Obtenha o ID de cliente (ID da aplicação).
3. Transfira e execute o exemplo.

Quando você completar o início rápido, você possui um aplicativo pronto para ser executado.

Pré-requisitos

Todos os exemplos de início rápido requerem acesso a uma conta Microsoft pessoal com uma caixa de correio no Outlook.com ou a uma conta escolar ou profissional da Microsoft com uma caixa de correio Exchange Online. Se não tiver uma conta Microsoft, existem algumas opções para obter uma conta gratuita:

• Pode inscrever-se numa nova conta Microsoft pessoal.
• Pode qualificar-se para uma subscrição de programador do Microsoft 365 através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ.
• Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

Com certeza! Cada transferência de exemplo de início rápido baseia-se num tutorial do Microsoft Graph, pelo que tem duas outras opções para obter o mesmo código fonte:

• Crie o código por conta própria seguindo tutorial passo a passo.
• Faça o download do projeto concluído a partir do repositório GitHub correspondente e siga as instruções no README para configurar e executar a amostra.

Para ver uma tabela dos tutoriais e repositórios do GitHub correspondentes, veja Tutoriais do Microsoft Graph.

Os exemplos de início rápido oferecem uma introdução à autenticação e às chamadas à API do Microsoft Graph. Pode saber mais sobre outros fluxos de autenticação na documentação do Microsoft Entra.

Se tiver problemas para que o início rápido funcione corretamente, abra um problema no repositório do GitHub correspondente. Para ver uma tabela dos tutoriais e repositórios do GitHub correspondentes, veja Tutoriais do Microsoft Graph.

A mensagem de erro "AADSTS50011: O URL de resposta especificado no pedido não corresponde aos URLs de resposta configurados para a aplicação" indica um problema com o registo da aplicação para o início rápido.

Quando transfere um exemplo de início rápido a partir da página de início rápido do Microsoft Graph , criamos o registo da aplicação e configuramos um URL de resposta (também conhecido como URL de redirecionamento) que corresponde ao URL predefinido utilizado pelo projeto de exemplo. Se alterar o URL, o registo da aplicação deixará de corresponder e poderá causar este erro.

Para resolve este erro, consulte o ficheiro README.md incluído no projeto de início rápido para obter instruções sobre como criar um registo de aplicações e configurá-lo no código de exemplo.

Depois de iniciar sessão num dos exemplos de início rápido, poderá ver a seguinte mensagem: "Precisa de aprovação de administrador: O Tutorial XXX precisa de permissão para aceder aos recursos na sua organização que apenas um administrador pode conceder. Peça a um administrador para conceder permissão a esta aplicação antes de poder utilizá-la."

Este não é um erro com o exemplo. Nenhum dos exemplos de início rápido solicita quaisquer âmbitos de permissão do Microsoft Graph que , por predefinição, exijam o consentimento do administrador. Os administradores inquilinos podem desativar a sua capacidade de dar consentimento aos âmbitos de permissão do Microsoft Graph para quaisquer aplicações que não tenham aprovado. Nesse caso, verá este erro.

Para resolve este erro, trabalhe com os administradores para obter aprovação, utilizar uma conta Microsoft pessoal (Outlook.com) ou utilizar um inquilino de teste do Microsoft 365 com Exchange Online.

Não consegue encontrar o que precisa?

Se estas FAQ não resolverem uma questão ou problema que encontrou com um ou mais exemplos de início rápido, informe-nos através da seguinte secção Feedback .