Flow Service API を使用した Google Cloud Storage ベース接続の作成

最終更新日： 2025年10月14日

トピック：
Sources

作成対象：

Developer

ベース接続は、ソースと Adobe Experience Platform 間の認証済み接続を表します。

このチュートリアルでは、Flow Service API を使用して、Google Cloud Storage のベース接続を作成する手順を説明します。

はじめに

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

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

次の節では、Flow Service APIを使用してGoogle Cloud Storage アカウントに正常に接続するために必要な追加情報を示します。

必要な資格情報の収集

Flow ServiceがGoogle Cloud Storage アカウントに接続するには、次の接続プロパティの値を指定する必要があります。

資格情報

説明

accessKeyId

Experience Platformに対するGoogle Cloud Storage アカウントの認証に使用される61文字の英数字の文字列。

secretAccessKey

Experience Platformに対するGoogle Cloud Storage アカウントの認証に使用される、40文字のベース 64 エンコードされた文字列。

bucketName

Google Cloud Storage バケットの名前。クラウドストレージ内の特定のサブフォルダーへのアクセスを提供する場合は、バケット名を指定する必要があります。

folderPath

アクセス権を付与するフォルダーへのパス。

これらの値について詳しくは、Google Cloud Storage の HMAC キーガイドを参照してください。独自のアクセスキーIDとシークレットアクセスキーを生成する手順については、Google Cloud Storage 概要を参照してください。

Experience Platform APIの使用

Experience Platform APIの呼び出しを正常に行う方法について詳しくは、Experience Platform APIの概要に関するガイドを参照してください。

ベース接続の作成

ベース接続は、ソースの認証情報、接続の現在の状態、一意のベース接続IDなど、ソースとExperience Platform間の情報を保持します。ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。

ベース接続 ID を作成するには、/connections エンドポイントに POST リクエストを実行し、Google Cloud Storage 認証資格情報をリクエストパラメーターの一部として使用します。

TIP

この手順では、バケット名とサブフォルダーへのパスを定義することで、アカウントがアクセスできるサブフォルダーを指定することもできます。

API 形式

POST /connections

リクエスト

次のリクエストは、Google Cloud Storage のベース接続を作成します。

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Google Cloud Storage connection",
      "description": "Connector for Google Cloud Storage",
      "auth": {
          "specName": "Basic Authentication for google-cloud",
          "params": {
              "accessKeyId": "accessKeyId",
              "secretAccessKey": "secretAccessKey",
              "bucketName": "acme-google-cloud-bucket",
              "folderPath": "/acme/customers/sales"
          }
      },
      "connectionSpec": {
          "id": "32e8f412-cdf7-464c-9885-78184cb113fd",
          "version": "1.0"
      }
  }'

プロパティ

説明

auth.params.accessKeyId

Google Cloud Storage アカウントに関連付けられているアクセスキーID。

auth.params.secretAccessKey

Google Cloud Storage アカウントに関連付けられている秘密鍵。

auth.params.bucketName

auth.params.folderPath

アクセス権を付与するフォルダーへのパス。

connectionSpec.id

Google Cloud Storage 接続仕様 ID：32e8f412-cdf7-464c-9885-78184cb113fd

応答

リクエストが成功した場合は、一意の ID（id）を含む、新しく作成した接続の詳細が返されます。このIDは、次のチュートリアルでクラウドストレージデータを確認するために必要です。

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}

次の手順

このチュートリアルに従って、APIを使用してGoogle Cloud Storage接続を作成し、応答本文の一部として一意のIDを取得しました。この接続IDを使用して、Flow Service API🔗を使用してクラウドストレージを探索できます。

recommendation-more-help

experience-platform-help-sources