创建一个移动友好的待办事项列表应用程序（2）

look_w

了解 Tasks APIGoogle Tasks API 接受对在资源上执行操作的 REST 请求，使用请求的信息作为响应。资源 只是一个 URL，引用可对其执行操作的对象或实体，比如 /lists 或 /users。操作 是 4 个 HTTP “动词” 之一，比如 GET（检索）、POST（创建）、PUT（更新）和 DELETE（删除）。
Google Tasks API 包含两种主要资源：任务和任务列表。用户可拥有多个任务列表，每个列表可拥有多个任务。任务始终存在于任务列表中。Google Tasks API 会将用户创建的第一个任务列表视为他或她的 “默认” 任务列表。
Google Tasks API 使用 JSON 格式编码响应。以下是一个 API 响应示例，它向 https://www.googleapis.com/tasks/v1/lists/@default/tasks 发出一个经过验证的 GET 请求，这是检索用户的默认任务列表的 API 端点。
清单 1. Google Tasks API 响应示例

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

{ "kind": "tasks#tasks", "etag": "\"zhaMOBt\"", "items": [   {    "kind": "tasks#task",    "id": "MTc3Mz",    "etag": "\"zhaMOBt\"",    "title": "Milk",    "updated": "2013-11-11T07:46:09.000Z",    "selfLink": "https://www.googleapis.com/tasks/v1/lists/MTc3Mz/tasks/MTc3MzQ1",    "position": "00000000000637427684",    "status": "needsAction"   },   {    "kind": "tasks#task",    "id": "MTc3Mz",    "etag": "\"zhaMOBt\"",    "title": "Bread",    "updated": "2013-11-11T07:46:11.000Z",    "selfLink": "https://www.googleapis.com/tasks/v1/lists/MTc3Mz/tasks/MTc3MzQ6",    "position": "00000000000717532232",    "status": "needsAction"   },   {        ...   } ] }

如清单 1 所示，Tasks API 生成一个 JSON 编码的响应，其中包含一个任务列表。每个任务条目包含一些有用的元数据，比如任务标题、截止日期、自己的 URL 和状态。现在编码此 JSON 并将它转换为适合在 Web 浏览器中显示的 HTML 表示会非常简单。但是，在大部分时间，您都不会向 Tasks API 发出原始的 GET 和 POST 请求。Google PHP OAuth 客户端和它的服务对象围绕这些请求提供了一个便捷的包装器，将所有相关功能封装到 PHP 对象和方法中。