このチュートリアルでは、Platform ユーザーインターフェイスを使用して、Google PubSub(以下「PubSub」と呼びます)を作成する手順について説明します。
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
既に有効な PubSub 接続がある場合は、このドキュメントの残りの部分をスキップして、データフローの設定に関するチュートリアルに進むことができます。
PubSub を Platform に接続するには、次の資格情報に対する有効な値を指定する必要があります。
認証情報 | 説明 |
---|---|
プロジェクト ID | PubSub の認証に必要なプロジェクト ID。 |
認証情報 | PubSub の認証に必要な資格情報または秘密鍵の ID。 |
トピック名 | お客様の PubSub 購読。 In PubSubを使用すると、購読を使用して、メッセージの公開先のトピックを購読することでメッセージを受け取ることができます。 注意:単一の PubSub サブスクリプションは 1 つのデータフローに対してのみ使用できます。 複数のデータフローを作成するには、複数のサブスクリプションが必要です。 |
購読名 | お客様の PubSub 購読。 In PubSubを使用すると、購読を使用して、メッセージの公開先のトピックを購読することでメッセージを受け取ることができます。 |
これらの値について詳しくは、次の PubSub 認証ドキュメントを参照してください。サービスアカウントベースの認証を使用している場合、資格情報の生成手順については、次の PubSub ガイドを参照してください。
サービスアカウントベースの認証を使用している場合は、サービスアカウントに十分なユーザーアクセス権が付与され、資格情報をコピー&ペーストする際に、JSON 内に余分な空白がないことを確認してください。
必要な資格情報を収集したら、以下の手順に従って PubSub アカウントを Platform にリンクできます。
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。この カタログ 画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
クラウドストレージカテゴリで、Google PubSub を選択し、次にデータを追加を選択します。
Google PubSub に接続ページが表示されます。このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウントを使用するには、新しいデータフローを作成する PubSub アカウントを選択し、「次へ」を選択して続行します。
アクセスが制限されたアカウントを作成する場合は、1 つ以上のトピック名またはサブスクリプション名を指定する必要があります。 両方の値が見つからない場合、認証は失敗します。
新しいアカウントを作成する場合は、「 新しいアカウント新しい PubSub アカウント
この PubSub 「ソース」では、認証時に許可するアクセスのタイプを指定できます。 アカウントを設定して、プロジェクトベースの認証を使用することも、トピックおよび購読ベースの認証を使用することもできます。 プロジェクトベースの認証では、アカウント内のルートレベルプロジェクトへのアクセスを許可できますが、トピックおよび購読ベースの認証では、特定のプロジェクトへのアクセスを制限できます PubSub トピックおよび購読。
ルートへのアクセス権を持つアカウントを作成するには PubSub プロジェクトフォルダー。 選択 Google PubSub 認証資格情報 を認証タイプとして設定し、プロジェクト ID と資格情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
特定のに対するアクセスのみを制限したアカウントを作成するには PubSub トピックと購読、選択 Google PubSub スコープ認証資格情報 次に、資格情報、トピック名、サブスクリプション名を入力します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
に割り当てられたプリンシパル(ロール) PubSub プロジェクトは、 PubSub プロジェクト。 プリンシパル(役割)に特定のトピックへのアクセス権を付与する場合は、そのプリンシパル(役割)もトピックの対応するサブスクリプションに追加する必要があります。 詳しくは、 [PubSub アクセス制御に関するドキュメント] (https://cloud.google.com/pubsub/docs/access-control).
認証に成功すると、 データを選択 ステップ ( PubSub データ階層を参照し、Experience Platformに取り込むデータを選択します。
プロジェクトベースのアクセス権で認証済みの場合、 データを選択 インターフェイスには、トピックが関連付けられているプロジェクト内のすべての購読が表示されます。
トピックおよび購読ベースのアクセスで認証済みの場合、 データを選択 インターフェイスの表示は、指定した情報に応じて異なる場合があります。
このチュートリアルでは、 PubSub アカウントとプラットフォーム。 次のチュートリアルに進み、データフローを設定して、クラウドストレージから Platform にストリーミングデータを取り込みます。