你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

发送 Google Cloud Messaging (GCM) 本机通知

通过通知中心发送 GCM 本机通知。

请求

方法	请求 URI	HTTP 版本
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

下表介绍必需的和可选的请求标头。

请求标头	说明
授权	按服务总线的共享访问签名身份验证中指定的方式生成的 SAS 令牌。
Content-Type	设置为 `application/json;charset=utf-8`。
ServiceBusNotification-Tags	`{single tag identifier}`（可选）
ServiceBusNotification-Format	设置为 `gcm`。

请求正文是由 Google (指定的 JSON 对象，没有 registration_ids 属性) 。例如：

{ "collapse_key": "score_update",
  "time_to_live": 108,
  "delay_while_idle": true,
  "data": {
    "score": "4x8",
    "time": "15:16.2342"
  }
}

响应包括 HTTP 状态代码和一组响应标头。

代码	说明
200	已成功发送消息。
400	请求格式不正确（例如，路由标头无效、内容类型无效、消息大小超出限制、消息格式错误）。
401	授权失败。访问密钥不正确。
403	已超出配额或消息太大；消息被拒绝。
404	URI 中没有消息分支。
413	请求的实体太大。消息大小不能超过 64 Kb。

有关状态代码的信息，请参阅状态和错误代码。

响应标头	说明
位置	此标头仅适用于标准层通知中心。此标头将包含通知消息 ID。它与获取通知消息遥测和关联 PNS 反馈一起使用。位置标头使用以下格式： `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

无。