Como usar Hubs de Notificação do Python

Você pode acessar todos os recursos dos Hubs de Notificação a partir de um back-end Java/PHP/Python/Ruby usando a interface REST do Hub de Notificação, conforme descrito no artigo do MSDN Notification Hubs REST APIs.

Observação

Esta é uma implementação de referência de exemplo para implementar os envios de notificação em Python e não é o SDK Python do Hub de Notificações oficialmente suportado. O exemplo foi criado usando Python 3.4.

Este artigo mostra-lhe como:

Crie um cliente REST para recursos de Hubs de Notificação em Python.
Envie notificações usando a interface Python para as APIs REST do Hub de Notificação.
Obtenha um registo da solicitação/resposta HTTP REST para finalidades de depuração/educação.

Você pode seguir o tutorial de Introdução para a sua plataforma móvel da sua escolha, implementando a parte de back-end em Python.

Observação

O escopo da amostra é limitado apenas ao envio de notificações e não faz nenhum gerenciamento de registro.

Interface do cliente

A interface do cliente principal pode fornecer os mesmos métodos que estão disponíveis no SDK dos Hubs de Notificação do .NET. Esta interface permite traduzir diretamente todos os tutoriais e amostras atualmente disponíveis neste site, e contribuídos pela comunidade na internet.

Você pode encontrar todo o código disponível no exemplo de wrapper Python REST.

Por exemplo, para criar um cliente:

isDebug = True
hub = NotificationHub("myConnectionString", "myNotificationHubName", isDebug)

Para enviar uma notificação do sistema do Windows:

wns_payload = """<toast><visual><binding template=\"ToastText01\"><text id=\"1\">Hello world!</text></binding></visual></toast>"""
hub.send_windows_notification(wns_payload)

Execução

Se você ainda não o fez, siga o tutorial Introdução até a última seção onde você tem que implementar o back-end.

Todos os detalhes para implementar um wrapper REST completo podem ser encontrados no MSDN. Esta seção descreve a implementação Python das principais etapas necessárias para acessar pontos de extremidade REST dos Hubs de Notificação e enviar notificações

Analisar a cadeia de conexão
Gerar o token de autorização
Enviar uma notificação usando a API REST HTTP

Analisar a cadeia de conexão

Aqui está a classe principal implementando o cliente, cujo construtor analisa a cadeia de conexão:

class NotificationHub:
    API_VERSION = "?api-version=2013-10"
    DEBUG_SEND = "&test"

    def __init__(self, connection_string=None, hub_name=None, debug=0):
        self.HubName = hub_name
        self.Debug = debug

        # Parse connection string
        parts = connection_string.split(';')
        if len(parts) != 3:
            raise Exception("Invalid ConnectionString.")

        for part in parts:
            if part.startswith('Endpoint'):
                self.Endpoint = 'https' + part[11:].lower()
            if part.startswith('SharedAccessKeyName'):
                self.SasKeyName = part[20:]
            if part.startswith('SharedAccessKey'):
                self.SasKeyValue = part[16:]

Criar token de segurança

Os detalhes da criação do token de segurança estão disponíveis aqui. Adicione os NotificationHub seguintes métodos à classe para criar o token com base no URI da solicitação atual e nas credenciais extraídas da cadeia de conexão.

@staticmethod
def get_expiry():
    # By default returns an expiration of 5 minutes (=300 seconds) from now
    return int(round(time.time() + 300))


@staticmethod
def encode_base64(data):
    return base64.b64encode(data)


def sign_string(self, to_sign):
    key = self.SasKeyValue.encode('utf-8')
    to_sign = to_sign.encode('utf-8')
    signed_hmac_sha256 = hmac.HMAC(key, to_sign, hashlib.sha256)
    digest = signed_hmac_sha256.digest()
    encoded_digest = self.encode_base64(digest)
    return encoded_digest


def generate_sas_token(self):
    target_uri = self.Endpoint + self.HubName
    my_uri = urllib.parse.quote(target_uri, '').lower()
    expiry = str(self.get_expiry())
    to_sign = my_uri + '\n' + expiry
    signature = urllib.parse.quote(self.sign_string(to_sign))
    auth_format = 'SharedAccessSignature sig={0}&se={1}&skn={2}&sr={3}'
    sas_token = auth_format.format(signature, expiry, self.SasKeyName, my_uri)
    return sas_token

Enviar uma notificação usando a API REST HTTP

Observação

O Serviço de Notificação por Push da Microsoft (MPNS) foi preterido e não é mais suportado.

Primeiro, vamos usar definir uma classe que representa uma notificação.

class Notification:
    def __init__(self, notification_format=None, payload=None, debug=0):
        valid_formats = ['template', 'apple', 'gcm',
                         'windows', 'windowsphone', "adm", "baidu"]
        if not any(x in notification_format for x in valid_formats):
            raise Exception(
                "Invalid Notification format. " +
                "Must be one of the following - 'template', 'apple', 'gcm', 'windows', 'windowsphone', 'adm', 'baidu'")

        self.format = notification_format
        self.payload = payload

        # array with keynames for headers
        # Note: Some headers are mandatory: Windows: X-WNS-Type, WindowsPhone: X-NotificationType
        # Note: For Apple you can set Expiry with header: ServiceBusNotification-ApnsExpiry
        # in W3C DTF, YYYY-MM-DDThh:mmTZD (for example, 1997-07-16T19:20+01:00).
        self.headers = None

Essa classe é um contêiner para um corpo de notificação nativo ou um conjunto de propriedades de uma notificação de modelo, um conjunto de cabeçalhos, que contém formato (plataforma nativa ou modelo) e propriedades específicas da plataforma (como propriedade de expiração da Apple e cabeçalhos WNS).

Consulte a documentação das APIs REST dos Hubs de Notificação e os formatos específicos das plataformas de notificação para todas as opções disponíveis.

Agora, com essa classe, escreva os métodos de notificação de envio dentro da NotificationHub classe.

def make_http_request(self, url, payload, headers):
    parsed_url = urllib.parse.urlparse(url)
    connection = http.client.HTTPSConnection(
        parsed_url.hostname, parsed_url.port)

    if self.Debug > 0:
        connection.set_debuglevel(self.Debug)
        # adding this querystring parameter gets detailed information about the PNS send notification outcome
        url += self.DEBUG_SEND
        print("--- REQUEST ---")
        print("URI: " + url)
        print("Headers: " + json.dumps(headers, sort_keys=True,
                                       indent=4, separators=(' ', ': ')))
        print("--- END REQUEST ---\n")

    connection.request('POST', url, payload, headers)
    response = connection.getresponse()

    if self.Debug > 0:
        # print out detailed response information for debugging purpose
        print("\n\n--- RESPONSE ---")
        print(str(response.status) + " " + response.reason)
        print(response.msg)
        print(response.read())
        print("--- END RESPONSE ---")

    elif response.status != 201:
        # Successful outcome of send message is HTTP 201 - Created
        raise Exception(
            "Error sending notification. Received HTTP code " + str(response.status) + " " + response.reason)

    connection.close()


def send_notification(self, notification, tag_or_tag_expression=None):
    url = self.Endpoint + self.HubName + '/messages' + self.API_VERSION

    json_platforms = ['template', 'apple', 'gcm', 'adm', 'baidu']

    if any(x in notification.format for x in json_platforms):
        content_type = "application/json"
        payload_to_send = json.dumps(notification.payload)
    else:
        content_type = "application/xml"
        payload_to_send = notification.payload

    headers = {
        'Content-type': content_type,
        'Authorization': self.generate_sas_token(),
        'ServiceBusNotification-Format': notification.format
    }

    if isinstance(tag_or_tag_expression, set):
        tag_list = ' || '.join(tag_or_tag_expression)
    else:
        tag_list = tag_or_tag_expression

    # add the tags/tag expressions to the headers collection
    if tag_list != "":
        headers.update({'ServiceBusNotification-Tags': tag_list})

    # add any custom headers to the headers collection that the user may have added
    if notification.headers is not None:
        headers.update(notification.headers)

    self.make_http_request(url, payload_to_send, headers)


def send_apple_notification(self, payload, tags=""):
    nh = Notification("apple", payload)
    self.send_notification(nh, tags)


def send_google_notification(self, payload, tags=""):
    nh = Notification("gcm", payload)
    self.send_notification(nh, tags)


def send_adm_notification(self, payload, tags=""):
    nh = Notification("adm", payload)
    self.send_notification(nh, tags)


def send_baidu_notification(self, payload, tags=""):
    nh = Notification("baidu", payload)
    self.send_notification(nh, tags)


def send_mpns_notification(self, payload, tags=""):
    nh = Notification("windowsphone", payload)

    if "<wp:Toast>" in payload:
        nh.headers = {'X-WindowsPhone-Target': 'toast',
                      'X-NotificationClass': '2'}
    elif "<wp:Tile>" in payload:
        nh.headers = {'X-WindowsPhone-Target': 'tile',
                      'X-NotificationClass': '1'}

    self.send_notification(nh, tags)


def send_windows_notification(self, payload, tags=""):
    nh = Notification("windows", payload)

    if "<toast>" in payload:
        nh.headers = {'X-WNS-Type': 'wns/toast'}
    elif "<tile>" in payload:
        nh.headers = {'X-WNS-Type': 'wns/tile'}
    elif "<badge>" in payload:
        nh.headers = {'X-WNS-Type': 'wns/badge'}

    self.send_notification(nh, tags)


def send_template_notification(self, properties, tags=""):
    nh = Notification("template", properties)
    self.send_notification(nh, tags)

Esses métodos enviam uma solicitação HTTP POST para o endpoint /messages do seu hub de notificação, com os cabeçalhos e o corpo corretos para enviar a notificação.

Usando a propriedade debug para activar o registo detalhado

Habilitar a propriedade debug durante a inicialização do Hub de Notificação grava informações detalhadas de log sobre a solicitação HTTP e o despejo de resposta, bem como o resultado detalhado do envio da mensagem de notificação. A propriedade TestSend dos Hubs de Notificação retorna informações detalhadas sobre o resultado do envio de notificação. Para usá-lo - inicialize usando o seguinte código:

hub = NotificationHub("myConnectionString", "myNotificationHubName", isDebug)

Como resultado, a URL HTTP da solicitação de envio do Hub de Notificação é acrescentada com um parâmetro de consulta "teste".

Conclua o tutorial

Agora podes concluir o tutorial "Get Started" enviando a notificação a partir de um back-end em Python.

Inicialize o cliente dos Hubs de Notificação (substitua a cadeia de conexão e o nome do hub conforme as instruções no tutorial Introdução):

hub = NotificationHub("myConnectionString", "myNotificationHubName")

Em seguida, adicione o código de envio dependendo da sua plataforma móvel de destino. Este exemplo também adiciona métodos de nível superior para permitir o envio de notificações dependendo da plataforma, por exemplo, send_windows_notification para Windows; send_apple_notification (para Apple) etc.

Windows Store e Windows Phone 8.1 (não Silverlight)

wns_payload = """<toast><visual><binding template=\"ToastText01\"><text id=\"1\">Test</text></binding></visual></toast>"""
hub.send_windows_notification(wns_payload)

Windows Phone 8.0 e 8.1 Silverlight

hub.send_mpns_notification(toast)

iOS

alert_payload = {
    'data':
        {
            'msg': 'Hello!'
        }
}
hub.send_apple_notification(alert_payload)

Androide

gcm_payload = {
    'data':
        {
            'msg': 'Hello!'
        }
}
hub.send_google_notification(gcm_payload)

Kindle Fire

adm_payload = {
    'data':
        {
            'msg': 'Hello!'
        }
}
hub.send_adm_notification(adm_payload)

Baidu

baidu_payload = {
    'data':
        {
            'msg': 'Hello!'
        }
}
hub.send_baidu_notification(baidu_payload)

A execução do código Python deve produzir uma notificação que aparece no dispositivo de destino.

Exemplos

Ativação da `debug` propriedade

Quando ativa o sinalizador de depuração ao inicializar o NotificationHub, vê um detalhamento detalhado das solicitações e respostas HTTP, bem como o resultado da notificação, como no exemplo abaixo, onde pode entender quais cabeçalhos HTTP são passados na solicitação e qual resposta HTTP foi recebida do Hub de Notificação.

Captura de ecrã de um console com detalhes do dump de solicitação e resposta H T T P e mensagens de Resultado de Notificação destacadas em vermelho.

Você vê o resultado detalhado do Hub de Notificação, por exemplo.

quando a mensagem é enviada com êxito para o Serviço de Notificação por Push.

<Outcome>The Notification was successfully sent to the Push Notification System</Outcome>

Se não forem encontrados destinatários para qualquer notificação push, então irá provavelmente ver a seguinte resposta (o que indica que não foram encontrados registos para entregar a notificação, provavelmente porque os registos tinham algumas tags incompatíveis)
```
'<NotificationOutcome xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="https://www.w3.org/2001/XMLSchema-instance"><Success>0</Success><Failure>0</Failure><Results i:nil="true"/></NotificationOutcome>'
```

Notificação de 'toast' transmitida para o Windows

Observe os cabeçalhos que são enviados quando você está enviando uma notificação do sistema de difusão para o cliente Windows.

hub.send_windows_notification(wns_payload)

Captura de ecrã de uma consola com detalhes do pedido H T T P e dos valores do Formato de Notificação do Service Bus e do Tipo X W N S descritos a vermelho.

Enviar notificação especificando uma tag (ou expressão de tag)

Observe o cabeçalho HTTP Tags, que é adicionado à solicitação HTTP (no exemplo abaixo, a notificação é enviada apenas para registros com carga 'esportiva')

hub.send_windows_notification(wns_payload, "sports")

Captura de ecrã de uma consola com detalhes do pedido H T T P e do Formato de Notificação do Service Bus, uma Etiqueta de Notificação do Service Bus e valores de Tipo X W N S descritos a vermelho.

Enviar notificação especificando várias tags

Observe como o cabeçalho HTTP Tags muda quando várias tags são enviadas.

tags = {'sports', 'politics'}
hub.send_windows_notification(wns_payload, tags)

Captura de ecrã de uma consola com detalhes do pedido H T T P e do Formato de Notificação do Service Bus, múltiplas Etiquetas de Notificação do Service Bus e valores de Tipo X W N S destacados a vermelho.

Modelo de notificação

Observe que o cabeçalho HTTP "Format" muda e o conteúdo é enviado como parte do corpo da solicitação HTTP.

Lado do cliente - modelo registado:

var template = @"<toast><visual><binding template=""ToastText01""><text id=""1"">$(greeting_en)</text></binding></visual></toast>";

Lado do servidor - envio da carga:

template_payload = {'greeting_en': 'Hello', 'greeting_fr': 'Salut'}
hub.send_template_notification(template_payload)

Captura de tela de um console com detalhes da solicitação H T T P e os valores Tipo de conteúdo e Formato de notificação do Service Bus descritos em vermelho.

Próximos passos

Este artigo mostrou como criar um cliente Python REST para Hubs de Notificação. A partir daqui, você pode:

Baixe o exemplo completo de wrapper Python REST, que contém todo o código neste artigo.
Continue aprendendo sobre o recurso de marcação de Hubs de Notificação no tutorial Últimas Notícias
Continue aprendendo sobre o recurso Modelos de Hubs de Notificação no tutorial Localizando Notícias

Comentários

Esta página foi útil?

Last updated on 2025-04-02

Partilhar via

Como usar Hubs de Notificação do Python

Interface do cliente

Execução

Analisar a cadeia de conexão

Criar token de segurança

Enviar uma notificação usando a API REST HTTP

Usando a propriedade debug para activar o registo detalhado

Conclua o tutorial

Windows Store e Windows Phone 8.1 (não Silverlight)

Windows Phone 8.0 e 8.1 Silverlight

iOS

Androide

Kindle Fire

Baidu

Exemplos

Ativação da debug propriedade

Notificação de 'toast' transmitida para o Windows

Enviar notificação especificando uma tag (ou expressão de tag)

Enviar notificação especificando várias tags

Modelo de notificação

Próximos passos

Comentários

Recursos adicionais

Ativação da `debug` propriedade