이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장

push 개체

업데이트 날짜: 2015년 2월

JavaScript 백 엔드 모바일 서비스에서 앱에 푸시 알림을 보내는 데 사용되는 개체에 대한 액세스를 제공합니다. 모바일 서비스는 Azure 알림 허브와 통합되어 템플릿, 여러 플랫폼, 규모 확장 등의 추가 푸시 알림 기능을 지원합니다. 자세한 내용은 푸시 알림 시작을 참조하십시오.

 

Name 반환 값 설명

apns

apns 개체

APNS(Apple 푸시 알림 서비스)를 사용하여 iOS 앱에 푸시 알림을 보내는 데 사용되는 apns object를 반환합니다.

gcm

gcm 개체

GCM(Google Cloud Messaging)을 사용하여 Android 앱에 푸시 알림을 보내는 데 사용되는 gcm object를 반환합니다.

mpns

mpns 개체

MPNS(Microsoft 푸시 알림 서비스)를 사용하여 Windows Phone 8 또는 Window Phone Silverlight 8.1 앱에 푸시 알림을 보내는 데 사용되는 mpns 개체를 반환합니다.

wns

wns 개체

WNS(Windows 알림 서비스)를 사용하여 Windows 스토어 앱에 푸시 알림을 보내는 데 사용되는 wns 개체를 반환합니다.

createOrUpdateRegistration(registration, options, callback)
등록을 만들거나 업데이트합니다.

매개 변수

Name Type 인수 설명

registration

문자열

업데이트할 등록입니다.

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성은 헤더로 전달됩니다.

속성

Name Type 인수 설명

etag

개체

<옵션>

etag입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

createRegistrationId(callback)
등록 식별자를 만듭니다.

매개 변수

Name Type 인수 설명

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

deleteRegistration(registrationId, options, callback)
등록을 삭제합니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

삭제할 등록입니다.

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성은 헤더로 전달됩니다.

속성

Name Type 인수 설명

etag

개체

<옵션>

etag입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

getRegistration(registrationId, options, callback)
지정한 registrationId를 사용하는 기존 등록을 검색합니다.

매개 변수

Name Type 인수 설명

registrationId

문자열

검색할 등록입니다.

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성이 헤더로 전달됩니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

listRegistrations(options, callback)
모든 기존 등록을 반환합니다.

매개 변수

Name Type 인수 설명

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성은 헤더로 전달됩니다.

속성

Name Type 인수 설명

top

개체

<옵션>

호출에서 가져올 최대 등록 수를 지정합니다.

skip

개체

<옵션>

호출에서 건너뛸 등록 수를 지정합니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

listRegistrationsByTag(tag, options, callback)
지정한 tag를 포함하는 모든 기존 등록을 반환합니다.

매개 변수

Name Type 인수 설명

tag

문자열

등록 태그입니다.

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성은 헤더로 전달됩니다.

속성

Name Type 인수 설명

top

개체

<옵션>

호출에서 가져올 최대 등록 수를 지정합니다.

skip

개체

<옵션>

호출에서 건너뛸 등록 수를 지정합니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

send(tags, payload, options, callback)
템플릿 메시지를 보냅니다.

매개 변수

Name Type 인수 설명

tags

문자열

단일 태그 또는 태그 식입니다. Null이면 모든 템플릿 등록에 메시지가 전송됩니다.

payload

개체 | 문자열

템플릿 메시지 페이로드입니다.

options

개체

<옵션>

요청 옵션 또는 콜백 함수입니다. 추가 속성은 헤더로 전달됩니다.

속성

Name Type 인수 설명

headers

개체

<옵션>

추가 헤더입니다.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

updateRegistration(registration, options, callback)
기존 등록을 업데이트합니다.

매개 변수

Name Type 인수 설명

registration

개체

업데이트할 등록입니다.

options

개체

<옵션>

업데이트할 등록입니다. 등록 개체 정의는 설명 섹션을 참조하세요.

callback

개체

<옵션>

successerror 콜백 함수를 지정하는 JSON 개체입니다.

전역 push 개체를 사용하여 알림 허브에 푸시 알림을 등록하고 템플릿 등록에 메시지를 보냅니다. 기본 등록에 메시지를 보내려면 플랫폼별 푸시 개체를 사용합니다. 모바일 서비스 백 엔드에서 푸시 알림을 등록할 수는 있지만 클라이언트에서 등록 메서드를 호출하여 클라이언트가 알림에 등록하도록 하는 것이 좋습니다. 자세한 내용은 모바일 서비스 앱에 푸시 알림 추가를 참조하세요.

클라이언트에서 시작하는 등록 프로세스에 비즈니스 논리를 삽입할 수 있습니다. 자세한 내용은 Registration endpoint를 참조하세요.

callback 매개 변수에 제공되는 callback 개체는 다음과 같이 정의됩니다.

콜백 개체

속성 Type 설명

success

함수

작업이 성공하면 호출되는 함수입니다. 성공 응답이 함수에 전달됩니다.

error

함수

작업이 실패하면 호출되는 함수입니다. 오류 응답이 함수에 전달됩니다.

콜백 개체의 예제는 다음과 같습니다.

{ success: function(result){
      // Do something with the success response.
   }, error: function(error){
      // Do something with the error response.
   }
}

registration 개체는 다음과 같이 정의됩니다.

등록 개체

속성 Type 적용 대상 설명

registrationId

문자열

모두

등록 ID입니다.

channelUri

문자열

WNS 또는 MPNS 전용

등록의 현재 채널 URI입니다.

deviceToken

문자열

APNS 전용

등록의 현재 장치 토큰입니다.

gcmRegistrationId

문자열

GCM 전용

등록의 현재 RegistrationId입니다.

tags

문자열

모두

쉼표로 구분된 태그 목록(공백 없음)입니다.

bodyTemplate

개체

템플릿 전용

템플릿 등록 본문을 정의합니다.

wnsHeaders

개체

WNS 전용

WNS에서 사용되는 추가 헤더입니다.

mpnsHeaders

개체

MPNS 전용

MPNS에서 사용되는 추가 헤더입니다.

expiry

문자열

APNS 전용

APNS 등록 만료 시간입니다.

표시:
© 2015 Microsoft