[Ultimate]{class="badge positive"}

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

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

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

基本を学ぶ

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

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

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

必要な資格情報の収集

を接続するには、以下に説明する接続プロパティの値を指定する必要があります PubSub Experience Platformするアカウント。 認証と前提条件の設定について詳しくは、以下を参照してください PubSub source の概要.

プロジェクトベースの認証
table 0-row-2 1-row-2 2-row-2
資格情報 説明
プロジェクト ID PubSub の認証に必要なプロジェクト ID。
資格情報 認証に必要な資格情報 PubSub. 資格情報から空白を削除した後、必ず完全な JSON ファイルを配置してください。
トピックと購読ベースの認証
table 0-row-2 1-row-2 2-row-2 3-row-2
資格情報 説明
資格情報 認証に必要な資格情報 PubSub. 資格情報から空白を削除した後、必ず完全な JSON ファイルを配置してください。
トピック名 の名前 PubSub 登録。 対象: PubSub購読では、メッセージの公開先のトピックを購読することで、メッセージを受信できます。 注意:単一 PubSub 購読は、1 つのデータフローに対してのみ使用できます。 複数のデータフローを作成するには、複数の購読が必要です。
登録名 の名前 PubSub 登録。 対象: PubSub購読では、メッセージの公開先のトピックを購読することで、メッセージを受信できます。

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

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

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

PubSub アカウントを接続

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

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

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

Experience PlatformUI のソースカタログ。

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

既存のアカウント

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

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

新規アカウント

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

新しいアカウントを作成する場合は、 新しいアカウント ​を選択し、新しいの名前と説明(オプション)を入力します PubSub アカウント。

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

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

プロジェクトベースの認証

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

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

トピックと購読ベースの認証

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

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

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

データの選択

認証が成功すると、に移動します データを選択 手順に移動する PubSub データ階層を選択し、Experience Platformにするデータを選択します。

プロジェクトベースの認証

プロジェクトベースのアクセスで認証した場合、 データを選択 インターフェイスには、トピックが添付されたプロジェクト内のすべての購読が表示されます。

プロジェクトベースの認証を使用したソースワークフローのデータ選択ステップ。

トピックと購読ベースの認証

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

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

トピックおよびサブスクリプションベースの認証を含むソースワークフローのデータ選択ステップ。

次の手順

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

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089