Python package for using the Urban Airship API
urbanairship3 is a Python library for using the Urban Airship web service API for push notifications and rich app pages. This is a fork of original urbanairship with Python 3 support.
Why fork? Primarily for publishing Python 3 compatible version at PyPi for easier install.
pip install urbanairship3
As of version 0.6, Python 2.6+ or 3.3+ is required.
Version 0.6 is a major upgrade, focusing on support for the new version 3 push API. There has also been a major reorganization of the codebase.
- device token registration
- basic push
- registering and pushing with tags
- feedback service
- device token deactivation (deregistration)
- device token listing
- rich push
- scheduled notifications
Simple iOS Push
>>> import urbanairship as ua >>> airship = ua.Airship('application_key','master_secret') >>> push = airship.create_push() >>> push.audience = ua.or_(ua.alias('adam'), ua.device_token('some_token')) >>> push.notification = ua.notification(alert='Hello') >>> push.device_types = ua.all_ >>> push.send()
Broadcast to iOS, Android, and BlackBerry devices
>>> push = airship.create_push() >>> push.audience = ua.all_ >>> push.notification = ua.notification( ... ios=ua.ios(alert='Hello iOS'), ... android=ua.android(alert='Hello Android'), ... blackberry=ua.blackberry(alert='Hello BlackBerry')) >>> push.device_types = ua.device_types('ios', 'android', 'blackberry') >>> push.send()
Sending a rich app page to a single iOS device
>>> import urbanairship >>> airship = urbanairship.Airship('application_key','master_secret') >>> push = airship.create_push() >>> push.audience = ua.device_token('some_token') >>> push.notification = ua.notification(alert='Hello') >>> push.device_types = ua.device_types('ios') >>> push.message = ua.message( ... "Hello, Rich Push User", ... "<html><h1>Hello!</h1><p>Goodbye.</p></html>") >>> push.send()
The best place to ask questions is our support site: http://support.urbanairship.com/
- 0.1 Initial release
- 0.2 Added tags, broadcast, feedback
- 0.3 Added deregister, device token list, other minor improvements
- 0.4 Added batch push
- 0.5 Added Android, Blackberry, Rich Push, and scheduled notifications
- 0.6 Major refactoring, support for push api v3