skip to navigation
skip to content

Not Logged In

python-gcm 0.1.3

Python client for Google Cloud Messaging for Android (GCM)

Latest Version: 0.1.5

python-gcm
======================
[![Build Status]https://secure.travis-ci.org/geeknam/python-gcm.png?branch=master]http://travis-ci.org/geeknam/python-gcm

Python client for Google Cloud Messaging for Android (GCM)

Usage
------------
RTFM [here]http://developer.android.com/guide/google/gcm/gcm.html

Basic
```python
gcm = GCM(API_KEY)
data = {'param1': 'value1', 'param2': 'value2'}

# Plaintext request
gcm.plaintext_request(registration_id=reg_id, data=data)

# JSON request
reg_ids = ['12', '34', '69']
response = gcm.json_request(registration_ids=reg_ids, data=data)

# Extra arguments
res = gcm.json_request(
registration_ids=reg_ids, data=data,
collapse_key='uptoyou', delay_while_idle=True, time_to_live=3600
)
```

Error handling
```python
# Plaintext request
reg_id = '12345'
try:
canonical_id = gcm.plaintext_request(registration_id=reg_id, data=data)
if canonical_id:
# Repace reg_id with canonical_id in your database
entry = entity.filter(registration_id=reg_id)
entry.registration_id = canonical_id
entry.save()
except GCMNotRegisteredException:
# Remove this reg_id from database
entity.filter(registration_id=reg_id).delete()
except GCMUnavailableException:
# Resent the message

# JSON request
reg_ids = ['12', '34', '69']
response = gcm.json_request(registration_ids=reg_ids, data=data)

# Handling errors
if 'errors' in response:
for error, reg_ids in response.items():
# Check for errors and act accordingly
if error is 'NotRegistered':
# Remove reg_ids from database
for reg_id in reg_ids:
entity.filter(registration_id=reg_id).delete()
if 'canonical' in response:
for canonical_id, reg_id in response.items():
# Repace reg_id with canonical_id in your database
entry = entity.filter(registration_id=reg_id)
entry.registration_id = canonical_id
entry.save()
```

Exceptions
------------
Read more on response errors [here]http://developer.android.com/guide/google/gcm/gcm.html#success


* GCMMalformedJsonException
* GCMConnectionException
* GCMAuthenticationException
* GCMTooManyRegIdsException
* GCMNoCollapseKeyException
* GCMInvalidTtlException
* GCMMissingRegistrationException
* GCMMismatchSenderIdException
* GCMNotRegisteredException
* GCMMessageTooBigException
* GCMInvalidRegistrationException
* GCMUnavailableException

![Gotta catch them all]http://t.qkme.me/35gjhs.jpg  
File Type Py Version Uploaded on Size
python-gcm-0.1.3.macosx-10.6-intel.exe (md5) MS Windows installer any 2012-07-31 66KB
python-gcm-0.1.3.tar.gz (md5) Source 2012-07-31 4KB
  • Downloads (All Versions):
  • 207 downloads in the last day
  • 1814 downloads in the last week
  • 5871 downloads in the last month