Wysyłanie powiadomienia natywnego usługi Google Cloud Messaging (GCM)
Wysyła powiadomienie natywne usługi GCM za pośrednictwem centrum powiadomień.
Żądanie
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
Nagłówek żądania | Opis |
---|---|
Autoryzacja | Token SAS wygenerowany zgodnie z określoną w artykule Uwierzytelnianie za pomocą sygnatury dostępu współdzielonego za pomocą usługi Service Bus. |
Content-Type | Ustaw wartość application/json;charset=utf-8 . |
ServiceBusNotification-Tags |
{single tag identifier} (opcjonalnie) |
ServiceBusNotification-Format | Ustaw wartość gcm . |
Treść żądania
Treść żądania jest obiektem JSON określonym przez firmę Google (bez właściwości registration_ids ). Na przykład:
{ "collapse_key": "score_update",
"time_to_live": 108,
"delay_while_idle": true,
"data": {
"score": "4x8",
"time": "15:16.2342"
}
}
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kody odpowiedzi
Kod | Opis |
---|---|
200 | Wiadomość została pomyślnie wysłana. |
400 | Żądanie jest źle sformułowane (na przykład nieprawidłowe nagłówki routingu, nieprawidłowy typ zawartości, komunikat przekracza rozmiar, nieprawidłowy format wiadomości). |
401 | Niepowodzenie autoryzacji. Klucz dostępu był niepoprawny. |
403 | Przekroczono limit przydziału lub zbyt duży komunikat; wiadomość została odrzucona. |
404 | Brak gałęzi komunikatów w identyfikatorze URI. |
413 | Zażądano zbyt dużej jednostki. Rozmiar komunikatu nie może być dłuższy niż 64 Kb. |
Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).
Nagłówki odpowiedzi
Nagłówek odpowiedzi | Opis |
---|---|
Lokalizacja | Ten nagłówek jest dostępny tylko dla usługi Notification Hubs w warstwie Standardowa. Ten nagłówek będzie zawierać identyfikator komunikatu powiadomienia. Jest on używany z funkcją Uzyskiwanie danych telemetrycznych komunikatów powiadomień i korelowaniem opinii usługi PNS. Nagłówek lokalizacji używa następującego formatu: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Treść odpowiedzi
Brak.