直接送信
通知をデバイス ハンドルに直接送信します ( 通知 の種類で表される有効なトークン)。 この API のユーザーは、登録またはインストールを使用する必要はありません。 代わりに、すべてのデバイスを独自に管理し、Azure Notification Hubs をパススルー サービスとしてのみ使用して、さまざまなプッシュ通知サービスと通信します。
重要
Firebase Cloud Messaging （FCM） は、Google Play がサポートする Android デバイスへのプッシュ通知の送信を開発者が容易に行えるようにするなど、様々な機能を提供するサービスです。 Azure Notification Hubs は現在、レガシ HTTP プロトコルを使用して FCM と通信しています。 FCM v1 は、より多くの機能を提供する更新された API です。 Google は、FCM レガシ HTTP を非推奨にし、2024 年 6 月 20 日をもってそのサポートを停止すると発表しました。 したがって、現在 Azure Notification Hubs を使って Google Play がサポートする Android デバイスと通信している開発者は、自身のアプリケーションや通知ペイロードを新フォーマットに移行する必要があります。 Azure Notification Hubs は、Google が要求の受付を停止するまで、FCM レガシ HTTP のサポートを続けます。 新たな FCM の統合が完了次第、Azure Notification Hubs から移行開始のタイミングが通知されます。 詳細については、 この記事の移行手順を参照してください。
Request
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
HTTP/1.1 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
| 承認 | Service Bus を使用した Shared Access Signature Authentication で指定されたとおりに生成された SAS トークン。 |
| Content-Type | ターゲット プラットフォーム通知サービスに基づいて Content-Type ヘッダーを設定します。
|
| ServiceBusNotification-DeviceHandle | PNS デバイス ハンドル。 |
| ServiceBusNotification-Tags | {単一タグ識別子} (省略可能) |
| ServiceBusNotification-Format | 次のいずれかの有効な PlatformType 値 windows(、、 apple、 gcm、、 windowsphone、 adm、) nokiaxに設定します。 baidu |
| x-ms-version | 2015-04 (2015-01 以降でサポート) |
要求本文
プラットフォームの種類に基づいて、要求本文の書式が変更されます。 ネイティブの Send REST API の個々のプラットフォームの本文形式を参照してください。
Response
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。 成功すると、応答本文が返されます。
応答コード
| コード | 説明 |
|---|---|
| 201 | メッセージは正常に送信されました。 |
| 400 | 要求の形式が正しくありません (たとえば、ルーティング ヘッダーが無効である、コンテンツの種類が無効である、メッセージのサイズが超過している、メッセージ形式が間違っている)。 |
| 401 | 認証エラー。 アクセス キーが正しくありませんでした。 |
| 403 | クォータを超過したか、メッセージが大きすぎます。メッセージは拒否されました。 |
| 404 | URI にメッセージ ブランチがありません。 |
| 413 | 要求されたエンティティが大きすぎます。 メッセージ サイズは 64 Kb を超えることはできません。 |
状態コードの詳細については、「 状態コードとエラー コード」を参照してください。
応答ヘッダー
HTTP 1.1 を使用する場合、証明書ベースの認証を使用する場合、 PNS フィードバック は機能しません。データは返されません。 トークンベースの認証を使用する。
| 応答ヘッダー | 説明 |
|---|---|
| Content-Type | application/xml; charset=utf-8 |
| 場所 | このヘッダーは、 Standard レベルの Notification Hubs でのみ使用できます。 このヘッダーには、通知メッセージ ID が含まれています。 これは、メッセージごとのテレメトリと共に使用されます。通知メッセージ テレメトリを取得し、 PNS フィードバックを関連付けます。 location ヘッダーは、次の形式を使用します。 https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04. |
応答本文
[なし] :