模板网站有什么不好,合肥建设集团信息网站,创网科技有限公司怎么样,免费制作app的手机软件编号159原文链接AIP-159: Reading across collections状态批准创建日期2019-07-26更新日期2019-07-26
有时#xff0c;用户需要跨集合检索资源#xff0c;或者在不知道资源所在集合的情况下检索单个资源。
指南
API 可以 在标准 List 方法中允许用户使用 - #xff08;连…编号159原文链接AIP-159: Reading across collections状态批准创建日期2019-07-26更新日期2019-07-26
有时用户需要跨集合检索资源或者在不知道资源所在集合的情况下检索单个资源。
指南
API 可以 在标准 List 方法中允许用户使用 - 连字符或破折号作为通配符支持跨集合读资源 GET v1/publishers-/books?filter… URI模式 必须 使用 * 可以表示集合。URI 模式 不得 使用 - 字符硬编码。方法 必须 在文档中明确记录支持此行为。应答中提供的资源 必须 使用资源的规范名字带有实际的上级集合标识符而非 - 。服务 可以 在 List 请求中支持跨集合读无论下级资源标识符是否保证唯一。但是如果下级资源可能冲突服务 不得 在 Get 请求中支持跨集合读。跨上级资源请求 不应 支持 order_by 。如果要这么做 必须 在域文档中说明这是不得已之举。因为跨上级资源请求让排序规则产生了歧义特别在难以访问上级资源时参考 AIP-217。 重要 如果跨集合 List 方法资源由于无法访问的上级资源例如跨位置 List 而导致部分失败方法 必须 按照 AIP-217 指南表明这一点。 唯一资源查找
有时下级集合中的资源具有跨上级集合唯一的标识符。此时让 Get 方法在不知道所属上级集合的情况下检索资源是有用的。API 可以 允许用户指定通配符集合标识 - 连字符或破折号表示任何上级集合
GET https://example.googleapis.com/v1/publishers/-/books/{book}URI模式 必须 使用 * 可以表示集合。URI 模式 不得 使用 - 字符硬编码。方法 必须 在文档中明确记录支持此行为。应答中提供的资源 必须 使用资源的规范名字带有实际的上级集合标识符而非 - 。例如上述请求返回的资源名字类似于 publishers/123/books/456 而非 publishers/-/books/456 。资源标识 必须 在上级集合中唯一。
进一步阅读
关于由于无法访问资源而导致的部分失败请参考 AIP-217。
修订记录
2019-08-26 添加对无法访问资源指南的引用。2019-08-01 将示例从“shelves”改为“publishers”提供更好的资源所有权示例。
