Enviar uma notificação nativa do Google Cloud Messaging (GCM)

 

Envia uma notificação nativa do GCM através de um hub de notificação.

Pedir

Método URI do pedido Versão HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do pedido Description
Autorização Token de SAS gerado conforme especificado em Autenticação de Assinatura de Acesso Partilhado com o Service Bus.
Content-Type Definido como application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Definido como gcm.

Corpo do pedido

O corpo do pedido é um objeto JSON , conforme especificado pela Google (sem uma propriedade registration_ids ). Por exemplo:

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

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código Descrição
200 Mensagem enviada com êxito.
400 O pedido é mal formado (por exemplo, cabeçalhos de encaminhamento não válidos, não é válido tipo de conteúdo, a mensagem excede o tamanho, formato de mensagem incorreto).
401 Falha de autorização. A chave de acesso estava incorreta.
403 Quota excedida ou mensagem demasiado grande; a mensagem foi rejeitada.
404 Nenhum ramo de mensagem no URI.
413 Entidade pedida demasiado grande. O tamanho da mensagem não pode ter mais de 64 Kb.

Para obter informações sobre códigos de estado, veja Códigos de Estado e Erro.

Cabeçalhos de resposta

Cabeçalho de resposta Descrição
Localização Este cabeçalho só está disponível para Hubs de Notificação de escalão Standard.

Este cabeçalho irá conter o ID da Mensagem de Notificação. É utilizado com Obter Telemetria de Mensagens de Notificação e correlacionar Comentários PNS. O cabeçalho de localização utiliza o seguinte formato:

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

Corpo da resposta

Nenhum.

Consulte também