therahulprasad / go-fcm

Google Cloud Messaging for application servers implemented using the Go programming language.

FCM

This library can be used to send FCM messages (notifications) to Android and iOS clients which are using Firebase Notification Library.
It is backward compatible with GCM. You can transparently use GCM token instead of FCM token to send Notification to clients which are using old Google Cloud Messaging library.

Getting Started

To install go-fcm, use go get:

go get github.com/therahulprasad/go-fcm

Import gcm with the following:

import "github.com/therahulprasad/go-fcm"

Sample Usage

Here is a quick sample illustrating how to send a message to the GCM server:

package main

import (
	"fmt"
	"net/http"

	"github.com/therahulprasad/go-fcm"
)

func main() {
	// Create the message to be sent.
	data := map[string]interface{}{"score": "5x1", "time": "15:10"}
	regIDs := []string{"4", "8", "15", "16", "23", "42"}
	msg := gcm.NewMessage(data, regIDs...)

	// Create a Sender to send the message.
	sender := &gcm.Sender{ApiKey: "sample_api_key"}

	// Send the message and receive the response after at most two retries.
	response, err := sender.Send(msg, 2)
	if err != nil {
		fmt.Println("Failed to send message:", err)
		return
	}

	/* ... */
}

Note for Google AppEngine users

If your application server runs on Google AppEngine, you must import the appengine/urlfetch package and create the Sender as follows:

package sample

import (
	"appengine"
	"appengine/urlfetch"

	"github.com/therahulprasad/go-fcm"
)

func handler(w http.ResponseWriter, r *http.Request) {
	c := appengine.NewContext(r)
	client := urlfetch.Client(c)
	sender := &gcm.Sender{ApiKey: "sample_api_key", Http: client}

	/* ... */
}