Condividi tramite


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.

Vedere anche