Inviare una notifica nativa di Google Cloud Messaging (GCM)
Invia una notifica nativa di GCM tramite un hub di notifica.
Richiesta
Metodo | URI richiesta | Versione HTTP |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Intestazioni della richiesta
Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.
Intestazione della richiesta | Descrizione |
---|---|
Autorizzazione | Token di firma di accesso condiviso generato come specificato in Autenticazione della firma di accesso condiviso con il bus di servizio. |
Content-Type | Impostare su application/json;charset=utf-8 . |
ServiceBusNotification-Tags |
{single tag identifier} (facoltativo) |
ServiceBusNotification-Format | Impostare su gcm . |
Testo della richiesta
Il corpo della richiesta è un oggetto JSON specificato da Google (senza una proprietà registration_ids ). Ad esempio:
{ "collapse_key": "score_update",
"time_to_live": 108,
"delay_while_idle": true,
"data": {
"score": "4x8",
"time": "15:16.2342"
}
}
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codici di risposta
Codice | Descrizione |
---|---|
200 | Messaggio inviato correttamente. |
400 | La richiesta non è valida( ad esempio, intestazioni di routing non valide, tipo di contenuto non valido, dimensioni del messaggio superiori a un formato di messaggio non valido). |
401 | Errore di autorizzazione. La chiave di accesso non è corretta. |
403 | Quota superata o messaggio troppo grande; messaggio rifiutato. |
404 | Nessun ramo di messaggio nell'URI. |
413 | Entità richiesta troppo grande. Le dimensioni del messaggio non possono essere superiori a 64 KB. |
Per informazioni sui codici di stato, vedere Codici di stato e di errore.
Intestazioni di risposta
Intestazione risposta | Descrizione |
---|---|
Location | Questa intestazione è disponibile solo per Hub di notifica di livello Standard. Questa intestazione conterrà l'ID messaggio di notifica. Viene usato con Get Notification Message Telemetry (Ottieni dati di telemetria dei messaggi di notifica) e correlando il feedback PNS. L'intestazione del percorso usa il formato seguente: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Corpo della risposta
No.