Batch uses Firebase Cloud Messaging (FCM) APIs to deliver push notifications to Android devices. This service has undergone some protocol evolutions and the FCM APIs are now considered “legacy” by Google to make way for HTTP V1 APIs.
This evolution implies changes in the authentication methods used to call the APIs moving from an API-Key-based authentication to OAuth. Among other things, this translates into a different credential management approach from a Firebase project level to a Service Account level.
Batch now fully supports this new protocol and the article below describes how you can update your Android settings on Batch to migrate your apps onto the new APIs.
Who does this apply to?
You are concerned by this migration if the following conditions are met:
You use Batch to send push notifications to your mobile app users on Android.
You use legacy FCM API credentials (FCM Sender ID and FCM Server API Key) in your Android app settings on Batch’s dashboard.
Migrate to HTTP V1 API
Before completing this setup, please note that:
This does not require an update of your Android mobile apps.
The migration applies automatically to all your app users regardless of the app version they are on.
First, you need to get a new set of credentials from your Google Cloud Service Account for each Android app you manage on Batch.
Then, you need to update each app’s credentials on the Settings tab of Batch’s dashboard. You will find a step-by-step guide on how to do so here, in the documentation:
Once your new credentials are tested and submitted, the switch is immediate and will have no impact on ongoing push delivery.
Multiple Firebase projects
If you have multiple Sender IDs declared on Batch’s dashboard for your Android app, you will be able to upload multiple Service Account Keys as well. This may be the case if you changed Firebase projects at some point in your app and want to be able to send push notifications to both users who have a newer version or an older version of the app.