Microsoft プッシュ通知サービス (MPNS) ネイティブ通知を送信する

  • [アーティクル]

通知ハブを経由して MPNS ネイティブ通知を送信します。

重要

Microsoft プッシュ通知サービス (MPNS) は非推奨とされ、サポートされなくなりました。

Request

Method 要求 URI HTTP バージョン
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
承認 Service Bus を使用した Shared Access Signature Authentication で指定されたとおりに生成された SAS トークン。
Content-Type application/xml;charset=utf-8 を設定します。
ServiceBusNotification-Tags {single tag identifier} (省略可)
ServiceBusNotification-Format windowsphone
X-* X- で始まるヘッダーはすべて MPNS に転送されます。 「Windows Phone 8 のプッシュ通知」を参照してください。

要求本文

要求本文は、 MPNS で指定された XML ドキュメントです。 通知が 未加工の通知の場合、本文は 1 Kb までの任意のテキストです。 次に例を示します。

<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
  <wp:Tile Id="[Tile ID]" Template="IconicTile">
    <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
    <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
    <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
    <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
    <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
    <wp:Count Action="Clear">[count]</wp:Count>
    <wp:Title Action="Clear">[title]</wp:Title>
    <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
  </wp:Tile>
</wp:Notification>

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

応答コード

コード 説明
200 メッセージは正常に送信されました。
400 要求の形式が正しくありません (たとえば、ルーティング ヘッダーが無効である、コンテンツの種類が無効である、メッセージのサイズが超過している、メッセージ形式が間違っている)。
401 認証エラー。 アクセス キーが正しくありませんでした。
403 クォータを超過したか、メッセージが大きすぎます。メッセージは拒否されました。
404 URI にメッセージ ブランチがありません。
413 要求されたエンティティが大きすぎます。 メッセージ サイズは 64 Kb を超えることはできません。

状態コードの詳細については、「 状態コードとエラー コード」を参照してください。

応答ヘッダー

応答ヘッダー 説明
場所 このヘッダーは、Standard レベルの Notification Hubs でのみ使用できます。

このヘッダーには、通知メッセージ ID が含まれます。 これは、 通知メッセージ テレメトリの取得 と PNS フィードバックの関連付けで使用されます。 location ヘッダーは、次の形式を使用します。

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

応答本文

[なし] :

参照