Toplu işlemleri doğrudan cihaz tanıtıcıları koleksiyonuna gönderme

Bir grup bildirimi doğrudan cihaz tanıtıcıları koleksiyonuna (Bildirim türü tarafından ifade edilen geçerli bir belirteç) gönderir. Bu API, Temel ve Standart katman Notification Hub ad alanları için kullanılabilir. Bu API'nin kullanıcılarının kayıtları veya yüklemeleri kullanması gerekmez. Bunun yerine, bu API'nin kullanıcıları tüm cihazları kendi başlarına yönetir ve çeşitli Anında İletme Bildirimi Hizmetleri ile iletişim kurmak için yalnızca geçiş hizmeti olarak bir bildirim hub'ı kullanır.

Şu anda, Direct Batch Send istek başına en fazla 1000 cihazı destekler.

Not

Google, Firebase Cloud Messaging ( FCM) eski API'si aracılığıyla desteklediği sürece Google Cloud Messaging'i (GCM) desteklemeye devam ediyoruz. Bu API henüz Firebase Cloud Messaging'i (FCM) desteklemez.

İstek

Yöntem	İstek URI'si	HTTP Sürümü
POST	https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/$batch?direct&api-version=2015-08	HTTP/1.1

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi	Açıklama
Yetkilendirme	Service Bus ile Paylaşılan Erişim İmzası Kimlik Doğrulaması'nda belirtildiği gibi oluşturulan SAS belirteci. Daha fazla bilgi için bkz. Ortak Kavramlar.
İçerik Türü	multipart/mixed; boundary="boundary-string" Sınır dizesi, her bölümü RFC1341'de tanımlanan çok parçalı içerik türüne göre ayırmak için kullanılır. Her bölüm bir kapsülleme sınırıyla başlar ve ardından üst bilgi alanı, boş bir satır ve gövde alanından oluşan bir gövde bölümü içerir.
ServiceBusNotification-Format	Şu geçerli PlatformType değerlerinden birine ayarlayın: windows, apple, gcm, , windowsphone, adm, nokiax, . baidu
x-ms-version	2015-04 (2015-01 ve üzeri tarafından desteklenir)

İstek gövdesi

İstek gövdesi RFC1341'de tanımlandığı gibi çok parçalı. Her bölüm bir kapsülleme sınırıyla başlar ve ardından üst bilgi alanı, boş bir satır ve gövde alanından oluşan bir gövde bölümü içerir. Boş bağlantı boşluk içermemelidir. Aşağıdaki istek örneklerine bakın.

Hedef platform türüne bağlı olarak, bildirim bölümünün gövde biçimi aşağıdaki yerel Gönderme API'lerinde açıklandığı gibi her bir platformla uyumlu olacak şekilde değişir.

• APNS Yerel Bildirimi Gönderme
• GCM Yerel Bildirimi Gönderme
• MPNS Yerel Bildirimi Gönderme
• WNS Yerel Bildirimi Gönderme

İstek gövdesinin cihaz bölümü, bildirimi alacak cihaz tanıtıcılarının bir JSON dizisi olmalıdır.

İstek örnekleri

Aşağıda bir WNS örneği verilmiştir:

POST https://{namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary = "simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: windows
X-WNS-Type: wns/toast
Host: {Namespace}.servicebus.windows.net
Content-Length: 514
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-type: text/xml
Content-Disposition: inline; name=notification

<toast><visual><binding template="ToastText01"><text id="1">Hello there!</text></binding></visual></toast>
--simple-boundary
Content-type: application/json
Content-Disposition: inline; name=devices

['https://db5.notify.windows.com/?token={Token1}','https://db5.notify.windows.com/?token={Token2}','https://db5.notify.windows.com/?token={Token3}']
--simple-boundary--

GcM örneği aşağıda verilmiştir:

POST https://{Namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary="simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: gcm
Host: {Namespace}.servicebus.windows.net
Content-Length: 431
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=notification

{"data":{"message":"Hello via Direct Batch Send!!!"}}
--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=devices

['Device Token1','Device Token2','Device Token3']
--simple-boundary--

Aşağıda bir APNS örneği verilmiştir:

POST https://{Namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary="simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: apple
Host: {Namespace}.servicebus.windows.net
Content-Length: 511
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=notification

{"aps":{"alert":"Hello using APNS via Direct Batch Send!!!"}}
--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=devices

['Device Token1','Device Token2','Device Token3']
--simple-boundary--

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir. Başarılı olduğunda yanıt gövdesi döndürülmedi.

Yanıt kodları

Kod	Açıklama
201	Oluşturulan.
400	Sağlanan çok parçalı içeriğin bir bölümü bulunamadı.
401	Yetkilendirme hatası. Erişim anahtarı yanlıştı.
403	Kota aşıldı veya ileti çok büyük; iletisi reddedildi.
404	URI'de ileti dalı yok.
413	İstenen varlık çok büyük. İleti boyutu 64 Kb'tan büyük olamaz.

Durum kodları hakkında bilgi için bkz. Durum ve Hata Kodları.

Yanıt üst bilgileri

Yanıt üst bilgisi	Açıklama
İçerik Türü	application/xml; charset=utf-8
Konum	Bu üst bilgi yalnızca Standart katman Notification Hubs için kullanılabilir. Bu üst bilgi bildirim iletisi kimliğini içerir. İleti Başına Telemetri: Bildirim İletisi Telemetrisini Al ve PNS Geri Bildirimi ile bağıntılı olarak kullanılır. Konum üst bilgisi aşağıdaki biçimi kullanır: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

Yanıt gövdesi

Hiçbiri

Ayrıca Bkz.

Doğrudan gönderme
APNS yerel bildirimi gönderme
GCM yerel bildirimi gönderme
MPNS yerel bildirimi gönderme
WNS yerel bildirimi gönderme