Google Cloud Messaging (GCM) natív értesítés küldése
Natív GCM-értesítést küld egy értesítési központon keresztül.
Kérés
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Kérésfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.
| Kérelem fejléce | Leírás |
|---|---|
| Engedélyezés | A Service Bus használatával történő közös hozzáférésű aláírás-hitelesítésben megadott módon létrehozott SAS-jogkivonat. |
| Content-Type | Állítsa application/json;charset=utf-8 értékre. |
| ServiceBusNotification-Tags | {single tag identifier} (nem kötelező) |
| ServiceBusNotification-Format | Állítsa gcm értékre. |
A kérés törzse
A kérelemtörzs a Google által megadott JSON-objektum ( registration_ids tulajdonság nélkül). Például:
{ "collapse_key": "score_update",
"time_to_live": 108,
"delay_while_idle": true,
"data": {
"score": "4x8",
"time": "15:16.2342"
}
}
Reagálás
A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.
Válaszkódok
| Code | Description |
|---|---|
| 200 | Az üzenet elküldése sikerült. |
| 400 | A kérés helytelen (például nem érvényes útválasztási fejlécek, nem érvényes tartalomtípus, az üzenet mérete meghaladja a méretet, rossz üzenetformátum). |
| 401 | Engedélyezési hiba. A hozzáférési kulcs helytelen volt. |
| 403 | Kvóta túllépve vagy az üzenet túl nagy; az üzenet el lett utasítva. |
| 404 | Az URI-n nincs üzenetág. |
| 413 | A kért entitás túl nagy. Az üzenet mérete nem lehet 64 kb-nál nagyobb. |
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
| Válaszfejléc | Description |
|---|---|
| Hely | Ez a fejléc csak a Standard szintű Notification Hubshoz érhető el. Ez a fejléc tartalmazza az értesítési üzenet azonosítóját. Az értesítési üzenet telemetriai adatainak lekérése és a PNS-visszajelzés korrelációja esetén használatos. A hely fejléce a következő formátumot használja: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Választörzs
Nincsenek.