Ultimate

UI での Google PubSub ソース接続の作成

最終更新日: 2023-10-26
  • トピック:
  • Sources
    このトピックの詳細を表示
  • 作成対象:
  • Developer
重要

The Google PubSub ソースは、Real-time Customer Data Platform Ultimate を購入したユーザーがソースカタログで利用できます。

このチュートリアルでは、Platform ユーザーインターフェイスを使用して、Google PubSub(以下「PubSub」と呼びます)を作成する手順について説明します。

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • ソース:Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス:Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

既に有効な PubSub 接続がある場合は、このドキュメントの残りの部分をスキップして、データフローの設定に関するチュートリアルに進むことができます。

必要な資格情報の収集

PubSub を Platform に接続するには、次の資格情報に対する有効な値を指定する必要があります。

資格情報 説明
プロジェクト ID PubSub の認証に必要なプロジェクト ID。
資格情報 認証に必要な資格情報 PubSub. 資格情報から空白を削除した後、完全な JSON ファイルを配置する必要があります。
資格情報 説明
資格情報 認証に必要な資格情報 PubSub. 資格情報から空白を削除した後、完全な JSON ファイルを配置する必要があります。
トピック名 お客様の PubSub 購読。 In PubSubを使用すると、購読を使用して、メッセージの公開先のトピックを購読することでメッセージを受け取ることができます。 注意:単一の PubSub サブスクリプションは 1 つのデータフローに対してのみ使用できます。 複数のデータフローを作成するには、複数のサブスクリプションが必要です。
配信登録名 お客様の PubSub 購読。 In PubSubを使用すると、購読を使用して、メッセージの公開先のトピックを購読することでメッセージを受け取ることができます。

これらの値について詳しくは、次の PubSub 認証ドキュメントを参照してください。サービスアカウントベースの認証を使用している場合、資格情報の生成手順については、次の PubSub ガイドを参照してください。

ヒント

サービスアカウントベースの認証を使用している場合は、サービスアカウントに十分なユーザーアクセス権が付与され、資格情報をコピー&ペーストする際に、JSON 内に余分な空白がないことを確認してください。

必要な資格情報を収集したら、以下の手順に従って PubSub アカウントを Platform にリンクできます。

PubSub アカウントを接続

Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。The カタログ 画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。

クラウドストレージカテゴリで、Google PubSub を選択し、次に​データを追加​を選択します。

Experience PlatformUI のソースカタログ。

Google PubSub に接続​ページが表示されます。このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント

既存のアカウントを使用するには、新しいデータフローを作成する PubSub アカウントを選択し、「次へ」を選択して続行します。

ソースワークフロー内の既存のアカウント選択。

新規アカウント

ヒント
  • アクセスが制限されたアカウントを作成する場合は、1 つ以上のトピック名またはサブスクリプション名を指定する必要があります。 両方の値が見つからない場合、認証は失敗します。
  • 作成後は、 Google PubSub ベース接続。 認証タイプを変更するには、新しいベース接続を作成する必要があります。

新しいアカウントを作成する場合は、「 新しいアカウント​をクリックし、新しい PubSub アカウント。

ソースワークフローでのGoogle PubSub ソースの新しいアカウントインターフェイス

The PubSub 「ソース」では、認証時に許可するアクセスのタイプを指定できます。 アカウントを設定して、プロジェクトベースの認証を使用することも、トピックおよび購読ベースの認証を使用することもできます。 プロジェクトベースの認証では、アカウント内のルートレベルプロジェクトへのアクセスを許可でき、トピックおよび購読ベースの認証では、特定のプロジェクトへのアクセスを制限できます PubSub トピックおよび購読。

ルートへのアクセス権を持つアカウントを作成するには PubSub プロジェクトフォルダー。 選択 Google PubSub 認証資格情報 を認証タイプとして設定し、プロジェクト ID と資格情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。

ルートアクセスが選択されたGoogle PubSub ソースの新しいアカウントインターフェイス。

特定のに対するアクセスのみを制限したアカウントを作成するには PubSub トピックと購読、選択 Google PubSub スコープ認証資格情報 次に、資格情報、トピック名、サブスクリプション名を入力します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。

範囲を指定したアクセス権が選択された、Google PubSub ソースの新しいアカウントインターフェイス。

メモ

に割り当てられたプリンシパル(ロール) PubSub プロジェクトは、 PubSub プロジェクト。 プリンシパル(役割)に特定のトピックへのアクセス権を付与する場合は、そのプリンシパル(役割)もトピックの対応するサブスクリプションに追加する必要があります。 詳しくは、 [PubSub アクセス制御に関するドキュメント] (https://cloud.google.com/pubsub/docs/access-control).

データの選択

認証に成功すると、 データを選択 ステップで、 PubSub データ階層を参照し、Experience Platformに取り込むデータを選択します。

プロジェクトベースのアクセス権で認証済みの場合は、 データを選択 インターフェイスには、トピックが関連付けられているプロジェクト内のすべての購読が表示されます。

プロジェクトベースの認証を使用するソースワークフローのデータ選択手順。

トピックおよび購読ベースのアクセスで認証済みの場合、 データを選択 インターフェイスの表示は、指定した情報に応じて異なる場合があります。

  • トピック名のみを指定した場合、インターフェイスには、指定したトピックに対応するすべてのトピックと購読のペアが表示されます。
  • 購読名のみを指定した場合、インターフェイスには、指定した購読名に対応するすべてのトピックと購読のペアが表示されます。
  • トピック名と購読名の両方が指定されている場合、インターフェイスには、指定された値の両方に対応するトピックと購読のペアが表示されます。

トピックおよび購読ベースの認証を使用するソースワークフローのデータ選択手順。

次の手順

このチュートリアルでは、 PubSub アカウントとプラットフォーム。 次のチュートリアルに進み、データフローを設定して、クラウドストレージから Platform にストリーミングデータを取り込みます

このページ