Введение

Эта простая схема описывает работу с C2DM сервисом. Ваше Android приложение (APP) регистрируется в C2DM сервисе (например при запуске) и отправляет полученный регистрационный код серверу (APP SERVER).

Теперь сервер (APP SERVER) используя полученный регистрационный код и специальный токен может сформировать специальный HTTP-запрос сервису C2DM, который в свою очередь отправит Push сообщение устройству на котором запущена ваша программа.

Подготовка к работе

Для начала необходимо зарегистрировать ваше приложение в C2DM по адресу: http://code.google.com/android/c2dm/signup.html

Вам потребуется указать ваш действующий Google-аккаунт и доменное имя вашего приложения. Вы должны получить на почту письмо с подтверждением. После регистрации вашему приложению будет добавлена возможность получать Push-уведомления с учетом действующих в C2DM квот.

Получение токена для сервера

Получение авторизационного токена для сервера подробно рассматривается в документации: ClientLogin for Installed Applications. Резюмируя данный документ: для получения токена, нам надо сформировать POST запрос со следующими параметрами:

Пример запроса:

POST /accounts/ClientLogin HTTP/1.0
Content-type: application/x-www-form-urlencoded

accountType=HOSTED_OR_GOOGLE&Email;=jondoe@gmail.com&Passwd;=north23AZ&service;=cl&source=Gulp-CalGulp-1.05

Сделать это можно например используя Curl (Замените ACCOUNT, PASSWORD, SOURCE на ваши реквизиты):

curl -X POST https://www.google.com/accounts/ClientLogin -d Email=ACCOUNT -d Passwd=PASSWORD -d source=SOURCE -d accountType=HOSTED_OR_GOOGLE -d service=ac2dm

В третьей строке Auth=... и будет ваш искомый токен. Сохраните его в надежном месте.

Отправка Push уведомлений

Отправка уведомлений описана в разделе: How the Application Server Sends Messages. Поддерживаются следующие параметры:

Этих данных достаточно, чтобы написать простой код (для работы с HTTP я использую замечательную библиотеку Requests):

import requests

from .settings import C2DM_URL, C2DM_TOKEN


class AndroidNotifyError(Exception):
    pass


def send_notify(registration_id, collapse_key="default", delay_while_idle=True, **payloads):
    headers = dict(Authorization='GoogleLogin auth=%s' % C2DM_TOKEN)
    data = {'registration_id': registration_id,
            'collapse_key': collapse_key,
            'delay_while_idle': True}

    for(k, v) in payloads.iteritems():
        data["data.%s" % k] = v

    response = requests.post(C2DM_URL, headers=headers, data=data, verify=False)

    if response.ok and 'Error' in response.content:
        _, error_type = response.content.split('=', 1)
        raise AndroidNotifyError(error_type)

    elif response.status_code == 401:
        raise AndroidNotifyError('ClientLogin invalid.')

    elif response.status_code == 503:
        raise AndroidNotifyError('Service temporarily unavailable.')

    return response  #**

Теперь отправлять нотификации можно так:

send_notify('device-registration-id-here', message='test', sound='test')

Интеграция с Django

При интеграции с Django проектом стоит подумать об асинхронности запросов в C2DM.

Асинхронность достигается использованием Celery.

from celery.decorators import task
from android import send_notify

@task(ignore_result=True, max_retries=2, default_retry_delay=10, priority=1)
def _async_android_push(token, payloads, **kwargs):
    return send_notify(token, **payloads)


def send_async_android_notify(token, **payloads):
    return _async_android_push.apply_async(args=(token, payloads))  # Fix rst**

Мысли на будущее: отключение недействительных устройств, массовые рассылки и проверка доставки.