OData Service for namespace microsoft.graph
OData Service for namespace microsoft.graph
Microsoft Graph 统一访问 Microsoft 365 数据（邮件、日历、Teams、OneDrive、用户目录），是企业 Microsoft 集成的入口。
一个 endpoint 覆盖 M365 全产品线
权限申请需要租户管理员同意，部分 scope 需 admin consent
在 portal.azure.com 注册一个 Azure AD app，配权限（delegated 或 application）。OAuth 流程拿 access_token，调 https://graph.microsoft.com/v1.0/... 各端点。常用 SDK：@microsoft/microsoft-graph-client (JS)、Microsoft.Graph (C#)、msgraph-sdk (Python)。
可用率 · 30 天窗口
关于这个 API
Microsoft Graph 把分散在 Outlook、Teams、SharePoint、OneDrive、Azure AD、Excel Online、To Do 等产品的 API 统一到一个 REST 端点。对企业开发者来说意味着不必为每个 M365 产品单独写集成——一套 OAuth 凭证、一套 SDK 就能跨产品做协同。
权限模型分两类。Delegated 权限是应用代表登录用户操作，scope 受用户本身权限限制（如读自己的邮件）；Application 权限是应用自身的身份，需要租户管理员同意，能跨用户操作（适合后台任务）。两套都基于 OAuth 2.0，但 consent 流程和后续 token 内涵不同。设计时要明确选哪种——选错往往后期返工。
速率限制是分布式的：每个 service（Outlook、Teams、SharePoint 等）独立计费，没有统一的总配额。被限时会返回 429 + Retry-After 头，应用层需做指数退避。Change Notifications（webhook）让长链接不必反复轮询，但需公网可访问的 HTTPS 端点。
你可以做什么
- 1为 Microsoft 365 用户搭建邮件 / 日历 / 任务集成
- 2把外部系统数据写入 Teams 频道
- 3从 OneDrive / SharePoint 读取文件做处理
- 4基于 Azure AD 目录做 SSO 与用户同步
- 5为内部工具读写 Excel Online
优劣对比
优点
- 一个 endpoint 覆盖 M365 全产品线
- 细粒度 application + delegated 双权限模型
- webhook 与 Change Notifications 推送变更
- SDK 在 JS/C#/Python 等主流语言都有官方维护
注意事项
- 权限申请需要租户管理员同意，部分 scope 需 admin consent
- 速率限制按 resource 分散，调用前难预测
- 某些 beta endpoint 不保证 SLA 与稳定性
示例请求
curl https://microsoft.com/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"快速开始
在 portal.azure.com 注册一个 Azure AD app，配权限（delegated 或 application）。OAuth 流程拿 access_token，调 https://graph.microsoft.com/v1.0/... 各端点。常用 SDK：@microsoft/microsoft-graph-client (JS)、Microsoft.Graph (C#)、msgraph-sdk (Python)。
常见问题
Graph API 收费吗？+
免费使用，但你必须有有效的 Microsoft 365 / Azure AD 租户。某些功能（如某些 Teams 工作流）需付费 plan。
Delegated 和 Application 权限选哪个？+
需要某用户实时上下文（如读自己邮件）用 Delegated；后台任务、多用户操作用 Application。
admin consent 是什么？+
某些 scope 影响范围超出单用户（如读全租户用户列表），租户管理员必须明确同意才生效。
v1.0 与 beta 端点的区别？+
v1.0 是稳定 GA，有 SLA 与兼容性承诺；beta 提供更早能力但不保证稳定，生产慎用。
技术细节
- 认证方式
- oauth
- 计费
- free
- 协议
- REST
- SDK
- javascript, typescript, python, csharp, java, go
- 响应时间
- 109 ms
- 上次巡检
- 2026/5/12 07:37:52
接口端点
从 OpenAPI spec 自动解析。显示 12 / 11412 个未弃用端点。
/adminadmin.adminGet admin
/adminadmin.adminUpdate admin
/admin/serviceAnnouncementadmin.serviceAnnouncementDelete navigation property serviceAnnouncement for admin
/admin/serviceAnnouncementadmin.serviceAnnouncementGet serviceAnnouncement from admin
/admin/serviceAnnouncementadmin.serviceAnnouncementUpdate the navigation property serviceAnnouncement in admin
/admin/serviceAnnouncement/healthOverviewsadmin.serviceAnnouncementList healthOverviews
/admin/serviceAnnouncement/healthOverviewsadmin.serviceAnnouncementCreate new navigation property to healthOverviews for admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementDelete navigation property healthOverviews for admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementGet healthOverviews from admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementUpdate the navigation property healthOverviews in admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issuesadmin.serviceAnnouncementGet issues from admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issuesadmin.serviceAnnouncementCreate new navigation property to issues for admin
另有 11400 个端点未显示，详见 OpenAPI spec。
更多来自 Microsoft 的 API
Bing Autosuggest API 根据用户输入的部分查询返回搜索建议词，用于搜索框 type-ahead 补全。
Bing Computer Vision API 提供图像分析：OCR、物体检测、人脸检测、场景描述、不雅内容审核。
Bing Custom Image Search 在你自定义的网域子集内做图片搜索（Bing Custom Search 的图片版）。
Bing Custom Search 让你定义专属网域子集，在那个子集上跑 Bing 搜索——做行业垂直/企业内部搜索。
Custom Vision Prediction API 用你训练好的 Custom Vision 模型做推理：上传图片，返回分类标签和置信度。
Custom Vision Training API 程序化训练图像分类/物体检测模型：创建项目、上传图片+标签、触发训练、发布迭代。
Bing Entity Search 把查询识别为命名实体（人、地、机构）并返回结构化卡片信息（描述、图片、相关链接）。
Bing Image Search 在 Bing 全网图片索引上做搜索：按关键词、按相似图片、按 aspect ratio、按图片大小过滤。
可以替代的选择
不同公司、解决相似问题的备选。按分类、认证、计费档位与标签重合度匹配。