Stripe

Stripe コネクタを使用すると、Stripe データセットに対して挿入、削除、更新、読み取りの各オペレーションを実行できます。

始める前に

Stripe コネクタを使用する前に、次の作業を行います。

  • Google Cloud プロジェクトで次の操作を行います。
    • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、ネットワーク接続をご覧ください。
    • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
    • コネクタに使用するサービス アカウントに、次の IAM ロールを付与します。
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      サービス アカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービス アカウントがない場合は、サービス アカウントを作成する必要があります。詳細については、サービス アカウントを作成するをご覧ください。

    • 次のサービスを有効にします。
      • secretmanager.googleapis.com(Secret Manager API)
      • connectors.googleapis.com(Connectors API)

      サービスを有効にする方法については、サービスを有効にするをご覧ください。

    以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

  • Stripe アカウントの作成については、Stripe アカウントを作成するまたはアカウントを作成して Stripe の使用を開始する方法をご覧ください。

コネクタを構成する

コネクタを構成するには、データソース(バックエンド システム)への接続を作成する必要があります。接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

  1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

    [接続] ページに移動

  2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
  3. [ロケーション] セクションで、接続のロケーションを選択します。
    1. リージョン: プルダウン リストからロケーションを選択します

      サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。

    2. [次へ] をクリックします。
  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタ: 使用可能なコネクタのプルダウン リストから [Stripe] を選択します。
    2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 49 文字以内で指定してください。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
    6. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
    7. 必要に応じて、接続ノードの設定を構成します。

      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位(またはレプリカ)です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され(可用性を高めるため)、最大ノード数は 50 に設定されます。

    8. アカウント ID: 使用するアカウントの ID。
    9. プロキシを使用: このチェックボックスを選択して、接続用のプロキシ サーバーを構成し、次の値を構成します。
      • Proxy Auth Scheme: プロキシ サーバーで認証する認証タイプを選択します。次の認証タイプがサポートされています。
        • 基本: 基本的な HTTP 認証。
        • ダイジェスト: ダイジェスト HTTP 認証。
      • Proxy User: プロキシ サーバーでの認証に使用されるユーザー名。
      • プロキシ パスワード: ユーザーのパスワードの Secret Manager シークレット。
      • Proxy SSL Type: プロキシ サーバーへの接続時に使用する SSL タイプ。次の認証タイプがサポートされています。
        • 自動: デフォルトの設定。URL が HTTPS URL の場合は、[トンネル] オプションが使用されます。URL が HTTP URL の場合、[なし] オプションが使用されます。
        • 常に: 接続は常に SSL 対応です。
        • なし: 接続は SSL に対応していません。
        • トンネル: 接続はトンネリング プロキシ経由で行われます。プロキシ サーバーがリモートホストへの接続を開き、トラフィックはプロキシを経由するようになります。
      • [Proxy Server] セクションで、プロキシ サーバーの詳細を入力します。
        1. [+ 宛先を追加] をクリックします。
        2. [宛先の種類] を選択します。
          • Host address: 宛先のホスト名または IP アドレスを指定します。

            バックエンドへのプライベート接続を確立する場合は、次のようにします。

    10. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    11. [次へ] をクリックします。
  5. [認証] セクションで、認証の詳細を入力します。

    Stripe 接続は、API Key タイプの認証をサポートしています。[API キー] プルダウンから API キーの Secret Manager のシークレットを選択し、対応するシークレットのバージョンを選択します。

  6. [次へ] をクリックします。
  7. Review: 接続と認証の詳細を確認します。
  8. [作成] をクリックします。

接続構成のサンプル

このセクションでは、Stripe 接続の作成時に構成するさまざまなフィールドのサンプル値を示します。

ライブ API キーの接続タイプ

フィールド名 詳細
ロケーション us-central1
コネクタ Stripe
コネクタのバージョン 1
接続名 stripe-connection
Cloud Logging を有効にする はい
サービス アカウント SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
アカウント ID ACCOUNT_ID
詳細レベル 5
ノードの最小数 2
ノードの最大数 50
ライブ APIKey LIVE_API_KEY
シークレットのバージョン 1

Live API キーの詳細については、Live API キーをご覧ください。

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

  • エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

    ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

  • オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。

    使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

  • アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

システムの上限

Stripe コネクタは、ノードごとに 1 秒あたり 6 件のトランザクションを処理することができ、この上限を超えるトランザクションすべてをthrottlesします。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます(可用性を高めるため)。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

統合で Stripe 接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、Connectors タスクを介して統合で使用できます。

  • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
  • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

操作

このセクションには、コネクタでサポートされているアクションが一覧表示されます。アクションの構成方法については、アクションの例をご覧ください。

ConfirmPaymentIntent アクション

この操作により、支払いインテントを確認できます。

ConfirmPaymentIntent アクションの入力パラメータ

パラメータ名 データ型 必須 説明
PaymentIntentId 文字列 PaymentIntent ID。

ConfirmPaymentIntent アクションの構成方法の例については、アクションの例をご覧ください。

CapturePaymentIntent アクション

この操作により、支払いインテントをキャプチャできます。

CapturePaymentIntent アクションの入力パラメータ

パラメータ名 データ型 必須 説明
PaymentIntentId 文字列 PaymentIntent ID。

ConfirmPaymentIntent アクションの構成方法の例については、アクションの例をご覧ください。

CancelPaymentIntent アクション

この操作により、支払いインテントをキャンセルできます。

CancelPaymentIntent アクションの入力パラメータ

パラメータ名 データ型 必須 説明
PaymentIntentId 文字列 PaymentIntent ID。

CancelPaymentIntent アクションの構成方法の例については、アクションの例をご覧ください。

AttachPaymentMethodToCustomer アクション

この操作により、PaymentMethod オブジェクトを顧客にアタッチできます。

AttachPaymentMethodToCustomer アクションの入力パラメータ

パラメータ名 データ型 必須 説明
PaymentMethodId 文字列 PaymentMethod ID。
CustomerId 文字列 PaymentMethod をアタッチする顧客の ID。

AttachPaymentMethodToCustomer アクションの構成方法の例については、アクションの例をご覧ください。

DetachPaymentMethodFromCustomer アクション

顧客から PaymentMethod オブジェクトを切断します。PaymentMethod が切断されると、支払いに使用することも、顧客に再アタッチすることもできなくなります。

DetachPaymentMethodFromCustomer アクションの入力パラメータ

パラメータ名 データ型 必須 説明
PaymentMethodId 文字列 PaymentMethod ID。

DetachPaymentMethodFromCustomer アクションの構成方法の例については、アクションの例をご覧ください。

FinalizeInvoice アクション

請求書の下書きを仕上げる。

FinalizeInvoice アクションの入力パラメータ

パラメータ名 データ型 必須 説明
InvoiceId 文字列 QuoteInvoice ID。

FinalizeInvoice アクションの構成方法の例については、アクションの例をご覧ください。

FinalizeQuote アクション

見積もりの下書きを確定する。

FinalizeQuote アクションの入力パラメータ

パラメータ名 データ型 必須 説明
SouQuoteIdrcePath 文字列 Quote ID。

FinalizeQuote アクションの構成方法の例については、アクションの例をご覧ください。

AcceptQuote アクション

このアクションにより、見積もりを承認し、承認した見積もりの請求書を生成できます。

AcceptQuote アクションの入力パラメータ

パラメータ名 データ型 必須 説明
QuoteId 文字列 Quote ID。

AcceptQuote アクションの構成方法の例については、アクションの例をご覧ください。

CancelQuote アクション

このアクションにより、下書きの見積もりをキャンセルできます。

CancelQuote アクションの入力パラメータ

パラメータ名 データ型 必須 説明
QuoteId 文字列 Quote ID。

CancelQuote アクションの構成方法の例については、アクションの例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - 支払いインテントを確認する

この例では、指定した支払いのインテントを確認する方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [ConfirmPaymentIntent] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "ReturnUrl": "http://google.com/",
    "PaymentIntentId": "pi_3OggwFANHgX3SHp71AVrNtT3"
    }
  4. アクションが成功すると、ConfirmPaymentIntent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true",
    "id": "pi_3OggwFANHgX3SHp71AVrNtT3",
    "object": "payment_intent",
    "amount": "33000",
    "amount_capturable": "0",
    "amount_received": "33000",
    "canceled_at": null,
    "cancellation_reason": null,
    "capture_method": "automatic",
    "client_secret": "pi_3OggwFANHgX3SHp71AVrNtT3_secret_YEfjrYL5uHQZrGCx66cJbedlA",
    "confirmation_method": "automatic",
    "created": "1707196279",
    "currency": "usd",
    "invoice": null,
    "last_payment_error": null,
    "latest_charge": "ch_3OggwFANHgX3SHp71uYScRAw",
    "level3": null,
    "livemode": "false",
    "next_action": null,
    "on_behalf_of": null,
    "payment_method": "pm_1Oggu6ANHgX3SHp7zaRNKNVL",
    "payment_method_configuration_details": null,
    "payment_method_options.card.installments": null,
    "review": null,
    "setup_future_usage": null,
    "statement_descriptor_suffix": null,
    "status": "succeeded",
    "transfer_data": null,
    "transfer_group": null
    }]

例 - 支払いインテントをキャプチャする

この例では、指定した支払いのインテントをキャプチャする方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CapturePaymentIntent] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "PaymentIntentId": "pi_3Ogh4sANHgX3SHp72YB0YotA"
    }
  4. アクションが成功すると、CapturePaymentIntent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true",
    "id": "pi_3Ogh4sANHgX3SHp72YB0YotA",
    "object": "payment_intent",
    "amount": "33000",
    "amount_capturable": "0",
    "amount_received": "33000",
    "canceled_at": null,
    "cancellation_reason": null,
    "capture_method": "manual",
    "client_secret": "pi_3Ogh4sANHgX3SHp72YB0YotA_secret_jgqc0olEAOTcurQSDeQThJa3X",
    "confirmation_method": "automatic",
    "created": "1707196814",
    "currency": "usd",
    "customer": "cus_Okyi4e7t7BImUL",
    "description": null,
    "invoice": null,
    "last_payment_error": null,
    "latest_charge": "ch_3Ogh4sANHgX3SHp72uGBS7g4",
    "level3": null,
    "livemode": "false",
    "next_action": null,
    "on_behalf_of": null,
    "payment_method": "pm_1Ogh4FANHgX3SHp7GBJJvfGR",
    "payment_method_configuration_details": null,
    "payment_method_options.card.installments": null,
    "payment_method_types": null,
    "processing": null,
    "receipt_email": null,
    "review": null,
    "statement_descriptor_suffix": null,
    "status": "succeeded",
    "transfer_data": null,
    "transfer_group": null
    }]

例 - 支払いインテントをキャンセルする

この例では、指定した支払いのインテントをキャンセルする方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CancelPaymentIntent] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "PaymentIntentId": "pi_3Ogh7HANHgX3SHp738skMdSQ"
    }
  4. アクションが成功すると、CancelPaymentIntent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true",
    "id": "pi_3Ogh7HANHgX3SHp738skMdSQ",
    "object": "payment_intent",
    "amount": "33000",
    "amount_capturable": "0",
    "amount_received": "0",
    "canceled_at": "1707197160",
    "cancellation_reason": null,
    "capture_method": "manual",
    "client_secret": "pi_3Ogh7HANHgX3SHp738skMdSQ_secret_NqQsBexbdyk19ETdMnpQXF19j",
    "confirmation_method": "automatic",
    "created": "1707196963",
    "currency": "usd",
    "customer": "cus_Okyi4e7t7BImUL",
    "description": null,
    "invoice": null,
    "last_payment_error": null,
    "latest_charge": "ch_3Ogh7HANHgX3SHp73LJMZiy5",
    "level3": null,
    "livemode": "false",
    "next_action": null,
    "on_behalf_of": null,
    "payment_method": "pm_1Ogh75ANHgX3SHp79MNT6IHs",
    "payment_method_configuration_details": null,
    "receipt_email": null,
    "review": null,
    "setup_future_usage": null,
    "shipping": null,
    "status": "canceled",
    "transfer_data": null,
    "transfer_group": null
    }]

例 - 顧客にお支払い方法をアタッチする

この例では、指定した顧客にお支払い方法をアタッチする方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [AttachPaymentMethodToCustomer] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "PaymentMethodId": "pm_1OYm2nANHgX3SHp7ihGfm5U8",
    "CustomerId": "cus_PNX7n9xMDsMPH4"
    }
  4. アクションが成功すると、AttachPaymentMethodToCustomer タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true"
    }]

例 - 顧客からお支払い方法を切断する

この例では、顧客からお支払い方法を切断する方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [DetachPaymentMethodFromCustomer] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "PaymentMethodId": "pm_1OYm2nANHgX3SHp7ihGfm5U8"
    }
  4. アクションが成功すると、DetachPaymentMethodFromCustomer タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true"
    }]

例 - 請求書を確定する

この例では、請求書を確定する方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [FinalizeInvoice ] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "InvoiceId": "in_1OhnXRANHgX3SHp73ufStlXy"
    }
  4. アクションが成功すると、Finalize Invoice タスクの connectorOutputPayload レスポンス パラメータには次と似たような値が含まれます。

    [{
    "Success": "true",
    "id": "in_1OhnXRANHgX3SHp73ufStlXy",
    "object": "invoice",
    "account_country": "US",
    "account_name": "ZBTA_US_SAPDPA_TestAccount",
    "billing_reason": "manual",
    "charge": null,
    "collection_method": "charge_automatically",
    "created": "1707459976",
    "currency": "usd",
    "discounts": null,
    "due_date": null,
    "effective_at": "1707460034",
    "ending_balance": "0",
    "footer": null,
    "lines.data": null,
    "lines.has_more": "false",
    "lines.total_count": "0",
    "livemode": "false",
    "next_payment_attempt": null,
    "number": "F3C0E263-0004",
    "on_behalf_of": null,
    "paid": "true",
    "paid_out_of_band": "false",
    "payment_intent": null,
    }]

例 - 見積もりを確定する

この例では、見積もりを確定させる方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [FinalizeQuote] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "QuoteId": "qt_1ObiPfANHgX3SHp7KT7DXaJe"
    }
  4. アクションが成功すると、FinalizeQuote タスクの connectorOutputPayload レスポンス パラメータには次と似たような値が含まれます。

    [{
    "Success": "true"
    }]

例 - 見積もりを承認する

この例では、見積もりを承認する方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [AcceptQuote] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "QuoteId": "qt_1ObmqKANHgX3SHp7ahHydwav"
    }
  4. アクションが成功すると、AcceptQuote タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "InvoiceId": "in_1Obmr5ANHgX3SHp7HKi6bJDu",
    "Success": "true"
    }]

例 - 見積もりをキャンセルする

この例では、見積もりをキャンセルする方法を示します。

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CancelQuote] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "QuoteId": "qt_1Obmu3ANHgX3SHp7as57wBLf"
    }
  4. アクションが成功すると、CancelQuote タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    [{
    "Success": "true"
    }]

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - すべての顧客を一覧表示する

この例では、Customer エンティティ内のすべての顧客を一覧表示します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity リストから Customer を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。
  4. 必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。 フィルタ句の値は、常に単一引用符(')内で指定します。

例 - 顧客レコードを取得する

この例では、指定した顧客レコードを取得します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Customer を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] フィールドに cus_OxHsz0u5bCGWuy を入力します。

    ここで、cus_OxHsz0u5bCGWuyCustomer エンティティ内の一意のレコード ID です。

例 - 支払いインテントを作成する

この例では、PaymentIntent エンティティに支払いインテントを作成します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から PaymentIntent を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "PaymentMethod": "pm_1OXN5YANHgX3SHp7Q5Y0rb39",
    "Currency": "usd",
    "Amount": 1500.0
    }

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータには次に似た値が含まれます。

    {
    "Id": "pi_3OXN69ANHgX3SHp70tgsxkuR"
    }

例 - 顧客レコードを更新する

この例では、指定した顧客の詳細を更新します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Customer を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
    {
    "Name": "John"
    }
  5. [エンティティ ID] をクリックし、[デフォルト値] フィールドに「cus_OxHsz0u5bCGWuy」と入力します。

    統合に成功すると、コネクタタスクの connectorOutputPayload フィールドには次に似た値が含まれます。

    {
    "Id": "cus_OxHsz0u5bCGWuy"
    }

例 - 顧客レコードを削除する

この例では、指定した顧客を Customer エンティティから削除します。

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Customer を選択します。
  3. [Delete] オペレーションを選択し、[完了] をクリックします。
  4. [EntityId] をクリックし、[デフォルト値] フィールドに「cus_OxIqiMh1W335rE」と入力します。

Terraform を使用して接続を作成する

Terraform リソースを使用して、新しい接続を作成できます。

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

接続作成用の Terraform テンプレートのサンプルを表示するには、サンプル テンプレートをご覧ください。

Terraform を使用してこの接続を作成する場合は、Terraform 構成ファイルで次の変数を設定する必要があります。

パラメータ名 データ型 必須 説明
proxy_enabled BOOLEAN False 接続用のプロキシ サーバーを構成するには、このチェックボックスをオンにします。
proxy_auth_scheme ENUM False ProxyServer プロキシへの認証に使用する認証タイプです。サポートされている値は、BASIC、DIGEST、NONE です。
proxy_user STRING False ProxyServer プロキシへの認証に使用されるユーザー名です。
proxy_password SECRET False ProxyServer プロキシの認証に使用されるパスワード。
proxy_ssltype ENUM False ProxyServer プロキシへの接続時に使用する SSL のタイプです。サポートされている値は AUTO、ALWAYS、NEVER、TUNNEL です。
account_id STRING False 使用する請求先アカウントの ID。
詳細度 STRING False 接続の詳細レベルは 1~5 です。詳細レベルが高いと、すべての通信の詳細(リクエスト、レスポンス、SSL 証明書)がログに記録されます。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

次のステップ