このドキュメントでは、pull サブスクリプションからメッセージを受信する方法について説明します。pull サブスクリプションを作成するには、 Google Cloud コンソール、Google Cloud CLI、クライアント ライブラリ、または Pub/Sub API を使用できます。
始める前に
- pull サブスクリプションを作成します。
必要なロールと権限
pull サブスクリプションからメッセージを受信するために必要な権限を取得するには、サブスクリプションに対する Pub/Sub サブスクライバー (roles/pubsub.subscriber)IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、pull サブスクリプションからメッセージを受信するために必要な pubsub.subscriptions.consume 権限が含まれています。
カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。
サブスクリプションからメッセージを pull する
次のサンプルは、StreamingPull API または Pull API を使用してサブスクリプションからメッセージを pull する方法を示しています。
StreamingPull API
StreamingPull API を使用するには、クライアント ライブラリを使用する必要があります。
Google Cloud コンソールと Google Cloud CLI は StreamingPull API をサポートしていません。
StreamingPull と高レベル クライアント ライブラリのコードサンプル
C++
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の C++ の設定手順を実施してください。詳細については、Pub/Sub C++ API リファレンス ドキュメントをご覧ください。