[Ultimate]{class="badge positive"}
UI での Google PubSub ソース接続の作成
このチュートリアルでは、Platform ユーザーインターフェイスを使用して、Google PubSub（以下「PubSub」と呼びます）を作成する手順について説明します。
基本を学ぶ
このチュートリアルは、Adobe 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 アカウントを Platform にリンクできます。
PubSub アカウントを接続
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。 カタログ 画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
クラウドストレージカテゴリで、Google PubSub を選択し、次に データを追加 を選択します。
Google PubSub に接続 ページが表示されます。このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント
既存のアカウントを使用するには、新しいデータフローを作成する PubSub アカウントを選択し、「次へ」を選択して続行します。
新規アカウント
- アクセスが制限されたアカウントを作成する場合は、トピック名またはサブスクリプション名の少なくとも 1 つを指定する必要があります。 両方の値がない場合、認証は失敗します。
- 作成した後は、Google PubSub ベース接続の認証タイプを変更できません。 認証タイプを変更するには、新しいベース接続を作成する必要があります。
新しいアカウントを作成する場合は、「新しいアカウント」を選択し、新しい PubSub アカウントの名前と説明（オプション）を入力します。
PubSub ソースでは、認証時に許可するアクセスの種類を指定できます。 アカウントを設定して、プロジェクトベースの認証か、トピックおよび購読ベースの認証を持つことができます。 プロジェクトベースの認証では、アカウントのルートレベルのプロジェクトへのアクセス権を付与でき、トピックおよび購読ベースの認証では、特定の PubSub トピックおよび購読へのアクセスを制限できます。
ルート PubSub プロジェクトフォルダーへのアクセス権を持つアカウントを作成するには： 認証の種類として Google PubSub 認証資格情報 を選択し、プロジェクト ID と資格情報を入力します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
特定の PubSub トピックおよびサブスクリプションに対してのみアクセスが制限されたアカウントを作成するには、Google PubSub スコープ認証資格情報を選択してから 資格情報、トピック名、サブスクリプション名を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
データの選択
正常に認証されると、 データを選択 ステップに移動します。このステップでは、PubSub データ階層内を移動し、Experience Platformにするデータを選択できます。
プロジェクトベースのアクセスで認証した場合、 データを選択 インターフェイスには、トピックが添付されたプロジェクト内のすべての購読が表示されます。
トピックおよび購読ベースのアクセスで認証されている場合、 データを選択 インターフェイスの表示は、指定した情報によって異なる場合があります。
- トピック名のみを指定した場合、インターフェイスには、指定されたトピックに対応するすべてのトピックと購読のペアが表示されます。
- 購読名のみを指定した場合、インターフェイスには、指定された購読名に対応するすべてのトピックと購読のペアが表示されます。
- トピック名と購読名の両方が指定されている場合、インターフェイスには、指定された値の両方に対応するトピックと購読のペアが表示されます。
次の手順
このチュートリアルでは、PubSub アカウントと Platform の間に接続を作成しました。 次のチュートリアルに進み、データフローを設定して、クラウドストレージから Platform にストリーミングデータを取り込みます。