PrincessinConsuela / python-fcm

Python client for Google Firebase Cloud Messaging (FCM)

python-fcm

Python client for Google Cloud Messaging for Android (FCM)

Installation

pip install git+https://github.com/lostdragon/python-fcm.git

Features

• Supports multicast message
• Resend messages using exponential back-off
• Proxy support
• Easily handle errors
• Uses requests from version > 0.2
• Topic Messaging
• TCP connection pooling and Keep-Alive when passing an explict requests.Session object to the used FCM request call
• Topic Manager

Usage

Read about Google Firebase Cloud Messaging

from fcm import FCM

fcm = FCM(API_KEY)
data = {'param1': 'value1', 'param2': 'value2'}

# Downstream message using JSON request
reg_ids = ['token1', 'token2', 'token3']
response = fcm.json_request(registration_ids=reg_ids, data=data)

# Downstream message using JSON request with extra arguments
res = fcm.json_request(
    registration_ids=reg_ids, data=data,
    collapse_key='uptoyou', delay_while_idle=True, time_to_live=3600
)

# Topic Messaging
topic = 'topic name'
fcm.send_topic_message(topic=topic, data=data)

See examples directory for more usage details, including error handling.

Contributing

See CONTRIBUTING.md

Licensing

See LICENSE