[Ultimate]{class="badge positive"}
UI での Google PubSub ソース接続の作成
このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用してGoogle PubSub （以下、「PubSub」と呼ぶ）を作成する手順を説明します。
基本を学ぶ
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
- サンドボックス : Experience Platformは、1つのExperience 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では、メッセージが公開されたトピックにサブスクライブすることで、メッセージを受信できます。 注:1つのPubSub サブスクリプションは、1つのデータフローにのみ使用できます。 複数のデータフローを作成するには、複数のサブスクリプションが必要です。 |
| サブスクリプション名 | PubSub サブスクリプションの名前。 PubSubでは、メッセージが公開されたトピックにサブスクライブすることで、メッセージを受信できます。 |
これらの値について詳しくは、次の PubSub 認証ドキュメントを参照してください。 サービスアカウントベースの認証を使用している場合、資格情報の生成手順については、次の PubSub ガイドを参照してください。
必要な資格情報を収集したら、次の手順に従ってPubSub アカウントをExperience Platformにリンクできます。
PubSub アカウントを接続
Experience Platform UIで、左側のナビゲーションから「Sources」を選択して、Sources ワークスペースにアクセスします。 Catalog画面には、アカウントを作成できるさまざまなソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、使用する特定のソースを検索オプションを使用して探すこともできます。
Cloud storage カテゴリで「Google PubSub」を選択し、「Add data」を選択します。
Connect to Google PubSub ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント
既存のアカウントを使用するには、新しいデータフローを作成するPubSub アカウントを選択し、Nextを選択して続行します。
新規アカウント
- アクセスが制限されたアカウントを作成する場合は、少なくとも1つのトピック名またはサブスクリプション名を指定する必要があります。 両方の値が欠落している場合、認証は失敗します。
- 作成したら、Google PubSub ベース接続の認証タイプを変更することはできません。 認証タイプを変更するには、新しいベース接続を作成する必要があります。
新しいアカウントを作成する場合は、New accountを選択し、新しいPubSub アカウントの名前とオプションの説明を指定します。
PubSub ソースでは、認証中に許可するアクセスの種類を指定できます。 プロジェクトベースの認証またはトピックおよびサブスクリプションベースの認証を使用するようにアカウントを設定できます。 プロジェクトベースの認証を使用すると、アカウントのルートレベルのプロジェクトへのアクセス権を付与できます。一方、トピックおよびサブスクリプションベースの認証を使用すると、特定のPubSub トピックおよびサブスクリプションへのアクセスを制限できます。
ルート PubSub プロジェクト フォルダーへのアクセス権を持つアカウントを作成するには。 認証タイプとして Google PubSub authentication credentials を選択し、プロジェクト IDと資格情報を指定します。 完了したら、Connect to sourceを選択し、新しい接続が確立されるまでしばらく時間を空けます。
特定のPubSub トピックとサブスクリプションへのアクセス制限のあるアカウントを作成するには、Google PubSub Scoped authentication credentialsを選択し、資格情報、トピック名、サブスクリプション名を指定します。 完了したら、Connect to sourceを選択し、新しい接続が確立されるまでしばらく時間を空けます。
データの選択
認証が成功すると、Select data ステップに移動します。このステップでは、PubSub データ階層を移動し、Experience Platformに取り込むデータを選択できます。
プロジェクトベースのアクセスで認証した場合、Select data インターフェイスには、トピックがアタッチされたプロジェクト内のすべてのサブスクリプションが表示されます。
トピックおよびサブスクリプションベースのアクセスで認証した場合、提供した情報によってSelect data インターフェイスの表示が異なる場合があります。
- トピック名のみを指定すると、インターフェイスには、指定されたトピックに対応するすべてのトピックと購読のペアが表示されます。
- サブスクリプション名のみを指定した場合、インターフェイスには、指定されたサブスクリプション名に対応するすべてのトピックとサブスクリプションのペアが表示されます。
- トピック名とサブスクリプション名の両方が指定されている場合、インターフェイスには、指定された両方の値に対応するトピックとサブスクリプションのペアが表示されます。
次の手順
このチュートリアルでは、PubSub アカウントとExperience Platformの間に接続を作成しました。 次のチュートリアルに進み、クラウドストレージからExperience Platform🔗にストリーミングデータを取り込むためのデータフローを設定できるようになりました。