README.md

go-fcm

Firebase Cloud Messaging ( FCM ) Library using golang ( Go )

This library uses HTTP/JSON Firebase Cloud Messaging connection server protocol

features

• send messages to a topic
• send messages to a device list
• message can be a notification or data payload
• supports notification condition

in progress

• retry
• instance id features

Usage

go get github.com/NaySoftware/go-fcm

Notes

serverKey is the server key by Firebase Cloud Messaging

Server Key can be found in:

1. Firebase project settings
2. Cloud Messaging
3. then copy the server key

Examples

Send to A topic

package main

import (
	"fmt"
  "github.com/NaySoftware/go-fcm"
)

const (
	 serverKey = "YOUR-KEY"
   topic = "/topics/someTopic"
)

func main() {

	data := map[string]string{
		"msg": "Hello World1",
		"sum": "Happy Day",
	}

	c := fcm.NewFcmClient(serverKey)
	c.NewFcmMsgTo(topic, data)


	status, err := c.Send(1)  // send once - no retry
	// [retries n > 1]

	if err == nil {
    status.PrintResults()
	} else {
		fmt.Println(err)
	}

}

Send to a list of Devices (tokens)

package main

import (
	"fmt"
  "github.com/NaySoftware/go-fcm"
)

const (
	 serverKey = "YOUR-KEY"
)

func main() {

	data := map[string]string{
		"msg": "Hello World1",
		"sum": "Happy Day",
	}

  ids := []string{
      "token1",
  }


  xds := []string{
      "token5",
      "token6",
      "token7",
  }

	c := fcm.NewFcmClient(serverKey)
  c.NewFcmRegIdsMsg(ids, data)
  c.AppendDevices(xds)

	status, err := c.Send(1) // send once - no retry
	// [retries n > 1]

	if err == nil {
    status.PrintResults()
	} else {
		fmt.Println(err)
	}

}