firebase_admin.messaging module

Firebase Cloud Messaging module.

Exceptions

QuotaExceededError exception firebase_admin.messaging.QuotaExceededError(message, cause=None, http_response=None)
Bases: firebase_admin.exceptions.ResourceExhaustedError Sending limit exceeded for the message target.

SenderIdMismatchError exception firebase_admin.messaging.SenderIdMismatchError(message, cause=None, http_response=None)
Bases: firebase_admin.exceptions.PermissionDeniedError The authenticated sender ID is different from the sender ID for the registration token.

ThirdPartyAuthError exception firebase_admin.messaging.ThirdPartyAuthError(message, cause=None, http_response=None)
Bases: firebase_admin.exceptions.UnauthenticatedError APNs certificate or web push auth key was invalid or missing.

UnregisteredError exception firebase_admin.messaging.UnregisteredError(message, cause=None, http_response=None)
Bases: firebase_admin.exceptions.NotFoundError App instance was unregistered from FCM. This usually means that the token used is no longer valid and a new one must be used.

Classes

AndroidConfig class firebase_admin.messaging.AndroidConfig(collapse_key=None, priority=None, ttl=None, restricted_package_name=None, data=None, notification=None, fcm_options=None)

Bases: object Android-specific options that can be included in a message. Parameters: collapse_key – Collapse key string for the message (optional). This is an identifier for a group of messages that can be collapsed, so that only the last message is sent when delivery can be resumed. A maximum of 4 different collapse keys may be active at a given time. priority – Priority of the message (optional). Must be one of high or normal. ttl – The time-to-live duration of the message (optional). This can be specified as a numeric seconds value or a datetime.timedelta instance. restricted_package_name – The package name of the application where the registration tokens must match in order to receive the message (optional). data – A dictionary of data fields (optional). All keys and values in the dictionary must be strings. When specified, overrides any data fields set via Message.data. notification – A messaging.AndroidNotification to be included in the message (optional). fcm_options – A messaging.AndroidFCMOptions to be included in the message (optional).

AndroidFCMOptions class firebase_admin.messaging.AndroidFCMOptions(analytics_label=None)
Bases: object Options for features provided by the FCM SDK for Android. Parameters: analytics_label – contains additional options for features provided by the FCM Android SDK (optional).

AndroidNotification class firebase_admin.messaging.AndroidNotification(title=None, body=None, icon=None, color=None, sound=None, tag=None, click_action=None, body_loc_key=None, body_loc_args=None, title_loc_key=None, title_loc_args=None, channel_id=None, image=None, ticker=None, sticky=None, event_timestamp=None, local_only=None, priority=None, vibrate_timings_millis=None, default_vibrate_timings=None, default_sound=None, light_settings=None, default_light_settings=None, visibility=None, notification_count=None)

Bases: object Android-specific notification parameters. Parameters: title – Title of the notification (optional). If specified, overrides the title set via messaging.Notification. body – Body of the notification (optional). If specified, overrides the body set via messaging.Notification. icon – Icon of the notification (optional). color – Color of the notification icon expressed in #rrggbb form (optional). sound – Sound to be played when the device receives the notification (optional). This is usually the file name of the sound resource. tag – Tag of the notification (optional). This is an identifier used to replace existing notifications in the notification drawer. If not specified, each request creates a new notification. click_action – The action associated with a user click on the notification (optional). If specified, an activity with a matching intent filter is launched when a user clicks on the notification. body_loc_key – Key of the body string in the app’s string resources to use to localize the body text (optional). body_loc_args – A list of resource keys that will be used in place of the format specifiers in body_loc_key (optional). title_loc_key – Key of the title string in the app’s string resources to use to localize the title text (optional). title_loc_args – A list of resource keys that will be used in place of the format specifiers in title_loc_key (optional). channel_id – channel_id of the notification (optional). image – Image url of the notification (optional). ticker – Sets the ticker text, which is sent to accessibility services. Prior to API level 21 (Lollipop), sets the text that is displayed in the status bar when the notification first arrives (optional). sticky – When set to false or unset, the notification is automatically dismissed when the user clicks it in the panel. When set to True, the notification persists even when the user clicks it (optional). event_timestamp – For notifications that inform users about events with an absolute time reference, sets the time that the event in the notification occurred as a datetime.datetime instance. Notifications in the panel are sorted by this time (optional). local_only – Sets whether or not this notification is relevant only to the current device. Some notifications can be bridged to other devices for remote display, such as a Wear OS watch. This hint can be set to recommend this notification not be bridged (optional). See Wear OS guides: https://developer.android.com/training/wearables/notifications/bridger#existing-method-of-preventing-bridging priority – Sets the relative priority for this notification. Low-priority notifications may be hidden from the user in certain situations. Note this priority differs from AndroidMessagePriority. This priority is processed by the client after the message has been delivered. Whereas AndroidMessagePriority is an FCM concept that controls when the message is delivered (optional). Must be one of default, min, low, high, max or normal. vibrate_timings_millis – Sets the vibration pattern to use. Pass in an array of milliseconds to turn the vibrator on or off. The first value indicates the duration to wait before turning the vibrator on. The next value indicates the duration to keep the vibrator on. Subsequent values alternate between duration to turn the vibrator off and to turn the vibrator on. If vibrate_timings is set and default_vibrate_timings is set to True, the default value is used instead of the user-specified vibrate_timings. default_vibrate_timings – If set to True, use the Android framework’s default vibrate pattern for the notification (optional). Default values are specified in config.xml https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml. If default_vibrate_timings is set to True and vibrate_timings is also set, the default value is used instead of the user-specified vibrate_timings. default_sound – If set to True, use the Android framework’s default sound for the notification (optional). Default values are specified in config.xml https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml light_settings – Settings to control the notification’s LED blinking rate and color if LED is available on the device. The total blinking time is controlled by the OS (optional). default_light_settings – If set to True, use the Android framework’s default LED light settings for the notification. Default values are specified in config.xml https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml. If default_light_settings is set to True and light_settings is also set, the user-specified light_settings is used instead of the default value. visibility – Sets the visibility of the notification. Must be either private, public, or secret. If unspecified, default to private. notification_count – Sets the number of items this notification represents. May be displayed as a badge count for Launchers that support badging. See NotificationBadge https://developer.android.com/training/notify-user/badges. For example, this might be useful if you’re using just one notification to represent multiple new messages but you want the count here to represent the number of total new messages. If zero or unspecified, systems that support badging use the default, which is to increment a number displayed on the long-press menu each time a new notification arrives.

APNSConfig class firebase_admin.messaging.APNSConfig(headers=None, payload=None, fcm_options=None)
Bases: object APNS-specific options that can be included in a message. Refer to APNS Documentation for more information. Parameters: headers – A dictionary of headers (optional). payload – A messaging.APNSPayload to be included in the message (optional). fcm_options – A messaging.APNSFCMOptions instance to be included in the message (optional).

APNSFCMOptions class firebase_admin.messaging.APNSFCMOptions(analytics_label=None, image=None)
Bases: object Options for features provided by the FCM SDK for iOS. Parameters: analytics_label – contains additional options for features provided by the FCM iOS SDK (optional). image – contains the URL of an image that is going to be displayed in a notification (optional).

APNSPayload class firebase_admin.messaging.APNSPayload(aps, **kwargs)
Bases: object Payload of an APNS message. Parameters: aps – A messaging.Aps instance to be included in the payload. kwargs – Arbitrary keyword arguments to be included as custom fields in the payload (optional).

Aps class firebase_admin.messaging.Aps(alert=None, badge=None, sound=None, content_available=None, category=None, thread_id=None, mutable_content=None, custom_data=None)

Bases: object Aps dictionary to be included in an APNS payload. Parameters: alert – A string or a messaging.ApsAlert instance (optional). badge – A number representing the badge to be displayed with the message (optional). sound – Name of the sound file to be played with the message or a messaging.CriticalSound instance (optional). content_available – A boolean indicating whether to configure a background update notification (optional). category – String identifier representing the message type (optional). thread_id – An app-specific string identifier for grouping messages (optional). mutable_content – A boolean indicating whether to support mutating notifications at the client using app extensions (optional). custom_data – A dict of custom key-value pairs to be included in the Aps dictionary (optional).

ApsAlert class firebase_admin.messaging.ApsAlert(title=None, subtitle=None, body=None, loc_key=None, loc_args=None, title_loc_key=None, title_loc_args=None, action_loc_key=None, launch_image=None, custom_data=None)

Bases: object An alert that can be included in messaging.Aps. Parameters: title – Title of the alert (optional). If specified, overrides the title set via messaging.Notification. subtitle – Subtitle of the alert (optional). body – Body of the alert (optional). If specified, overrides the body set via messaging.Notification. loc_key – Key of the body string in the app’s string resources to use to localize the body text (optional). loc_args – A list of resource keys that will be used in place of the format specifiers in loc_key (optional). title_loc_key – Key of the title string in the app’s string resources to use to localize the title text (optional). title_loc_args – A list of resource keys that will be used in place of the format specifiers in title_loc_key (optional). action_loc_key – Key of the text in the app’s string resources to use to localize the action button text (optional). launch_image – Image for the notification action (optional). custom_data – A dict of custom key-value pairs to be included in the ApsAlert dictionary (optional)

BatchResponse class firebase_admin.messaging.BatchResponse(responses)
Bases: object The response received from a batch request to the FCM API. failure_count responses A list of messaging.SendResponse objects (possibly empty). success_count

CriticalSound class firebase_admin.messaging.CriticalSound(name, critical=None, volume=None)
Bases: object Critical alert sound configuration that can be included in messaging.Aps.