Google API .NET Client v1.69.0 版本更新解析

Google API .NET Client 是一个由 Google 官方维护的 .NET 客户端库，它简化了在 .NET 应用程序中访问各种 Google 服务 API 的过程。这个库提供了一套统一的接口和工具，让开发者能够轻松地集成 Google 服务到他们的应用中。

核心功能改进

1. 宇宙域(Universe Domain)支持优化

本次更新对宇宙域(Universe Domain)相关的功能进行了多项改进。宇宙域是 Google Cloud 中用于区分不同环境的概念，比如商业云(googleapis.com)和政府云(googleapis.us)。

• 修正了 MDS 端点使用 universe-domain 而非 universe_domain 的问题
• 将 BaseClientService.UniverDomain 的 setter 方法标记为过时
• 暂停了对 MDS 宇宙域端点的自动请求

这些改动使得宇宙域的处理更加规范，减少了潜在的错误来源。

2. HttpClient 超时设置简化

在 v1.69.0 中，设置 HttpClient 超时变得更加简单直观。开发者现在可以更容易地控制 API 请求的超时行为，这对于需要精细控制网络请求的应用场景特别有用。

安全与认证增强

1. IAM 服务签名错误处理改进

对使用 IAM 服务进行签名时的错误处理机制进行了显著改进：

• ComputeCredential 和 ImpersonatedCredential 的 SignBlobAsync 方法现在会抛出 GoogleApiException 而非 HttpRequestExtension
• 新的异常类型包含了更详细的错误信息，特别是来自 HTTP 响应的内容

这个变化虽然是一个破坏性变更，但提供了更好的错误诊断能力，有助于开发者更快地定位和解决问题。

2. 推荐的重试策略

为令牌和 IAM 签名 Blob 端点实现了推荐的重试策略。这意味着在这些关键操作失败时，客户端会自动按照最佳实践进行重试，提高了系统的健壮性。

环境变量支持

新增了对 GOOGLE_CLOUD_UNIVERSE_DOMAIN 环境变量的支持。这使得配置宇宙域更加灵活，可以通过环境变量来指定，而不需要修改代码。

依赖项清理

移除了 Google.Apis.Auth.AspNetCore3 中未使用的 Microsoft.AspNetCore.Authorization 依赖项。这个改动虽然也是一个破坏性变更，但简化了依赖关系，减少了潜在冲突。

开发者建议

对于使用 Google.Apis.Auth.AspNetCore3 的开发者，如果项目间接依赖了 Microsoft.AspNetCore.Authorization，现在需要显式添加这个依赖。虽然这是一个破坏性变更，但 Google 团队认为影响范围有限，因此将其包含在次要版本更新中。

总结

Google API .NET Client v1.69.0 带来了多项改进，特别是在错误处理、配置灵活性和依赖管理方面。虽然包含了一些破坏性变更，但这些改动总体上提升了库的稳定性和易用性。开发者应该评估这些变更对自己项目的影响，特别是那些使用 IAM 签名或 ASP.NET Core 认证功能的项目。