介绍Google API Design Guide 是 Google 设计 Cloud APIs 和其他 Google APIs 的设计指南。该指南面向的不仅仅是 REST APIs,同时也适用于 RPC APIs,其中 RPC APIs 主要面向的是 gRPC APIs。面向资源的设计传统…
API命名应当是正确的American English,例如License(而不是Licence),color(而不是colour) 使用常用术语的缩写形式。例如使用API而不是Application Programming Interface 尽量使用使用直观的大家所熟悉的术语。例如在描述删除(或销毁)资源时,delete比erase更好。 对于相同的概念,维持使用相同的名称或术语,包括跨API的概念。
pubsub.googleapis.com服务实现了Goole Cloud Pub/Sub API,它定义了以下资源模型: API服务:pubsub.googleapis.com 一组主题:projects/*/topics/*。 一组订阅:projects/*/subscriptions/*。 注意:PUB/SUB API的其他实现可能选用了与上面不同的命名规则。 來源:https://www.bookstack.cn/read/API-design-guide/API...
例如,Gmail API有一组用户,每个用户有一组消息,一组主题,一组标签,单个用户配置资源或多个设置项资源。 尽管REST API和存储系统有概念上的一致性,但具有面向资源的API的服务不一定是数据库,并且在如何解释资源和方法上有巨大的灵活性。比如,创建一个日历事件(资源)可能会为参会者创建附加事件,向参会者发送邀请邮件...
GoogleAPIDesignGuide（⾕歌API设计指南）中⽂版 ⾯向资源的设计 这份设计指南的⽬标是帮助开发⼈员设计简单、⼀致、易⽤的⽹络API。同时，它也有助于收敛基于socket的API和（注：原⽂是with，这⾥翻译为“和”）基于HTTP的REST API。以前，⼈们根据诸如CORBA和Windows COM这样的API接⼝和⽅...
Google 公开了用于创建 HTTP 或 RPC API 的 API 设计指南。对于创建连接 Google Cloud Endpoints 的 gRPC API 的开发人员来说,这些设计原则更值得推荐使用。 早在2014 年,Google 在创建云服务 API 或其它服务 API 时就开始在内部使用了这些设计指南。指南中探讨了 HTTP 或 RPC API 的设计。虽然 HTTP API(也称...
HTTP映射这个特性被Google APIs和Cloud Endpoints gRPC APIs使用,用于JSON/HTTP和Protocol Buffers/RPC之间的转码。 这份指南是一个活跃的文档,它的内容会随着新风格和新设计模式的采用和批准而有所增补。本着这种精神,它永远不会是完整的,并且API设计的艺术和工艺总是有足够的进步空间。
标签(空格分隔): google restful api design 当前版本的API设计指南发布时间:2017-02-21 介绍 这是一份关于网络API如何设计的通用指南,自2014年起Google内部在设计Cloud API和其他Google API时一直遵循此指南。在此共享此设计指南,为外部开发人员提供指导,以此使我们更容易协同工作。 Google Cloud Endpoints开发人员在...
为了设计利用google api设计指南来设计面向资源的API,下面会介绍一些基本的前置知识。 资源 资源是根据业务抽象的一个被命名的整个实体,例如gmail当中的用户、邮件等都是资源。 资源集合与简单资源 一个集合包含相同类型的资源列表,例如一个用户拥有一组联系人。相反的,不是集合资源的资源可以称之为简单资源。
Get the most out of Google Cloud. Our specialists are here to offer you proactive support and always-on expertise to maximize your investment.