Xây dựng máy chủ ứng dụng gửi yêu cầu

Bằng cách sử dụng SDK quản trị Firebase hoặc các giao thức máy chủ ứng dụng FCM, bạn có thể tạo các yêu cầu tin nhắn và gửi chúng đến các loại mục tiêu sau:

  • Tên chủ đề
  • Tình trạng
  • Mã thông báo đăng ký thiết bị
  • Tên nhóm thiết bị (giao thức cũ và SDK quản trị Firebase chỉ dành cho Node.js)

Bạn có thể gửi tin nhắn có khối lượng thông báo được tạo thành từ các trường được xác định trước, khối lượng dữ liệu của các trường do người dùng xác định của riêng bạn hoặc tin nhắn chứa cả hai loại khối lượng này. Xem Các loại tin nhắn để biết thêm thông tin.

Ví dụ trong trang này cho biết cách gửi tin nhắn thông báo bằng SDK quản trị Firebase (hỗ trợ Node , Java , Python , C #Go ) và giao thức HTTP v1 . Ngoài ra còn có hướng dẫn để gửi tin nhắn qua các giao thức HTTP và XMPP kế thừa .

Gửi tin nhắn đến các thiết bị cụ thể

Để gửi đến một thiết bị cụ thể, hãy chuyển mã thông báo đăng ký của thiết bị như hình minh họa. Xem thông tin thiết lập ứng dụng khách cho nền tảng của bạn để tìm hiểu thêm về mã thông báo đăng ký.

Node.js

// This registration token comes from the client FCM SDKs.
const registrationToken = 'YOUR_REGISTRATION_TOKEN';

const message = {
  data: {
    score: '850',
    time: '2:45'
  },
  token: registrationToken
};

// Send a message to the device corresponding to the provided
// registration token.
getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Java

// This registration token comes from the client FCM SDKs.
String registrationToken = "YOUR_REGISTRATION_TOKEN";

// See documentation on defining a message payload.
Message message = Message.builder()
    .putData("score", "850")
    .putData("time", "2:45")
    .setToken(registrationToken)
    .build();

// Send a message to the device corresponding to the provided
// registration token.
String response = FirebaseMessaging.getInstance().send(message);
// Response is a message ID string.
System.out.println("Successfully sent message: " + response);

Python

# This registration token comes from the client FCM SDKs.
registration_token = 'YOUR_REGISTRATION_TOKEN'

# See documentation on defining a message payload.
message = messaging.Message(
    data={
        'score': '850',
        'time': '2:45',
    },
    token=registration_token,
)

# Send a message to the device corresponding to the provided
# registration token.
response = messaging.send(message)
# Response is a message ID string.
print('Successfully sent message:', response)

Đi

// Obtain a messaging.Client from the App.
ctx := context.Background()
client, err := app.Messaging(ctx)
if err != nil {
	log.Fatalf("error getting Messaging client: %v\n", err)
}

// This registration token comes from the client FCM SDKs.
registrationToken := "YOUR_REGISTRATION_TOKEN"

// See documentation on defining a message payload.
message := &messaging.Message{
	Data: map[string]string{
		"score": "850",
		"time":  "2:45",
	},
	Token: registrationToken,
}

// Send a message to the device corresponding to the provided
// registration token.
response, err := client.Send(ctx, message)
if err != nil {
	log.Fatalln(err)
}
// Response is a message ID string.
fmt.Println("Successfully sent message:", response)

C#

// This registration token comes from the client FCM SDKs.
var registrationToken = "YOUR_REGISTRATION_TOKEN";

// See documentation on defining a message payload.
var message = new Message()
{
    Data = new Dictionary<string, string>()
    {
        { "score", "850" },
        { "time", "2:45" },
    },
    Token = registrationToken,
};

// Send a message to the device corresponding to the provided
// registration token.
string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
// Response is a message ID string.
Console.WriteLine("Successfully sent message: " + response);

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
   "message":{
      "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
      "notification":{
        "body":"This is an FCM notification message!",
        "title":"FCM Message"
      }
   }
}

lệnh cURL:

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message":{
   "notification":{
     "title":"FCM Message",
     "body":"This is an FCM Message"
   },
   "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
}}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send

Khi thành công, mỗi phương thức gửi trả về một ID tin nhắn. SDK quản trị Firebase trả về chuỗi ID ở định dạng projects/{project_id}/messages/{message_id} . Phản hồi của giao thức HTTP là một khóa JSON duy nhất:

    {
      "name":"projects/myproject-b5ae1/messages/0:1500415314455276%31bd1c9631bd1c96"
    }

Gửi tin nhắn đến nhiều thiết bị

API REST và API FCM dành cho quản trị viên cho phép bạn gửi nhiều thư tới danh sách các mã thông báo đăng ký thiết bị. Bạn có thể chỉ định tối đa 500 mã thông báo đăng ký thiết bị cho mỗi lần gọi.

Node.js

// Create a list containing up to 500 registration tokens.
// These registration tokens come from the client FCM SDKs.
const registrationTokens = [
  'YOUR_REGISTRATION_TOKEN_1',
  // …
  'YOUR_REGISTRATION_TOKEN_N',
];

const message = {
  data: {score: '850', time: '2:45'},
  tokens: registrationTokens,
};

getMessaging().sendMulticast(message)
  .then((response) => {
    console.log(response.successCount + ' messages were sent successfully');
  });

Java

// Create a list containing up to 500 registration tokens.
// These registration tokens come from the client FCM SDKs.
List<String> registrationTokens = Arrays.asList(
    "YOUR_REGISTRATION_TOKEN_1",
    // ...
    "YOUR_REGISTRATION_TOKEN_n"
);

MulticastMessage message = MulticastMessage.builder()
    .putData("score", "850")
    .putData("time", "2:45")
    .addAllTokens(registrationTokens)
    .build();
BatchResponse response = FirebaseMessaging.getInstance().sendMulticast(message);
// See the BatchResponse reference documentation
// for the contents of response.
System.out.println(response.getSuccessCount() + " messages were sent successfully");

Python

# Create a list containing up to 500 registration tokens.
# These registration tokens come from the client FCM SDKs.
registration_tokens = [
    'YOUR_REGISTRATION_TOKEN_1',
    # ...
    'YOUR_REGISTRATION_TOKEN_N',
]

message = messaging.MulticastMessage(
    data={'score': '850', 'time': '2:45'},
    tokens=registration_tokens,
)
response = messaging.send_multicast(message)
# See the BatchResponse reference documentation
# for the contents of response.
print('{0} messages were sent successfully'.format(response.success_count))

Đi

// Create a list containing up to 500 registration tokens.
// This registration tokens come from the client FCM SDKs.
registrationTokens := []string{
	"YOUR_REGISTRATION_TOKEN_1",
	// ...
	"YOUR_REGISTRATION_TOKEN_n",
}
message := &messaging.MulticastMessage{
	Data: map[string]string{
		"score": "850",
		"time":  "2:45",
	},
	Tokens: registrationTokens,
}

br, err := client.SendMulticast(context.Background(), message)
if err != nil {
	log.Fatalln(err)
}

// See the BatchResponse reference documentation
// for the contents of response.
fmt.Printf("%d messages were sent successfully\n", br.SuccessCount)

C#

// Create a list containing up to 500 registration tokens.
// These registration tokens come from the client FCM SDKs.
var registrationTokens = new List<string>()
{
    "YOUR_REGISTRATION_TOKEN_1",
    // ...
    "YOUR_REGISTRATION_TOKEN_n",
};
var message = new MulticastMessage()
{
    Tokens = registrationTokens,
    Data = new Dictionary<string, string>()
    {
        { "score", "850" },
        { "time", "2:45" },
    },
};

var response = await FirebaseMessaging.DefaultInstance.SendMulticastAsync(message);
// See the BatchResponse reference documentation
// for the contents of response.
Console.WriteLine($"{response.SuccessCount} messages were sent successfully");

LÊN ĐỈNH

Tạo một yêu cầu hàng loạt HTTP:

--subrequest_boundary
Content-Type: application/http
Content-Transfer-Encoding: binary
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

POST /v1/projects/myproject-b5ae1/messages:send
Content-Type: application/json
accept: application/json

{
  "message":{
     "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
     "notification":{
       "title":"FCM Message",
       "body":"This is an FCM notification message!"
     }
  }
}

...

--subrequest_boundary
Content-Type: application/http
Content-Transfer-Encoding: binary
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

POST /v1/projects/myproject-b5ae1/messages:send
Content-Type: application/json
accept: application/json

{
  "message":{
     "token":"cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
     "notification":{
       "title":"FCM Message",
       "body":"This is an FCM notification message!"
     }
  }
}
--subrequest_boundary--

Lưu yêu cầu vào một tệp (trong ví dụ này là batch_request.txt). Sau đó, sử dụng lệnh cURL:

curl --data-binary @batch_request.txt -H 'Content-Type: multipart/mixed; boundary="subrequest_boundary"' https://fcm.googleapis.com/batch

Đối với SDK quản trị của Firebase, thao tác này sử dụng API sendAll() , như được minh họa trong các ví dụ. Giá trị trả về là một BatchResponse có danh sách phản hồi tương ứng với thứ tự của các mã thông báo đầu vào. Điều này rất hữu ích khi bạn muốn kiểm tra mã thông báo nào dẫn đến lỗi.

Node.js

// These registration tokens come from the client FCM SDKs.
const registrationTokens = [
  'YOUR_REGISTRATION_TOKEN_1',
  // …
  'YOUR_REGISTRATION_TOKEN_N',
];

const message = {
  data: {score: '850', time: '2:45'},
  tokens: registrationTokens,
};

getMessaging().sendMulticast(message)
  .then((response) => {
    if (response.failureCount > 0) {
      const failedTokens = [];
      response.responses.forEach((resp, idx) => {
        if (!resp.success) {
          failedTokens.push(registrationTokens[idx]);
        }
      });
      console.log('List of tokens that caused failures: ' + failedTokens);
    }
  });

Java

// These registration tokens come from the client FCM SDKs.
List<String> registrationTokens = Arrays.asList(
    "YOUR_REGISTRATION_TOKEN_1",
    // ...
    "YOUR_REGISTRATION_TOKEN_n"
);

MulticastMessage message = MulticastMessage.builder()
    .putData("score", "850")
    .putData("time", "2:45")
    .addAllTokens(registrationTokens)
    .build();
BatchResponse response = FirebaseMessaging.getInstance().sendMulticast(message);
if (response.getFailureCount() > 0) {
  List<SendResponse> responses = response.getResponses();
  List<String> failedTokens = new ArrayList<>();
  for (int i = 0; i < responses.size(); i++) {
    if (!responses.get(i).isSuccessful()) {
      // The order of responses corresponds to the order of the registration tokens.
      failedTokens.add(registrationTokens.get(i));
    }
  }

  System.out.println("List of tokens that caused failures: " + failedTokens);
}

Python

# These registration tokens come from the client FCM SDKs.
registration_tokens = [
    'YOUR_REGISTRATION_TOKEN_1',
    # ...
    'YOUR_REGISTRATION_TOKEN_N',
]

message = messaging.MulticastMessage(
    data={'score': '850', 'time': '2:45'},
    tokens=registration_tokens,
)
response = messaging.send_multicast(message)
if response.failure_count > 0:
    responses = response.responses
    failed_tokens = []
    for idx, resp in enumerate(responses):
        if not resp.success:
            # The order of responses corresponds to the order of the registration tokens.
            failed_tokens.append(registration_tokens[idx])
    print('List of tokens that caused failures: {0}'.format(failed_tokens))

Đi

// Create a list containing up to 500 registration tokens.
// This registration tokens come from the client FCM SDKs.
registrationTokens := []string{
	"YOUR_REGISTRATION_TOKEN_1",
	// ...
	"YOUR_REGISTRATION_TOKEN_n",
}
message := &messaging.MulticastMessage{
	Data: map[string]string{
		"score": "850",
		"time":  "2:45",
	},
	Tokens: registrationTokens,
}

br, err := client.SendMulticast(context.Background(), message)
if err != nil {
	log.Fatalln(err)
}

if br.FailureCount > 0 {
	var failedTokens []string
	for idx, resp := range br.Responses {
		if !resp.Success {
			// The order of responses corresponds to the order of the registration tokens.
			failedTokens = append(failedTokens, registrationTokens[idx])
		}
	}

	fmt.Printf("List of tokens that caused failures: %v\n", failedTokens)
}

C#

// These registration tokens come from the client FCM SDKs.
var registrationTokens = new List<string>()
{
    "YOUR_REGISTRATION_TOKEN_1",
    // ...
    "YOUR_REGISTRATION_TOKEN_n",
};
var message = new MulticastMessage()
{
    Tokens = registrationTokens,
    Data = new Dictionary<string, string>()
    {
        { "score", "850" },
        { "time", "2:45" },
    },
};

var response = await FirebaseMessaging.DefaultInstance.SendMulticastAsync(message);
if (response.FailureCount > 0)
{
    var failedTokens = new List<string>();
    for (var i = 0; i < response.Responses.Count; i++)
    {
        if (!response.Responses[i].IsSuccess)
        {
            // The order of responses corresponds to the order of the registration tokens.
            failedTokens.Add(registrationTokens[i]);
        }
    }

    Console.WriteLine($"List of tokens that caused failures: {failedTokens}");
}

LÊN ĐỈNH

Mỗi lần gửi phụ gửi trả về một phản hồi. Các phản hồi được phân tách bằng một chuỗi ranh giới phản hồi bắt đầu bằng --batch_ .

--batch_nDhMX4IzFTDLsCJ3kHH7v_44ua-aJT6q
Content-Type: application/http
Content-ID: response-

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer

{
  "name": "projects/35006771263/messages/0:1570471792141125%43c11b7043c11b70"
}

...

--batch_nDhMX4IzFTDLsCJ3kHH7v_44ua-aJT6q
Content-Type: application/http
Content-ID: response-

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer

{
  "name": "projects/35006771263/messages/0:1570471792141696%43c11b7043c11b70"
}

--batch_nDhMX4IzFTDLsCJ3kHH7v_44ua-aJT6q--

Gửi tin nhắn đến các chủ đề

Sau khi bạn đã tạo chủ đề, bằng cách đăng ký các phiên bản ứng dụng khách cho chủ đề ở phía máy khách hoặc thông qua API máy chủ , bạn có thể gửi tin nhắn đến chủ đề. Nếu đây là lần đầu tiên bạn xây dựng yêu cầu gửi cho FCM, hãy xem hướng dẫn về môi trường máy chủ và FCM của bạn để biết thông tin cơ bản và thiết lập quan trọng.

Trong logic gửi của bạn trên chương trình phụ trợ, hãy chỉ định tên chủ đề mong muốn như được hiển thị:

Node.js

// The topic name can be optionally prefixed with "/topics/".
const topic = 'highScores';

const message = {
  data: {
    score: '850',
    time: '2:45'
  },
  topic: topic
};

// Send a message to devices subscribed to the provided topic.
getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Java

// The topic name can be optionally prefixed with "/topics/".
String topic = "highScores";

// See documentation on defining a message payload.
Message message = Message.builder()
    .putData("score", "850")
    .putData("time", "2:45")
    .setTopic(topic)
    .build();

// Send a message to the devices subscribed to the provided topic.
String response = FirebaseMessaging.getInstance().send(message);
// Response is a message ID string.
System.out.println("Successfully sent message: " + response);

Python

# The topic name can be optionally prefixed with "/topics/".
topic = 'highScores'

# See documentation on defining a message payload.
message = messaging.Message(
    data={
        'score': '850',
        'time': '2:45',
    },
    topic=topic,
)

# Send a message to the devices subscribed to the provided topic.
response = messaging.send(message)
# Response is a message ID string.
print('Successfully sent message:', response)

Đi

// The topic name can be optionally prefixed with "/topics/".
topic := "highScores"

// See documentation on defining a message payload.
message := &messaging.Message{
	Data: map[string]string{
		"score": "850",
		"time":  "2:45",
	},
	Topic: topic,
}

// Send a message to the devices subscribed to the provided topic.
response, err := client.Send(ctx, message)
if err != nil {
	log.Fatalln(err)
}
// Response is a message ID string.
fmt.Println("Successfully sent message:", response)

C#

// The topic name can be optionally prefixed with "/topics/".
var topic = "highScores";

// See documentation on defining a message payload.
var message = new Message()
{
    Data = new Dictionary<string, string>()
    {
        { "score", "850" },
        { "time", "2:45" },
    },
    Topic = topic,
};

// Send a message to the devices subscribed to the provided topic.
string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
// Response is a message ID string.
Console.WriteLine("Successfully sent message: " + response);

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message":{
    "topic" : "foo-bar",
    "notification" : {
      "body" : "This is a Firebase Cloud Messaging Topic Message!",
      "title" : "FCM Message"
      }
   }
}

lệnh cURL:

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
  "message": {
    "topic" : "foo-bar",
    "notification": {
      "body": "This is a Firebase Cloud Messaging Topic Message!",
      "title": "FCM Message"
    }
  }
}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Để gửi tin nhắn đến một tổ hợp các chủ đề, hãy chỉ định một điều kiện , đó là một biểu thức boolean chỉ định các chủ đề đích. Ví dụ: điều kiện sau sẽ gửi tin nhắn đến các thiết bị đã đăng ký TopicATopicB hoặc TopicC :

"'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics)"

Đầu tiên FCM đánh giá bất kỳ điều kiện nào trong dấu ngoặc đơn, sau đó đánh giá biểu thức từ trái sang phải. Trong biểu thức trên, người dùng đã đăng ký bất kỳ chủ đề nào sẽ không nhận được thông báo. Tương tự như vậy, người dùng không đăng ký TopicA sẽ không nhận được thông báo. Những kết hợp này nhận được nó:

  • TopicATopicB
  • TopicATopicC

Bạn có thể bao gồm tối đa năm chủ đề trong biểu thức điều kiện của mình.

Để gửi đến một điều kiện:

Node.js

// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
const condition = '\'stock-GOOG\' in topics || \'industry-tech\' in topics';

// See documentation on defining a message payload.
const message = {
  notification: {
    title: '$FooCorp up 1.43% on the day',
    body: '$FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  condition: condition
};

// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Java

// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
String condition = "'stock-GOOG' in topics || 'industry-tech' in topics";

// See documentation on defining a message payload.
Message message = Message.builder()
    .setNotification(Notification.builder()
        .setTitle("$GOOG up 1.43% on the day")
        .setBody("$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.")
        .build())
    .setCondition(condition)
    .build();

// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
String response = FirebaseMessaging.getInstance().send(message);
// Response is a message ID string.
System.out.println("Successfully sent message: " + response);

Python

# Define a condition which will send to devices which are subscribed
# to either the Google stock or the tech industry topics.
condition = "'stock-GOOG' in topics || 'industry-tech' in topics"

# See documentation on defining a message payload.
message = messaging.Message(
    notification=messaging.Notification(
        title='$GOOG up 1.43% on the day',
        body='$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.',
    ),
    condition=condition,
)

# Send a message to devices subscribed to the combination of topics
# specified by the provided condition.
response = messaging.send(message)
# Response is a message ID string.
print('Successfully sent message:', response)

Đi

// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
condition := "'stock-GOOG' in topics || 'industry-tech' in topics"

// See documentation on defining a message payload.
message := &messaging.Message{
	Data: map[string]string{
		"score": "850",
		"time":  "2:45",
	},
	Condition: condition,
}

// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
response, err := client.Send(ctx, message)
if err != nil {
	log.Fatalln(err)
}
// Response is a message ID string.
fmt.Println("Successfully sent message:", response)

C#

// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
var condition = "'stock-GOOG' in topics || 'industry-tech' in topics";

// See documentation on defining a message payload.
var message = new Message()
{
    Notification = new Notification()
    {
        Title = "$GOOG up 1.43% on the day",
        Body = "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
    },
    Condition = condition,
};

// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
// Response is a message ID string.
Console.WriteLine("Successfully sent message: " + response);

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
   "message":{
    "condition": "'dogs' in topics || 'cats' in topics",
    "notification" : {
      "body" : "This is a Firebase Cloud Messaging Topic Message!",
      "title" : "FCM Message",
    }
  }
}

lệnh cURL:

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
  "notification": {
    "title": "FCM Message",
    "body": "This is a Firebase Cloud Messaging Topic Message!",
  },
  "condition": "'dogs' in topics || 'cats' in topics"
}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Gửi một loạt tin nhắn

API REST và SDK quản trị hỗ trợ gửi tin nhắn theo lô. Bạn có thể nhóm tối đa 500 tin nhắn thành một lô duy nhất và gửi tất cả chúng trong một lệnh gọi API, với cải thiện hiệu suất đáng kể so với việc gửi các yêu cầu HTTP riêng biệt cho từng tin nhắn.

Tính năng này có thể được sử dụng để xây dựng một tập hợp các tin nhắn tùy chỉnh và gửi chúng đến những người nhận khác nhau, bao gồm các chủ đề hoặc mã thông báo đăng ký thiết bị cụ thể. Ví dụ: sử dụng tính năng này khi bạn cần đồng thời gửi tin nhắn đến các đối tượng khác nhau với các chi tiết hơi khác nhau trong nội dung tin nhắn.

Node.js

// Create a list containing up to 500 messages.
const messages = [];
messages.push({
  notification: { title: 'Price drop', body: '5% off all electronics' },
  token: registrationToken,
});
messages.push({
  notification: { title: 'Price drop', body: '2% off all books' },
  topic: 'readers-club',
});

getMessaging().sendAll(messages)
  .then((response) => {
    console.log(response.successCount + ' messages were sent successfully');
  });

Java

// Create a list containing up to 500 messages.
List<Message> messages = Arrays.asList(
    Message.builder()
        .setNotification(Notification.builder()
            .setTitle("Price drop")
            .setBody("5% off all electronics")
            .build())
        .setToken(registrationToken)
        .build(),
    // ...
    Message.builder()
        .setNotification(Notification.builder()
            .setTitle("Price drop")
            .setBody("2% off all books")
            .build())
        .setTopic("readers-club")
        .build()
);

BatchResponse response = FirebaseMessaging.getInstance().sendAll(messages);
// See the BatchResponse reference documentation
// for the contents of response.
System.out.println(response.getSuccessCount() + " messages were sent successfully");

Python

# Create a list containing up to 500 messages.
messages = [
    messaging.Message(
        notification=messaging.Notification('Price drop', '5% off all electronics'),
        token=registration_token,
    ),
    # ...
    messaging.Message(
        notification=messaging.Notification('Price drop', '2% off all books'),
        topic='readers-club',
    ),
]

response = messaging.send_all(messages)
# See the BatchResponse reference documentation
# for the contents of response.
print('{0} messages were sent successfully'.format(response.success_count))

Đi

// Create a list containing up to 500 messages.
messages := []*messaging.Message{
	{
		Notification: &messaging.Notification{
			Title: "Price drop",
			Body:  "5% off all electronics",
		},
		Token: registrationToken,
	},
	{
		Notification: &messaging.Notification{
			Title: "Price drop",
			Body:  "2% off all books",
		},
		Topic: "readers-club",
	},
}

br, err := client.SendAll(context.Background(), messages)
if err != nil {
	log.Fatalln(err)
}

// See the BatchResponse reference documentation
// for the contents of response.
fmt.Printf("%d messages were sent successfully\n", br.SuccessCount)

C#

// Create a list containing up to 500 messages.
var messages = new List<Message>()
{
    new Message()
    {
        Notification = new Notification()
        {
            Title = "Price drop",
            Body = "5% off all electronics",
        },
        Token = registrationToken,
    },
    new Message()
    {
        Notification = new Notification()
        {
            Title = "Price drop",
            Body = "2% off all books",
        },
        Topic = "readers-club",
    },
};

var response = await FirebaseMessaging.DefaultInstance.SendAllAsync(messages);
// See the BatchResponse reference documentation
// for the contents of response.
Console.WriteLine($"{response.SuccessCount} messages were sent successfully");

LÊN ĐỈNH

Tạo một yêu cầu hàng loạt HTTP bằng cách kết hợp danh sách các yêu cầu phụ:

--subrequest_boundary
Content-Type: application/http
Content-Transfer-Encoding: binary
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

POST /v1/projects/myproject-b5ae1/messages:send
Content-Type: application/json
accept: application/json

{
  "message":{
     "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
     "notification":{
       "title":"FCM Message",
       "body":"This is an FCM notification message to device 0!"
     }
  }
}

--subrequest_boundary
Content-Type: application/http
Content-Transfer-Encoding: binary
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

POST /v1/projects/myproject-b5ae1/messages:send
Content-Type: application/json
accept: application/json

{
  "message":{
     "topic":"readers-club",
     "notification":{
       "title":"Price drop",
       "body":"2% off all books"
     }
  }
}

...

--subrequest_boundary
Content-Type: application/http
Content-Transfer-Encoding: binary
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

POST /v1/projects/myproject-b5ae1/messages:send
Content-Type: application/json
accept: application/json

{
  "message":{
     "token":"cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
     "notification":{
       "title":"FCM Message",
       "body":"This is an FCM notification message to device N!"
     }
  }
}
--subrequest_boundary--

Bạn có thể truy vấn BatchResponse được trả về để kiểm tra xem có bao nhiêu tin nhắn đã được chuyển đến FCM thành công. Nó cũng hiển thị một danh sách các phản hồi có thể được sử dụng để kiểm tra trạng thái của từng tin nhắn. Thứ tự của các câu trả lời tương ứng với thứ tự của các thông báo trong danh sách đầu vào.

Gửi tin nhắn hỗ trợ khởi động trực tiếp (chỉ dành cho Android)

Bạn có thể gửi tin nhắn đến các thiết bị ở chế độ khởi động trực tiếp bằng cách sử dụng HTTP v1 hoặc các API HTTP kế thừa. Trước khi gửi đến các thiết bị ở chế độ khởi động trực tiếp, hãy đảm bảo rằng bạn đã hoàn thành các bước để cho phép các thiết bị khách nhận tin nhắn FCM ở chế độ khởi động trực tiếp .

Gửi bằng API FCM v1 HTTP

Yêu cầu thông báo phải bao gồm khóa "direct_boot_ok" : true trong tùy chọn AndroidConfig của nội dung yêu cầu. Ví dụ:

https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send
Content-Type:application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
  "Message":{
    "token" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
    "data": {
      "score": "5x1",
      "time": "15:10"
    },
    "android": {
      "direct_boot_ok": true,
    },
}

Gửi bằng API HTTP kế thừa FCM

Yêu cầu thông báo phải bao gồm khóa "direct_boot_ok" : true ở cấp cao nhất của nội dung yêu cầu. Ví dụ:

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{ "data": {
    "score": "5x1",
    "time": "15:10"
  },
  "to" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
  "direct_boot_ok" : true
}

Các ứng dụng trên thiết bị hiện đang ở chế độ khởi động trực tiếp (và cả khi không ở chế độ đó) có thể xử lý các tin nhắn được gửi bằng khóa này trong phần nội dung yêu cầu.

Tùy chỉnh thông điệp trên các nền tảng

Cả SDK quản trị Firebase và giao thức FCM v1 HTTP đều cho phép các yêu cầu tin nhắn của bạn đặt tất cả các trường có sẵn trong đối tượng message . Điêu nay bao gôm:

  • một tập hợp các trường chung sẽ được giải thích bởi tất cả các phiên bản ứng dụng nhận được thông báo.
  • tập hợp các trường dành riêng cho nền tảng, chẳng hạn như AndroidConfigWebpushConfig , chỉ được diễn giải bởi các phiên bản ứng dụng chạy trên nền tảng được chỉ định.

Các khối dành riêng cho nền tảng giúp bạn linh hoạt tùy chỉnh thông báo cho các nền tảng khác nhau để đảm bảo rằng chúng được xử lý chính xác khi nhận được. Phần phụ trợ FCM sẽ tính đến tất cả các thông số được chỉ định và tùy chỉnh thông báo cho từng nền tảng.

Khi nào sử dụng các trường chung

Sử dụng các trường phổ biến khi bạn:

  • Nhắm mục tiêu các phiên bản ứng dụng trên tất cả các nền tảng - Apple, Android và web
  • Gửi tin nhắn đến các chủ đề

Tất cả các phiên bản ứng dụng, bất kể nền tảng, đều có thể diễn giải các trường phổ biến sau:

Khi nào sử dụng các trường dành riêng cho nền tảng

Sử dụng các trường dành riêng cho nền tảng khi bạn muốn:

  • Chỉ gửi các trường đến các nền tảng cụ thể
  • Gửi các trường dành riêng cho nền tảng ngoài các trường chung

Bất cứ khi nào bạn chỉ muốn gửi giá trị đến các nền tảng cụ thể, đừng sử dụng các trường phổ biến; sử dụng các trường dành riêng cho nền tảng. Ví dụ: để chỉ gửi thông báo đến các nền tảng của Apple và web chứ không phải Android, bạn phải sử dụng hai nhóm trường riêng biệt, một cho Apple và một cho web.

Khi bạn đang gửi tin nhắn với các tùy chọn gửi cụ thể, hãy sử dụng các trường dành riêng cho nền tảng để đặt chúng. Bạn có thể chỉ định các giá trị khác nhau cho mỗi nền tảng nếu bạn muốn. Tuy nhiên, ngay cả khi bạn muốn đặt cùng một giá trị về cơ bản trên các nền tảng, bạn phải sử dụng các trường dành riêng cho nền tảng. Điều này là do mỗi nền tảng có thể diễn giải giá trị hơi khác nhau — ví dụ: thời gian tồn tại được đặt trên Android là thời gian hết hạn tính bằng giây, trong khi trên Apple, thời gian tồn tại được đặt là ngày hết hạn.

Ví dụ: tin nhắn thông báo với các tùy chọn màu sắc và biểu tượng

Yêu cầu gửi ví dụ này sẽ gửi một tiêu đề và nội dung thông báo chung đến tất cả các nền tảng, nhưng nó cũng gửi một số ghi đè dành riêng cho nền tảng đến các thiết bị Android.

Đối với Android, yêu cầu đặt một biểu tượng và màu sắc đặc biệt để hiển thị trên các thiết bị Android. Như đã lưu ý trong phần tham chiếu cho AndroidNotification , màu được chỉ định ở định dạng #rrggbb và hình ảnh phải là tài nguyên biểu tượng có thể vẽ cục bộ cho ứng dụng Android.

Dưới đây là ước tính gần đúng về hiệu ứng hình ảnh trên thiết bị của người dùng:

Bản vẽ đơn giản của hai thiết bị, với một thiết bị hiển thị biểu tượng và màu tùy chỉnh

Node.js

const topicName = 'industry-tech';

const message = {
  notification: {
    title: '`$FooCorp` up 1.43% on the day',
    body: 'FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  android: {
    notification: {
      icon: 'stock_ticker_update',
      color: '#7e55c3'
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Java

Message message = Message.builder()
    .setNotification(Notification.builder()
        .setTitle("$GOOG up 1.43% on the day")
        .setBody("$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.")
        .build())
    .setAndroidConfig(AndroidConfig.builder()
        .setTtl(3600 * 1000)
        .setNotification(AndroidNotification.builder()
            .setIcon("stock_ticker_update")
            .setColor("#f45342")
            .build())
        .build())
    .setApnsConfig(ApnsConfig.builder()
        .setAps(Aps.builder()
            .setBadge(42)
            .build())
        .build())
    .setTopic("industry-tech")
    .build();

Python

message = messaging.Message(
    notification=messaging.Notification(
        title='$GOOG up 1.43% on the day',
        body='$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.',
    ),
    android=messaging.AndroidConfig(
        ttl=datetime.timedelta(seconds=3600),
        priority='normal',
        notification=messaging.AndroidNotification(
            icon='stock_ticker_update',
            color='#f45342'
        ),
    ),
    apns=messaging.APNSConfig(
        payload=messaging.APNSPayload(
            aps=messaging.Aps(badge=42),
        ),
    ),
    topic='industry-tech',
)

Đi

oneHour := time.Duration(1) * time.Hour
badge := 42
message := &messaging.Message{
	Notification: &messaging.Notification{
		Title: "$GOOG up 1.43% on the day",
		Body:  "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
	},
	Android: &messaging.AndroidConfig{
		TTL: &oneHour,
		Notification: &messaging.AndroidNotification{
			Icon:  "stock_ticker_update",
			Color: "#f45342",
		},
	},
	APNS: &messaging.APNSConfig{
		Payload: &messaging.APNSPayload{
			Aps: &messaging.Aps{
				Badge: &badge,
			},
		},
	},
	Topic: "industry-tech",
}

C#

var message = new Message
{
    Notification = new Notification()
    {
        Title = "$GOOG up 1.43% on the day",
        Body = "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
    },
    Android = new AndroidConfig()
    {
        TimeToLive = TimeSpan.FromHours(1),
        Notification = new AndroidNotification()
        {
            Icon = "stock_ticker_update",
            Color = "#f45342",
        },
    },
    Apns = new ApnsConfig()
    {
        Aps = new Aps()
        {
            Badge = 42,
        },
    },
    Topic = "industry-tech",
};

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message":{
     "topic":"industry-tech",
     "notification":{
       "title":"`$FooCorp` up 1.43% on the day",
       "body":"FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day."
     },
     "android":{
       "notification":{
         "icon":"stock_ticker_update",
         "color":"#7e55c3"
       }
     }
   }
 }

Xem tài liệu tham chiếu HTTP v1 để biết chi tiết đầy đủ về các khóa có sẵn trong các khối dành riêng cho nền tảng trong nội dung thư.

Ví dụ: tin nhắn thông báo có hình ảnh tùy chỉnh

Ví dụ sau gửi yêu cầu gửi một tiêu đề thông báo chung cho tất cả các nền tảng, nhưng nó cũng gửi một hình ảnh. Dưới đây là ước tính gần đúng về hiệu ứng hình ảnh trên thiết bị của người dùng:

Vẽ hình ảnh đơn giản trong thông báo hiển thị

Node.js

const topicName = 'industry-tech';

const message = {
  notification: {
    title: 'Sparky says hello!'
  },
  android: {
    notification: {
      imageUrl: 'https://foo.bar.pizza-monster.png'
    }
  },
  apns: {
    payload: {
      aps: {
        'mutable-content': 1
      }
    },
    fcm_options: {
      image: 'https://foo.bar.pizza-monster.png'
    }
  },
  webpush: {
    headers: {
      image: 'https://foo.bar.pizza-monster.png'
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message":{
     "topic":"industry-tech",
     "notification":{
       "title":"Sparky says hello!",
     },
     "android":{
       "notification":{
         "image":"https://foo.bar/pizza-monster.png"
       }
     },
     "apns":{
       "payload":{
         "aps":{
           "mutable-content":1
         }
       },
       "fcm_options": {
           "image":"https://foo.bar/pizza-monster.png"
       }
     },
     "webpush":{
       "headers":{
         "image":"https://foo.bar/pizza-monster.png"
       }
     }
   }
 }

Xem tài liệu tham chiếu HTTP v1 để biết chi tiết đầy đủ về các khóa có sẵn trong các khối dành riêng cho nền tảng trong nội dung thư.

Ví dụ: tin nhắn thông báo với một hành động nhấp chuột được liên kết

Ví dụ sau gửi yêu cầu gửi một tiêu đề thông báo chung cho tất cả các nền tảng, nhưng nó cũng gửi một hành động để ứng dụng thực hiện để phản hồi người dùng tương tác với thông báo. Dưới đây là ước tính gần đúng về hiệu ứng hình ảnh trên thiết bị của người dùng:

Vẽ đơn giản người dùng chạm vào mở trang web

Node.js

const topicName = 'industry-tech';

const message = {
  notification: {
    title: 'Breaking News....'
  },
  android: {
    notification: {
      clickAction: 'news_intent'
    }
  },
  apns: {
    payload: {
      aps: {
        'category': 'INVITE_CATEGORY'
      }
    }
  },
  webpush: {
    fcmOptions: {
      link: 'breakingnews.html'
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message":{
     "topic":"industry-tech",
     "notification":{
       "title":"Breaking News...",
     },
     "android":{
       "notification":{
         "click_action":"news_intent"
       }
     },
     "apns":{
       "payload":{
         "aps":{
           "category" : "INVITE_CATEGORY"
         }
       },
     },
     "webpush":{
       "fcm_options":{
         "link":"breakingnews.html"
       }
     }
   }
 }

Xem tài liệu tham chiếu HTTP v1 để biết chi tiết đầy đủ về các khóa có sẵn trong các khối dành riêng cho nền tảng trong nội dung thư.

Ví dụ: tin nhắn thông báo với các tùy chọn bản địa hóa

Ví dụ sau gửi yêu cầu gửi các tùy chọn bản địa hóa cho máy khách để hiển thị các thông báo đã bản địa hóa. Dưới đây là ước tính gần đúng về hiệu ứng hình ảnh trên thiết bị của người dùng:

Bản vẽ đơn giản của hai thiết bị hiển thị văn bản bằng tiếng Anh và tiếng Tây Ban Nha

Node.js

var topicName = 'industry-tech';

var message = {
  android: {
    ttl: 3600000,
    notification: {
      bodyLocKey: 'STOCK_NOTIFICATION_BODY',
      bodyLocArgs: ['FooCorp', '11.80', '835.67', '1.43']
    }
  },
  apns: {
    payload: {
      aps: {
        alert: {
          locKey: 'STOCK_NOTIFICATION_BODY',
          locArgs: ['FooCorp', '11.80', '835.67', '1.43']
        }
      }
    }
  },
  topic: topicName,
};

getMessaging().send(message)
  .then((response) => {
    // Response is a message ID string.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

LÊN ĐỈNH

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
  "message":{
             "topic":"Tech",
             "android":{
               "ttl":"3600s",
               "notification":{
                 "body_loc_key": "STOCK_NOTIFICATION_BODY",
                 "body_loc_args":  ["FooCorp", "11.80", "835.67", "1.43"],
               },
             },
             "apns":{
               "payload":{
                 "aps":{
                   "alert" : {
                     "loc-key": "STOCK_NOTIFICATION_BODY",
                     "loc-args":  ["FooCorp", "11.80", "835.67", "1.43"],
                    },
                 },
               },
             },
  },
}'

Xem tài liệu tham chiếu HTTP v1 để biết chi tiết đầy đủ về các khóa có sẵn trong các khối dành riêng cho nền tảng trong nội dung thư.

Mã lỗi quản trị viên

Bảng sau liệt kê các mã lỗi API FCM dành cho quản trị viên Firebase và mô tả của chúng, bao gồm các bước giải quyết được đề xuất.

Mã lỗi Các bước mô tả và giải quyết
messaging/invalid-argument Một đối số không hợp lệ đã được cung cấp cho một phương pháp FCM. Thông báo lỗi phải chứa thông tin bổ sung.
messaging/invalid-recipient Người nhận tin nhắn dự định không hợp lệ. Thông báo lỗi phải chứa thông tin bổ sung.
messaging/invalid-payload Một đối tượng tải trọng tin nhắn không hợp lệ đã được cung cấp. Thông báo lỗi phải chứa thông tin bổ sung.
messaging/invalid-data-payload-key Trọng tải thông báo dữ liệu chứa khóa không hợp lệ. Xem tài liệu tham khảo về DataMessagePayload để biết các khóa bị hạn chế.
messaging/payload-size-limit-exceeded Tải trọng tin nhắn được cung cấp vượt quá giới hạn kích thước FCM. Giới hạn là 4096 byte cho hầu hết các thư. Đối với các tin nhắn được gửi đến các chủ đề, giới hạn là 2048 byte. Tổng kích thước tải trọng bao gồm cả khóa và giá trị.
messaging/invalid-options Một đối tượng tùy chọn tin nhắn không hợp lệ đã được cung cấp. Thông báo lỗi phải chứa thông tin bổ sung.
messaging/invalid-registration-token Đã cung cấp mã thông báo đăng ký không hợp lệ. Đảm bảo rằng nó khớp với mã thông báo đăng ký mà ứng dụng khách nhận được khi đăng ký với FCM. Không cắt bớt hoặc thêm các ký tự bổ sung vào nó.
messaging/registration-token-not-registered Mã thông báo đăng ký đã cung cấp chưa được đăng ký. Mã thông báo đăng ký hợp lệ trước đây có thể bị hủy đăng ký vì nhiều lý do, bao gồm:
  • Ứng dụng khách đã tự hủy đăng ký khỏi FCM.
  • Ứng dụng khách đã tự động được hủy đăng ký. Điều này có thể xảy ra nếu người dùng gỡ cài đặt ứng dụng hoặc trên các nền tảng của Apple, nếu Dịch vụ phản hồi APN đã báo cáo mã thông báo APN là không hợp lệ.
  • Mã thông báo đăng ký đã hết hạn. Ví dụ: Google có thể quyết định làm mới mã thông báo đăng ký hoặc mã thông báo APN có thể đã hết hạn cho các thiết bị của Apple.
  • Ứng dụng khách đã được cập nhật, nhưng phiên bản mới không được định cấu hình để nhận tin nhắn.
Đối với tất cả các trường hợp này, hãy xóa mã thông báo đăng ký này và ngừng sử dụng nó để gửi tin nhắn.
messaging/invalid-package-name Thông báo được gửi đến một mã thông báo đăng ký có tên gói không khớp với tùy chọn restrictedPackageName đã cung cấp.
messaging/message-rate-exceeded Tỷ lệ tin nhắn đến một mục tiêu cụ thể quá cao. Giảm số lượng tin nhắn được gửi đến thiết bị hoặc chủ đề này và không thử gửi lại ngay lập tức đến mục tiêu này.
messaging/device-message-rate-exceeded Tỷ lệ tin nhắn đến một thiết bị cụ thể quá cao. Giảm số lượng tin nhắn được gửi đến thiết bị này và không thử gửi lại ngay lập tức đến thiết bị này.
messaging/topics-message-rate-exceeded Tỷ lệ tin nhắn đến người đăng ký về một chủ đề cụ thể quá cao. Giảm số lượng thư được gửi cho chủ đề này và không thử gửi lại ngay lập tức cho chủ đề này.
messaging/too-many-topics Mã thông báo đăng ký đã được đăng ký với số lượng chủ đề tối đa và không thể đăng ký thêm nữa.
messaging/invalid-apns-credentials Không thể gửi thư được nhắm mục tiêu đến thiết bị Apple vì chứng chỉ SSL APN bắt buộc chưa được tải lên hoặc đã hết hạn. Kiểm tra tính hợp lệ của các chứng chỉ phát triển và sản xuất của bạn.
messaging/mismatched-credential Thông tin đăng nhập được sử dụng để xác thực SDK này không có quyền gửi tin nhắn tới thiết bị tương ứng với mã thông báo đăng ký đã cung cấp. Đảm bảo cả thông tin xác thực và mã thông báo đăng ký đều thuộc cùng một dự án Firebase. Xem Thêm Firebase vào ứng dụng của bạn để biết tài liệu về cách xác thực SDK quản trị viên Firebase.
messaging/authentication-error SDK không thể xác thực với máy chủ FCM. Đảm bảo bạn xác thực SDK quản trị Firebase bằng thông tin xác thực có quyền thích hợp để gửi tin nhắn FCM. Xem Thêm Firebase vào ứng dụng của bạn để biết tài liệu về cách xác thực SDK quản trị viên Firebase.
messaging/server-unavailable Máy chủ FCM không thể xử lý yêu cầu kịp thời. Bạn nên thử lại cùng một yêu cầu, nhưng bạn phải:
  • Tôn vinh tiêu đề Retry-After nếu nó được bao gồm trong phản hồi từ Máy chủ kết nối FCM.
  • Triển khai dự phòng theo cấp số nhân trong cơ chế thử lại của bạn. Ví dụ: nếu bạn đợi một giây trước lần thử lại đầu tiên, hãy đợi ít nhất hai giây trước lần thử tiếp theo, sau đó bốn giây, v.v. Nếu bạn đang gửi nhiều tin nhắn, hãy trì hoãn từng tin nhắn một cách độc lập với một lượng ngẫu nhiên bổ sung để tránh đưa ra yêu cầu mới cho tất cả các tin nhắn cùng một lúc.
Những người gửi gây ra sự cố có nguy cơ bị đưa vào danh sách đen.
messaging/internal-error Máy chủ FCM đã gặp lỗi khi cố gắng xử lý yêu cầu. Bạn có thể thử lại yêu cầu tương tự theo các yêu cầu được liệt kê trong hàng messaging/server-unavailable ở trên. Nếu lỗi vẫn tiếp diễn, vui lòng báo cáo sự cố với kênh hỗ trợ Báo cáo lỗi của chúng tôi.
messaging/unknown-error Đã trả lại lỗi máy chủ không xác định. Xem phản hồi của máy chủ thô trong thông báo lỗi để biết thêm chi tiết. Nếu bạn nhận được lỗi này, vui lòng báo cáo toàn bộ thông báo lỗi cho kênh hỗ trợ Báo cáo lỗi của chúng tôi.

Gửi tin nhắn bằng giao thức máy chủ ứng dụng kế thừa

Nếu bạn thích sử dụng các giao thức cũ, hãy xây dựng các yêu cầu thông báo như được hiển thị trong phần này. Hãy nhớ rằng, nếu bạn đang gửi đến nhiều nền tảng thông qua HTTP, giao thức v1 có thể đơn giản hóa các yêu cầu tin nhắn của bạn.

Gửi tin nhắn đến các thiết bị cụ thể

Để gửi tin nhắn đến các thiết bị cụ thể, hãy đặt khóa to mã thông báo đăng ký cho phiên bản ứng dụng cụ thể. Xem thông tin thiết lập ứng dụng khách cho nền tảng của bạn để tìm hiểu thêm về mã thông báo đăng ký.

Yêu cầu HTTP POST

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{ "data": {
    "score": "5x1",
    "time": "15:10"
  },
  "to" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
}

Phản hồi HTTP

{ "multicast_id": 108,
  "success": 1,
  "failure": 0,
  "results": [
    { "message_id": "1:08" }
  ]
}

Tin nhắn XMPP

<message id="">
  <gcm xmlns="google:mobile:data">
    { "data": {
      "score": "5x1",
      "time": "15:10"
    },
    "to" : "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."
  }
  </gcm>
</message>

Phản hồi XMPP

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "from":"REGID",
      "message_id":"m-1366082849205"
      "message_type":"ack"
  }
  </gcm>
</message>

Máy chủ kết nối XMPP cung cấp một số tùy chọn khác cho các phản hồi. Xem Định dạng phản hồi của máy chủ .

Để có danh sách đầy đủ các tùy chọn tin nhắn có sẵn khi gửi tin nhắn xuống các ứng dụng khách, hãy xem thông tin tham khảo cho giao thức máy chủ kết nối bạn đã chọn, HTTP hoặc XMPP .

Gửi tin nhắn đến các chủ đề

Gửi tin nhắn tới chủ đề Nhắn tin qua đám mây của Firebase rất giống với việc gửi tin nhắn tới một thiết bị riêng lẻ hoặc cho một nhóm người dùng. Máy chủ ứng dụng đặt to khóa có giá trị như /topics/yourTopic . Các nhà phát triển có thể chọn bất kỳ tên chủ đề nào phù hợp với biểu thức chính quy: "/topics/[a-zA-Z0-9-_.~%]+" .

Để gửi đến các tổ hợp nhiều chủ đề, máy chủ ứng dụng phải đặt khóa condition (thay vì khóa to ) thành một điều kiện boolean chỉ định các chủ đề đích. Ví dụ: để gửi tin nhắn đến các thiết bị đã đăng ký TopicATopicB hoặc TopicC :

'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics)

Đầu tiên FCM đánh giá bất kỳ điều kiện nào trong dấu ngoặc đơn, sau đó đánh giá biểu thức từ trái sang phải. Trong biểu thức trên, người dùng đã đăng ký bất kỳ chủ đề nào sẽ không nhận được thông báo. Tương tự như vậy, người dùng không đăng ký TopicA sẽ không nhận được thông báo. Những kết hợp này nhận được nó:

  • TopicA và TopicB
  • TopicA và TopicC

Bạn có thể bao gồm tối đa năm chủ đề trong biểu thức điều kiện của mình và hỗ trợ dấu ngoặc đơn. Toán tử được hỗ trợ: && , || .

Yêu cầu ĐĂNG HTTP chủ đề

Gửi đến một chủ đề duy nhất:

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA


Gửi tới các thiết bị đã đăng ký chủ đề "chó" hoặc "mèo":

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA


Phản hồi HTTP chủ đề

//Success example:
{
  "message_id": "1023456"
}

//failure example:
{
  "error": "TopicsMessageRateExceeded"
}

Thông báo XMPP theo chủ đề

Gửi đến một chủ đề duy nhất:

<message id="">
  <gcm xmlns="google:mobile:data">


  </gcm>
</message>

Gửi tới các thiết bị đã đăng ký chủ đề "chó" hoặc "mèo":

<message id="">
  <gcm xmlns="google:mobile:data">


  </gcm>
</message>

Phản hồi XMPP của chủ đề

//Success example:
{
  "message_id": "1023456"
}

//failure example:
{
  "error": "TopicsMessageRateExceeded"
}

Có thể chờ tới 30 giây trước khi Máy chủ FCM trả về phản hồi thành công hoặc thất bại cho các yêu cầu gửi chủ đề. Đảm bảo đặt giá trị thời gian chờ của máy chủ ứng dụng trong yêu cầu cho phù hợp.

Gửi tin nhắn đến các nhóm thiết bị

Gửi tin nhắn đến một nhóm thiết bị tương tự như gửi tin nhắn đến một thiết bị riêng lẻ. Đặt to số thành thành khóa thông báo duy nhất cho nhóm thiết bị. Xem Các loại thông báo để biết chi tiết về hỗ trợ tải trọng. Các ví dụ trong trang này cho biết cách gửi thông báo dữ liệu đến các nhóm thiết bị trong giao thức HTTP và XMPP kế thừa.

Yêu cầu HTTP POST của nhóm thiết bị

https://fcm.googleapis.com/fcm/send
Content-Type:application/json
Authorization:key=AIzaSyZ-1u...0GBYzPu7Udno5aA

{
  "to": "aUniqueKey",
  "data": {
    "hello": "This is a Firebase Cloud Messaging Device Group Message!",
   }
}

Phản hồi HTTP của nhóm thiết bị

Đây là một ví dụ về "thành công" - notification_key có 2 mã thông báo đăng ký được liên kết với nó và thông báo đã được gửi thành công cho cả hai:

{
  "success": 2,
  "failure": 0
}

Đây là một ví dụ về "thành công một phần" - notification_key có 3 mã thông báo đăng ký được liên kết với nó. Tin nhắn chỉ được gửi thành công đến 1 trong các mã thông báo đăng ký. Thông báo phản hồi liệt kê các mã thông báo registration_ids ký (register_ids) không nhận được thông báo:

{
  "success":1,
  "failure":2,
  "failed_registration_ids":[
     "regId1",
     "regId2"
  ]
}

Khi thông báo không được gửi đến một hoặc nhiều mã thông báo đăng ký được liên kết với một khóa notification_key , máy chủ ứng dụng sẽ thử lại với thời gian chờ giữa các lần thử lại.

Nếu máy chủ cố gắng gửi tin nhắn đến một nhóm thiết bị không có thành viên, phản hồi sẽ giống như sau, với 0 thành công và 0 thất bại:

{
  "success": 0,
  "failure": 0
}

Thông báo XMPP của Nhóm thiết bị

<message id="">
  <gcm xmlns="google:mobile:data">
  {
      "to": "aUniqueKey",
      "message_id": "m-1366082849205" ,
      "data": {
          "hello":"This is a Firebase Cloud Messaging Device Group Message!"
      }
  }
  </gcm>
</message>

Phản hồi XMPP của nhóm thiết bị

Khi tin nhắn được gửi đến bất kỳ thiết bị nào trong nhóm thành công, máy chủ kết nối XMPP sẽ phản hồi bằng ACK. Nếu tất cả các tin nhắn được gửi đến tất cả các thiết bị trong nhóm không thành công, máy chủ kết nối XMPP sẽ phản hồi bằng NACK.

Đây là một ví dụ về "thành công" - notification_key có 3 mã thông báo đăng ký được liên kết với nó và thông báo đã được gửi thành công đến tất cả chúng:

{
  "from": "aUniqueKey",
  "message_type": "ack",
  "success": 3,
  "failure": 0,
  "message_id": "m-1366082849205"
}

Đây là một ví dụ về "thành công một phần" - notification_key có 3 mã thông báo đăng ký được liên kết với nó. Tin nhắn chỉ được gửi thành công đến 1 trong các mã thông báo đăng ký. Thông báo phản hồi liệt kê các mã thông báo đăng ký không nhận được thông báo:

{
  "from": "aUniqueKey",
  "message_type": "ack",
  "success":1,
  "failure":2,
  "failed_registration_ids":[
     "regId1",
     "regId2"
  ]
}

Khi máy chủ kết nối FCM không phân phối được đến tất cả các thiết bị trong nhóm. Máy chủ ứng dụng sẽ nhận được phản hồi nack.

Để có danh sách đầy đủ các tùy chọn thông báo, hãy xem thông tin tham khảo cho giao thức máy chủ kết nối bạn đã chọn, HTTP hoặc XMPP .

Phương thức gửi kế thừa SDK quản trị viên Firebase

SDK Node.js dành cho quản trị viên của Firebase hỗ trợ các phương pháp gửi (FCM) thông báo dựa trên API máy chủ FCM cũ . Các phương thức này chấp nhận các đối số khác nhau so với phương thức send() . Bạn nên sử dụng phương thức send() bất cứ khi nào có thể và chỉ sử dụng các phương thức được mô tả trong trang này khi gửi tin nhắn đến các thiết bị hoặc nhóm thiết bị riêng lẻ.

Gửi đến các thiết bị riêng lẻ

Bạn có thể chuyển mã thông báo đăng ký đến phương thức sendToDevice() để gửi tin nhắn đến thiết bị đó:

Node.js

// This registration token comes from the client FCM SDKs.
const registrationToken = 'bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...';

// See the "Defining the message payload" section below for details
// on how to define a message payload.
const payload = {
  data: {
    score: '850',
    time: '2:45'
  }
};

// Send a message to the device corresponding to the provided
// registration token.
getMessaging().sendToDevice(registrationToken, payload)
  .then((response) => {
    // See the MessagingDevicesResponse reference documentation for
    // the contents of response.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Phương sendToDevice() cũng có thể gửi một tin nhắn đa hướng (tức là một tin nhắn đến nhiều thiết bị) bằng cách chuyển một mảng mã thông báo đăng ký thay vì chỉ một mã thông báo đăng ký duy nhất:

Node.js

// These registration tokens come from the client FCM SDKs.
const registrationTokens = [
  'bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...',
  // ...
  'ecupwIfBy1w:APA91bFtuMY7MktgxA3Au_Qx7cKqnf...'
];

// See the "Defining the message payload" section below for details
// on how to define a message payload.
const payload = {
  data: {
    score: '850',
    time: '2:45'
  }
};

// Send a message to the devices corresponding to the provided
// registration tokens.
getMessaging().sendToDevice(registrationTokens, payload)
  .then((response) => {
    // See the MessagingDevicesResponse reference documentation for
    // the contents of response.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Phương sendToDevice() trả về một lời hứa được giải quyết bằng đối tượng MessagingDevicesResponse có chứa phản hồi từ FCM. Kiểu trả về có cùng định dạng khi chuyển một mã thông báo đăng ký hoặc một mảng mã thông báo đăng ký.

Một số trường hợp như lỗi xác thực hoặc giới hạn tốc độ khiến toàn bộ thư không xử lý được. Trong những trường hợp này, lời hứa được trả về bởi sendToDevice() bị từ chối do lỗi. Để biết danh sách đầy đủ các mã lỗi, bao gồm mô tả và các bước giải quyết, hãy xem Lỗi API FCM dành cho quản trị viên.

Gửi đến một nhóm thiết bị

Nhắn tin nhóm thiết bị cho phép bạn thêm nhiều thiết bị vào một nhóm duy nhất. Điều này tương tự như nhắn tin theo chủ đề, nhưng bao gồm xác thực để đảm bảo rằng tư cách thành viên nhóm chỉ được quản lý bởi máy chủ của bạn. Ví dụ: nếu bạn muốn gửi các tin nhắn khác nhau đến các kiểu điện thoại khác nhau, máy chủ của bạn có thể thêm / xóa đăng ký vào các nhóm thích hợp và gửi tin nhắn thích hợp đến từng nhóm. Nhắn tin nhóm thiết bị khác với nhắn tin chủ đề ở chỗ nó liên quan đến việc quản lý các nhóm thiết bị từ máy chủ của bạn thay vì trực tiếp trong ứng dụng của bạn.

Bạn có thể sử dụng tính năng nhắn tin nhóm thiết bị thông qua giao thức XMPP hoặc HTTP kế thừa trên máy chủ ứng dụng của mình. Các phiên bản cũ hơn của SDK quản trị Firebase cho Node.js dựa trên các giao thức cũ và cũng cung cấp khả năng nhắn tin nhóm thiết bị. Số lượng thành viên tối đa được phép cho một khóa thông báo là 20.

Bạn có thể tạo nhóm thiết bị và tạo khóa thông báo thông qua máy chủ ứng dụng hoặc ứng dụng khách Android. Xem Quản lý nhóm thiết bị để biết chi tiết.

Phương sendToDeviceGroup() cho phép bạn gửi tin nhắn đến một nhóm thiết bị bằng cách chỉ định khóa thông báo cho nhóm thiết bị đó:

Node.js

// See the "Managing device groups" link above on how to generate a
// notification key.
const notificationKey = 'some-notification-key';

// See the "Defining the message payload" section below for details
// on how to define a message payload.
const payload = {
  data: {
    score: '850',
    time: '2:45'
  }
};

// Send a message to the device group corresponding to the provided
// notification key.
getMessaging().sendToDeviceGroup(notificationKey, payload)
  .then((response) => {
    // See the MessagingDeviceGroupResponse reference documentation for
    // the contents of response.
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Phương sendToDeviceGroup() trả về một lời hứa được giải quyết bằng đối tượng MessagingDevicesResponse có chứa phản hồi từ FCM.

Một số trường hợp như lỗi xác thực hoặc giới hạn tốc độ khiến toàn bộ thư không xử lý được. Trong những trường hợp này, lời hứa được trả về bởi sendToDeviceGroup() bị từ chối do lỗi. Để biết danh sách đầy đủ các mã lỗi, bao gồm mô tả và các bước giải quyết, hãy xem Lỗi API FCM dành cho quản trị viên.

Xác định tải trọng tin nhắn

Các phương pháp trên dựa trên các giao thức kế thừa FCM chấp nhận tải trọng thông báo làm đối số thứ hai của chúng và hỗ trợ cả thông báo và thông báo dữ liệu . Bạn có thể chỉ định một hoặc cả hai kiểu thông báo bằng cách tạo một đối tượng với các khóa data và / hoặc notification . Ví dụ: đây là cách xác định các loại trọng tải thư khác nhau:

Tin nhắn thông báo

const payload = {
  notification: {
    title: '$FooCorp up 1.43% on the day',
    body: '$FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  }
};

Tin nhắn dữ liệu

const payload = {
  data: {
    score: '850',
    time: '2:45'
  }
};

Tin nhắn kết hợp

const payload = {
  notification: {
    title: '$FooCorp up 1.43% on the day',
    body: '$FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
  },
  data: {
    stock: 'GOOG',
    open: '829.62',
    close: '635.67'
  }
};

Tải trọng tin nhắn thông báo có một tập hợp con được xác định trước gồm các thuộc tính hợp lệ và hơi khác nhau tùy thuộc vào hệ điều hành di động mà bạn đang nhắm mục tiêu. Xem tài liệu tham khảo cho NotificationMessagePayload để biết danh sách đầy đủ.

Tải trọng thông báo dữ liệu bao gồm các cặp khóa-giá trị tùy chỉnh với một số hạn chế, bao gồm thực tế là tất cả các giá trị phải là chuỗi. Xem tài liệu tham khảo cho DataMessagePayload để biết danh sách đầy đủ các hạn chế.

Xác định các tùy chọn tin nhắn

Các phương pháp trên dựa trên các giao thức kế thừa FCM chấp nhận đối số thứ ba tùy chọn chỉ định một số tùy chọn cho thông báo. Ví dụ: ví dụ sau sẽ gửi một tin nhắn có mức độ ưu tiên cao đến một thiết bị sẽ hết hạn sau 24 giờ:

Node.js

// This registration token comes from the client FCM SDKs.
const registrationToken = 'bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...';

// See the "Defining the message payload" section above for details
// on how to define a message payload.
const payload = {
  notification: {
    title: 'Urgent action needed!',
    body: 'Urgent action is needed to prevent your account from being disabled!'
  }
};

// Set the message as high priority and have it expire after 24 hours.
const options = {
  priority: 'high',
  timeToLive: 60 * 60 * 24
};

// Send a message to the device corresponding to the provided
// registration token with the provided options.
getMessaging().sendToDevice(registrationToken, payload, options)
  .then((response) => {
    console.log('Successfully sent message:', response);
  })
  .catch((error) => {
    console.log('Error sending message:', error);
  });

Xem tài liệu tham khảo về MessagingOptions để biết danh sách đầy đủ các tùy chọn có sẵn.