Merge pull request #268838 from sethmanheim/anh-bpcode

Notification Hubs: add .NET SDK examples

Author: prmerger-automator[bot]

articles/notification-hubs/android-sdk.md

@@ -3,11 +3,11 @@ title: Send push notifications to Android using Azure Notification Hubs and Fire
 description: In this tutorial, you learn how to use Azure Notification Hubs and Google Firebase Cloud Messaging to send push notifications to Android devices (version 1.0.0-preview1).
 author: sethmanheim
 ms.author: sethm
-ms.date: 06/30/2023
+ms.date: 03/14/2024
 ms.topic: tutorial
 ms.service: notification-hubs
-ms.reviewer: thsomasu
-ms.lastreviewed: 05/27/2020
+ms.reviewer: heathertian
+ms.lastreviewed: 03/14/2024
 ms.custom: devx-track-csharp
 ---
 
@@ -32,6 +32,9 @@ This tutorial covers the following steps:
 
 To complete this tutorial, you must have an active Azure account. If you don't have an account, you can create a free trial account in just a couple of minutes. For details, see [Azure Free Trial](https://azure.microsoft.com/free/).
 
+> [!NOTE]
+> Google/Firebase APIs are not supported in Azure China regions.
+
 You also need the following items:
 
 - The latest version of [Android Studio](https://go.microsoft.com/fwlink/?LinkId=389797) is recommended.

articles/notification-hubs/browser-push.md

@@ -7,10 +7,10 @@ manager: femila
 ms.service: notification-hubs
 ms.tgt_pltfrm: mobile-multiple
 ms.topic: article
-ms.date: 12/06/2023
+ms.date: 03/14/2024
 ms.author: sethm
 ms.reviewer: heathertian
-ms.lastreviewed: 12/06/2023
+ms.lastreviewed: 03/14/2024
 ---
 
 # Web push notifications with Azure Notification Hubs (preview)
@@ -25,6 +25,7 @@ At a high level, the process is:
 1. [Set credentials](#set-credentials):
    - [In the Azure portal](#set-credentials-in-azure-portal)
    - [Using the REST API](#set-credentials-using-rest-api)
+   - [Using the Azure SDKs](#set-credentials-using-azure-sdks)
 
 2. [Create registrations and installations](#create-registrations-and-installations).
 
@@ -107,6 +108,28 @@ Enter the credentials in this format, providing the subscription ID, resource gr
 https://management.azure.com/subscriptions/{subcription}/resourceGroups/{resource-group}/providers/Microsoft.NotificationHubs/namespaces/{namespace}/notificationHubs/{hub}api-version=2016-03-01
 ```
 
+### Set credentials using Azure SDKs
+
+You can set the credentials for Browser Push using the Azure SDKs. Here's an example using the .NET SDK:
+
+```csharp
+var browserCreds = new BrowserCredential 
+{ 
+    Subject = "<subject>", 
+    VapidPublicKey = "<vapid public key>", 
+    VapidPrivateKey = "<vapid private key>", 
+} 
+```
+
+and:
+
+```csharp
+await nhManagementClient.NotificationHubs.CreateOrUpdateAsync(config.ResourceGroupName, config.NamespaceName, config.HubName, new NotificationHubCreateOrUpdateParameters(config.Location) 
+{ 
+   BrowserCredential = browserCreds 
+});
+```
+
 ## Create registrations and installations
 
 Bulk sends require registrations or installations. You can also use the registrations and installations in debug sends.
@@ -149,6 +172,40 @@ The following examples show the registration request body for a native registrat
 }   
 ```
 
+### Create native registrations (SDK)
+
+```csharp
+await notificationHubClient.CreateBrowserNativeRegistrationAsync(subscriptionInfo, tagSet);
+```
+
+### Create template registrations (SDK)
+
+```csharp
+await notificationHubClient.CreateBrowserTemplateRegistrationAsync(subscriptionInfo, template, tagSet);
+```
+
+### Create browser installations (SDK)
+
+```csharp
+var browserPushSubscription = new BrowserPushSubscription 
+            { 
+                Endpoint = "", 
+                P256DH = "", 
+                Auth = "", 
+            }; 
+
+var browserInstallation = new BrowserInstallation 
+            { 
+                InstallationId = installationId, 
+                Tags = tags, 
+                Subscription = browserPushSubscription, 
+                UserId = userId, 
+                ExpirationTime = DateTime.UtcNow.AddDays(1), 
+            }; 
+
+await notificationHubClient.CreateOrUpdateInstallationAsync(browserInstallation);
+```
+
 ## Send push notifications
 
 After you [set credentials for browser push](#set-credentials) and [create registrations and installations](#create-registrations-and-installations) for the devices, you're ready to create push notifications. This section describes how to create a notification for a [direct send|](#create-direct-sends), [audience send](#create-audience-sends), and [debug (test) send](#create-debugtest-sends).
@@ -179,6 +236,19 @@ To create a direct send notification, follow these steps:
 
 1. Send the notification.
 
+You can also use the .NET SDK to create a direct send:
+
+```csharp
+var browserSubscriptionEndpoint = ""; 
+var browserPushHeaders = new Dictionary<string, string> 
+            { 
+               { "P256DH", "" }, 
+               { "Auth", "" }, 
+            }; 
+
+var directSendOutcome = await notificationHubClient.SendDirectNotificationAsync(new BrowserNotification("payload", browserPushHeaders), browserSubscriptionEndpoint);
+```
+
 ### Create audience sends
 
 For an audience send, use the same `ServiceBus Notification-Format` header used for a direct send, and modify the message payload as desired. Optionally, specify a tag expression using the `ServiceBusNotification-Tags` header. For more information about creating an audience send, see [Send an APNS native notification](/rest/api/notificationhubs/send-apns-native-notification).