다음을 통해 공유

알림 메시지 원격 분석을 가져오고

  • 아티클

 

이 API는 푸시 알림 보내는의 완료 상태에 추가 원격 분석을 제공합니다. 모니터 푸시 알림 허브에서 보낼 수 있도록 설계 되었습니다. 모든 송신 요청에 대 한 응답의 HTTP 위치 헤더에서 알림 ID는 검색할 수 있습니다.

요청

방법

요청 URI

HTTP 버전

GET

메시지 id가 https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/{notification}? api-버전 = 2015-04

HTTP/1.1

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더

설명

권한 부여

공유 액세스 서명 인증 된에 지정된대로 생성 한 토큰 서비스 버스, 또는 서비스 버스 인증 및 권한 부여와 Microsoft Azure Active Directory 액세스 제어(액세스 제어 서비스 또는 ACS라고도 함)합니다.

x-ms-version

2015-04 (에서 지 원하는 2015-01 이상)

요청 본문

없음.

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다. 성공 응답 본문이 반환 됩니다.

응답 코드

코드

설명

200

메시지 원격 분석을 성공적으로 검색 합니다. 원격 분석 데이터는 전송 된 알림 메시지는 대상 장치 수에 따라 부분 응답을 수 있습니다.

400

요청 형식이 잘못 되었으므로 메시지 원격 분석을 검색할 수 없습니다.

401

인증 실패 액세스 키가 잘못되었습니다.

403

요청이 사용자 SKU에 대 한이 기능을 사용할 수 없으므로 거부 되었습니다. 표준으로 업그레이드 합니다.

404

원격 분석 존재 하지 않습니다. 이 알림 ID 유효 하지 않거나 메시지가 만큼의 처리를 진행 되지 때문에 수 있습니다. 표시 되 면 코드를 404 기다렸다가 10 초 후 다시 시도 하십시오. 이 상태는 최대 30 분 동안 계속할 수 있습니다.

상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드.

응답 헤더

응답 헤더

설명

Content-type

응용 프로그램/xml; charset = u t f-8

응답 본문

응답 본문은 있게는 NotificationDetails 다음과 같은 요소로 구성 된 문서입니다.

요소

설명

NotificationId

ID는 알림 메시지를 식별 하는 요청에 전달 합니다.

위치

메시지에 대 한 URI

시/도

메시지 진행률을 나타냅니다. 상태는 다음 값 중 하나일 수 있습니다.

  • 큐에 대기 된: 메시지 수락 되었으나 처리가 아직 시작 되지 않은 합니다.

  • 처리: 메시지 처리가 시작 되었습니다.

  • 완료: 메시지 처리를 완료 했습니다.

  •  중단: 메시지 처리가 중단 되었습니다. 이렇게 될 경우
    허용 되는 시간 창 내에서 메시지를 처리할 수 없습니다.
    기본적으로 30 분입니다.

  • 알 수 없는: 메시지 처리가 알 수 없는 상태입니다.

EnqueueTime

메시지는 허용 된 시간을 나타냅니다.

StartTime

알림 허브 서비스 알림 작업을 시작 하는 시기를 나타냅니다.

EndTime

알림 허브 서비스 알림 작업을 완료 하는 때를 나타냅니다.

NotificationBody

원래 알림 메시지의 본문입니다.

TargetPlatforms

어떤 플랫폼에서 대상으로 알림을 나타냅니다. 포함 될 수 있습니다
다음 값을 쉼표로 구분 된 문자열:

  • windows

  • apple

  • gcm

  • windowsphone

  • adm

  • baidu

  • template

  • windowstemplate

  • appletemplate

  • gcmtemplate

  • windowsphonetemplate

  • admtemplate

  • baidutemplate

ApnsOutcomeCounts

이 요소는 Apple 푸시 알림 서비스에 보내는 알림에 표시 됩니다.
결과 인스턴스 컬렉션이 포함 되어 있습니다.

MpnsOutcomeCounts

이 요소는 Microsoft 푸시 알림 서비스에 보내는 알림에 표시 됩니다.
결과 인스턴스 컬렉션이 포함 되어 있습니다.

WnsOutcomeCounts

이 요소는 Windows 알림 서비스에 보내는 알림에 표시 됩니다.
결과 인스턴스 컬렉션이 포함 되어 있습니다.

GcmOutcomeCounts

이 요소는 Google Cloud Messaging에 보내는 알림에 표시 됩니다.
결과 인스턴스 컬렉션이 포함 되어 있습니다.

AdmOutcomeCounts

이 요소는 Amazon 장치 메시징에 보내는 알림에 표시 됩니다.
결과 인스턴스 컬렉션이 포함 되어 있습니다.

결과

이러한 인스턴스의 컬렉션 각 플랫폼 알림 서비스에 대 한 위의 수를 구성 합니다. 각 결과 개수 라는 다음 중 하나일 수 있습니다.

Name

수 설명

AbandonedNotificationMessages

시간 제한으로 인해 삭제 된 서비스를 푸시하기 위해 요청의 보내기 수입니다.

BadChannel

푸시 서비스에 대 한 통신 채널 올바르지 않아 하지 못했습니다.

ChannelDisconnected

연결이 끊긴 서비스를 푸시하십시오.

ChannelThrottled

푸시 서비스 조정으로 인해 액세스할 수 없습니다.

삭제

푸시 서비스에서 메시지 삭제 되었음을 나타냅니다.

ExpiredChannel

채널 만료 푸시 서비스에 대 한 통신에 실패 했습니다.

InvalidCredentials

푸시 서비스를 인증 하는 데 사용 되는 자격 증명에 실패 했습니다.

InvalidNotificationFormat

푸시 요청은 푸시 서비스에 대 한 올바르게 포맷 됩니다.

InvalidNotificationSize

푸시 요청 너무 큽니다.

NoTargets

에 보내려는 아무 발견 되는 요청의 수입니다.

PnsInterfaceError

서비스 계약 통신 실패를 푸시하십시오.

PnsServerError

푸시 서비스에서 지. 오류가 발생 하 표시 됩니다.

PnsUnavailable

푸시 서비스를 사용할 수 없습니다.

PnsUnreachable

푸시 서비스에서 응답할 수 없습니다.

건너뜀

중복 등록 (동일한 PNS는 검색, 서로 다른 등록 ID를 처리 하는 데 사용)의 수입니다.

성공

성공적으로 특정 수의 장치에 요청을 전송 합니다.

제한

푸시 서비스 조정으로 인해 액세스할 수 없습니다.

UnknownError

알 수 없는 오류가 발생 했습니다.

WrongToken

유효한 핸들로 PNS에서 PNS 핸들을 인식 되지 않았습니다.

다음은 예제에서는 원격 분석에서 WNS 알림을 보내기입니다.

<NotificationDetails xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <NotificationId>{Your message id}</NotificationId> <Location>sb://{Your namespace}.servicebus.windows.net/{your hub name}/messages/{your message id}?api-version=2015-04</Location> <State>Completed</State> <EnqueueTime>2015-11-02T21:19:43Z</EnqueueTime> <StartTime>2015-11-02T21:19:43.9926996Z</StartTime> <EndTime>2015-11-02T21:19:43.9926996Z</EndTime> <NotificationBody>&lt;?xml version="1.0" encoding="utf-16"?&gt;&lt;toast&gt;&lt;visual&gt;&lt;binding template="ToastText01"&gt;&lt;text id="1"&gt;Hello from a .NET App!&lt;/text&gt;&lt;/binding&gt;&lt;/visual&gt;&lt;/toast&gt;</NotificationBody> <TargetPlatforms>windows</TargetPlatforms> <WnsOutcomeCounts> <Outcome> <Name>Success</Name> <Count>3</Count> </Outcome> <Outcome> <Name>WrongToken</Name> <Count>1</Count> </Outcome> </WnsOutcomeCounts> </NotificationDetails>

참고 항목

GCM 기본 알림 보내기
템플릿 알림 보내기
WNS 기본 알림 보내기
APNS 기본 알림 보내기
MPNS 기본 알림 보내기