msgraph-core 1.1.5

Microsoft Graph Core Python客户端库

Microsoft Graph Core Python客户端库包含由Microsoft Graph Python客户端库使用的核心类，用于向Microsoft Graph API发送原生HTTP请求。

注意：这是基于Kiota项目的Microsoft Graph Python核心库的新主要版本。我们建议与完整的Python SDK一起使用。从Python核心库的先前版本升级到这个版本将在您的应用程序中引入破坏性更改。

先决条件

Python 3.8+

此库不支持较旧版本的Python。

入门指南

1. 注册您的应用程序

要调用Microsoft Graph，您的应用程序必须从Microsoft身份平台获取访问令牌。了解更多信息——

• Microsoft Graph的认证和授权基础
• 在Microsoft身份平台中注册您的应用程序

2. 安装所需的包

msgraph-core可在PyPI上获得。

pip3 install msgraph-core
pip3 install azure-identity

3. 配置认证提供者对象

BaseGraphRequestAdapter类的一个实例处理构建客户端。要创建此类的新实例，您需要提供AuthenticationProvider的一个实例，它可以认证对Microsoft Graph的请求。

注意：此客户端库默认提供异步API。异步是一种比多线程更高效的并发模型，可以提供显著的性能优势并支持使用WebSocket等长连接。我们支持流行的Python异步环境，如asyncio、anyio或trio。对于认证，您需要使用azure.identity中的异步凭证类之一。

# Using EnvironmentCredential for demonstration purposes.
# There are many other options for getting an access token. See the following for more information.
# https://pypi.ac.cn/project/azure-identity/#async-credentials
from azure.identity.aio import EnvironmentCredential
from msgraph_core.authentication import AzureIdentityAuthenticationProvider

credential=EnvironmentCredential()
auth_provider = AzureIdentityAuthenticationProvider(credential)

注意：AzureIdentityAuthenticationProvider设置了默认的作用域和允许的主机。

5. 将认证提供者对象传递给BaseGraphRequestAdapter构造函数

from msgraph_core import BaseGraphRequestAdapter
adapter = BaseGraphRequestAdapter(auth_provider)

6. 向Graph发送请求

在您拥有已认证的BaseGraphRequestAdapter之后，您可以开始对该服务进行调用。

import asyncio
from kiota_abstractions.request_information import RequestInformation

request_info = RequestInformation()
request_info.url = 'https://graph.microsoft.com/v1.0/me'

# User is your own type that implements Parsable or comes from the service library
user = asyncio.run(adapter.send_async(request_info, User, {}))
print(user.display_name)

遥测元数据

此库默认捕获元数据，这些元数据提供了对其使用的洞察，并有助于改善开发者体验。这些元数据包括客户端运行的SdkVersion、RuntimeEnvironment和HostOs。

问题

在仓库的问题标签页中查看或记录问题。

贡献

请参阅贡献指南。

版权和许可

版权（c）微软公司。保留所有权利。根据MIT 许可授权。

本项目采用了微软开源行为准则。有关更多信息，请参阅行为准则FAQ或联系opencode@microsoft.com以获取任何额外的疑问或评论。