Google Cloudとのデータ同期を設定する

Pendoのデータ同期機能を使用すると、Pendoのデータ（Pendo Feedbackのデータを除く）をGoogle Cloud Storage（GCS）アカウントにエクスポートできます。この記事では、GCSのデータ同期の設定方法を説明します。

前提条件

• データ同期は有料の機能です。この機能を利用するには、Pendoの担当者にお問い合わせください。
• この作業においてクラウドストレージの保存先を設定するには、Pendoのサブスクリプション管理者である必要があります。
• ユーザーには、GCSのstorage.objects.create、storage.objects.delete、storage.objects.update権限が必要です。

設定の概要

GCSとのデータ同期では、Pendo側での設定と、Google Cloud環境での構成が必要になります。具体的には、以下の手順で実施します。

1. Google Cloud Platform（GCP）のサービスアカウントを作成します。
2. サービスアカウント用のJSONキーファイルを生成します。
3. GCSバケットを作成します。
4. GCSバケットにGCPサービスアカウントへの権限を付与します。
5. Pendoでプロバイダーを選択します。
6. PendoにサービスアカウントキーとバケットURLを入力します。

ステップ1：GCPサービスアカウントを作成する

サービスアカウントをお持ちでない方は、Google Cloud環境でGoogle Cloud Platform（GCP）のサービスアカウントを作成する必要があります。

1. Google Cloudコンソールで、［IAM と管理］>［サービス アカウント］に移動し、［サービス アカウントを作成］を選択します。
2. サービスアカウント名や説明など、サービスアカウントの詳細を入力します。
3. 必要に応じて、サービスアカウントのアクセスレベルを選択します。
4. ［完了］を選択します。これにより、［IAMサービスアカウント（IAM Service Accounts）］ページにサービスアカウントと役割が作成されます。
5. メール形式のサービスアカウント名をコピーします。これは、本記事のステップ4で使用するため、保存しておいてください。

詳しい情報および手順については、Googleの サービス アカウント キーの作成と管理をご覧ください。

ステップ2：サービスアカウント用のJSONキーファイルを生成する

データ同期のためにサービスアカウントを新規に作成する場合でも、既存のものを利用する場合でも、Pendoのデータ同期の宛先に入力するJSONキーファイルは生成する必要があります。このキーの生成方法は次のとおりです。

1. GCPで［IAM サービス アカウント］ページに移動し、データ同期に使用するサービスアカウントを見つけます。
2. ［操作］列で、サービスアカウントの横にある縦並びの点をクリックし、 ［鍵を管理］を選択します。
3. ［鍵を追加］ドロップダウンメニューから［新しい鍵を作成］を選択します。
4. 鍵のタイプとして［JSON］を選択し、［作成］をクリックします。
5. お使いのコンピューターにキーが保存されたことを伝えるメッセージが表示されます。このメッセージは閉じて構いません。

これで、キーがコンピューターにインストールされました。この記事のステップ6で使用するため、キーは必ず保存してください。

ステップ3：GCSバケットを作成する

PendoからエクスポートされたデータはGCSバケットにコピーされます。GCSバケットは次の手順で作成します。

1. Cloud Storageで［バケット］に移動し、ページの上部にある［バケットを作成］を選択します。
2. バケットにわかりやすい名前を付けます。
3. Googleワークフローに従って、データの場所とストレージクラスを選択し、オブジェクトへのアクセスを制御する方法とオブジェクトデータを保護する方法を指定します。
4. ［作成］をクリックします。
5. パブリックアクセスがブロックされていることを知らせるメッセージが生成されます。［確認］をクリックします。

その後、Google Cloudの空のバケットが開きます。

ステップ4：GCSバケットにサービスアカウントへのアクセス権を付与する

GCPのサービスアカウントをGCSバケットのメンバーにして、ストレージ管理者の権限をサービスアカウントに付与します。

1. Cloud Storageのバケットでデータ同期用のバケットを見つけ、次のいずれかを実施します。
   • データ同期用のバケットを開き、上部の［権限］タブを選択し、［権限を付与］を選択します。
   • ［バケット］ ページでデータ同期用バケットの横にある縦並びの点を選択し、 ［権限を編集］を選択します。
2. ［プリンシパルを追加（Add principal）］を選択し、この記事のステップ1でコピーしたサービスアカウント名を貼り付けて、バケットへのアクセスを許可します。
3. ［役割を選択（Select a role）］で、 ［クラウドストレージ（Cloud Storage）］>［ストレージ管理者（Storage Admin）］の順に選択します。これにより、GCSリソースの完全なコントロールが可能になります。または、特定の要件（storage.objects.create、storage.objects.delete、storage.objects.update）で独自の役割を作成します。
4. ［保存］を選択し、サービスアカウントにデータ同期バケットへのストレージ管理者権限があることを確認します。

ステップ5：Pendoでプロバイダーを選択する

ストレージバケットにデータを送信する前に、Pendoでターゲットとなる送信先を設定する必要があります。

1. Pendoで、［設定（Settings）］>［データ同期（Data Sync）］の順に進みます。
2. ［宛先に接続（Connect to destination）］を選択します。
3. 右側にスライドアウトするパネルで［Google Cloud Storage］タイルにカーソルを合わせます。
4. ［宛先を選択（Choose destination）］を選択します。パネルには、次のステップがまとめられています。

ステップ6. PendoでGCSアカウントの宛先を設定する

最後に、サービスアカウントキーをアップロードし、バケットURLをPendoに設定します。

1. バケットのURLを入力します。これは、［Google Cloud Storage］>［バケット（Buckets）］で作成されたデータ同期用バケットの構成（CONFIGURATION）タブにあります。概要（Overview ）表の［gsutil URI］行にあるURLをコピーします。
2. ［JSONファイルをアップロード（Upload JSON file）］を選択し、本記事のステップ2で作成しダウンロードしたJSONキーファイルをアップロードします。
3. サービスアカウントとシークレットキーを手動で入力する場合は、次の手順を実行します。
   • JSONキーファイルに対応するサービスアカウントのメール名を入力します。
   • サービスアカウントのJSONキーからprivate_keyの値を入力します。
     
     
4. ［宛先を検証（Validate Destination）］を選択し、入力した認証情報をテストします。
5. 正常に検証されたら、［宛先を作成（Create Destination）］を選択します。

認証情報のローテーション

PendoでGCSの宛先を構成した後に認証情報を更新するには、以下の2つの方法があります。

• Pendo UIを使って手動で更新する。
• 公開APIを使って自動で更新する。

公開APIのエンドポイントを使用してデータ同期の認証情報を更新するには、書き込み権限のあるインテグレーションキーが必要です。

Pendo UIを使う

1. Pendoで、［設定］>［データ同期（Data Sync）］に移動します。
2. ページの右上にある［宛先を管理（Manage destination）］を選択します。
3. JSONファイルの使用または手入力により、新しい認証情報を指定します。

公開APIを使う