批次訊息傳遞功能會建立採用自訂批次設定的發布端用戶端,並透過該用戶端發布幾則訊息。
本文提供有關使用批次訊息傳遞功能,以及發布至主題的訊息相關資訊。
事前準備
設定發布工作流程前,請確認您已完成下列工作:
必要的角色
如要取得發布至主題的訊息所需的權限,請要求管理員為您授予主題的 Pub/Sub 發布者 (roles/pubsub.publisher
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
您需要額外權限,才能建立或更新主題和訂閱項目。
使用批次訊息傳遞功能
請參閱下列程式碼範例,瞭解如何為發布商設定批次訊息設定。
C++
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 C++ 環境。詳情請參閱 Pub/Sub C++ API 參考說明文件。
C#
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 C# 環境。詳情請參閱 Pub/Sub C# API 參考說明文件。
Go
在試用這個範例之前,請先按照 快速入門:使用用戶端程式庫中的 Go 設定說明進行操作。詳情請參閱 Pub/Sub Go API 參考說明文件。
Java
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 Java 環境。詳情請參閱 Pub/Sub Java API 參考說明文件。
Node.js
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 Node.js 環境。詳情請參閱 Pub/Sub Node.js API 參考說明文件。
Node.js
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 Node.js 環境。詳情請參閱 Pub/Sub Node.js API 參考說明文件。
PHP
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的 PHP 設定說明進行操作。詳情請參閱 Pub/Sub PHP API 參考說明文件。
Python
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 Python 環境。詳情請參閱 Pub/Sub Python API 參考說明文件。
Ruby
在嘗試這個範例之前,請先按照 快速入門:使用用戶端程式庫中的操作說明設定 Ruby 環境。詳情請參閱 Pub/Sub Ruby API 參考說明文件。
停用批次訊息傳遞功能
如要停用用戶端程式庫中的批次處理功能,請將 max_messages
的值設為 1。
批次傳送訊息和依序傳送
在有序傳遞模式下,如果未確認批次中的任何訊息,則批次中的所有訊息 (包括未確認訊息之前傳送的訊息) 都會重新傳送。
批次訊息的配額和限制
設定批次訊息之前,請考量發布傳送量配額和批次的最大大小等因素的影響。高階用戶端程式庫可確保批次要求維持在指定限制範圍內。
- 為了計算費用,系統會將 1,000 個位元組視為最小要求大小,即使實際訊息大小可能小於 1,000 個位元組也一樣。
- Pub/Sub 針對單一批次發布要求,設有 10 MB 的大小限制或 1,000 則訊息的數量限制。
詳情請參閱「Pub/Sub 配額和限制」。
後續步驟
如要瞭解如何設定進階發布選項,請參閱以下文章: