为什么这个范围表示为 URI?

Why is this scope expressed as a URI?

https://www.googleapis.com/auth/gmail.metadata

这是来自 https://developers.google.com/gmail/api/auth/scopes。 Gmail API 有一个范围列表。我试图更多地了解我的宇宙。这些 URI return 它们在 GET 上的范围 - 例如,上面的那个 returns "gmail.metadata".

为什么我需要一个 URI?

范围只是表示数据区域以及您可以使用该数据执行的操作的标识符。它们是字符串,它们的设计方式取决于数据所有者:

  • 在为您自己的 API 设计它们时,从有意义的短名称开始,如 this scopes article

  • 使用第三方 API 时,您必须接受给定的内容。 Google 等大型提供商经常使用逻辑 URL 标识符作为命名空间,以确保他们提供的许多云服务之间不会发生冲突。不过,这些并不意味着用作物理 URLs。