GCM 服务的 API 参考

用于 Chrome 浏览器的 Google 云消息服务向 Chrome 应用的用户发送消息，该服务处理了消息队列以及传递消息的各个方面。要使用这一服务，您必须同意 Google Cloud Messaging for Chrome API 服务条款。

消息必须遵守这些约束：

Google APIs 客户端库

您可以使用这里定义的 REST 接口在您的应用程序中访问 Chrome 浏览器的 Google 云消息服务，我们还为几种可以用来访问该 API 的流行语言提供了 Google API 客户端库。有关更多信息，请参见 Google APIs 客户端库。

gcm_for_chrome.messages.insert 方法向您的应用程序或扩展程序用户发送消息。

向用户发送消息之前首先需要认证。在 Web 服务器应用程序中使用 OAuth 2.0 详细描述了这一步。

用来获取对 GCM 服务的访问的 URL 为：https://accounts.google.com/o/auth2/auth。

查询字符串的必选参数为：

参数	描述
`client_id`	表示发送请求的应用程序或扩展程序，可以从 Google APIs 控制台获取，参数值必须完全匹配控制台中显示的客户端标识符。
`client_secret`	在 Google APIs 控制台注册的过程中获取的客户端密钥。
`refresh_token`	与应用或扩展程序相关联的令牌，用于获取新的访问令牌。
`grant_type`	`refresh_token` 的 `authorization_code` 值。

认证响应包括：

字段	描述
`access_token`	访问用于 Chrome 浏览器的 GCM 服务所需的有效令牌。
`expires_in`	访问令牌过期的时间，以秒为单位。
`token_type`	返回的令牌类型：`Bearer`。

POST https://www.googleapis.com/gcm_for_chrome/v1/messages

请在请求正文中提供：

参数	描述
`Content-Type`	请求正文的内容类型： `application/json`。
`Authorization`	`Bearer` HTTP 头信息包含访问令牌，例如： `Bearer 1/fFBGRNJru1FQd44AzqT3Zg`。
`channelId`	应用或扩展程序的通道标识符，用来将消息推送回应用或扩展程序。
`subchannelId`	发送消息的子通道，只有 0～3 之间的值才有效。
`paylooad`	消息正文（最多 256 字节），不能包含个人识别信息。