Salesforce Marketing Cloud

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

準備

Salesforce Marketing Cloud コネクタを使用する前に、以下の作業を行ってください。

  • Google Cloud プロジェクトで次の操作を行います。
    • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
    • コネクタを構成するユーザーに 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）

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

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

コネクタを構成する

接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

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

    [接続] ページに移動

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

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

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

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

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

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

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

    8. API Integration Type: OAuth フローの許可タイプ。有効なエントリは、Server-to-Server と Web-App です。
    9. Account Id: 目的のビジネス ユニットのアカウント ID（MID）
    10. Display Child Data Extensions: 子アカウントのデータ拡張機能が設定されている場合は、表示します。
    11. Instance: 使用される Salesforce Marketing Cloud API のインスタンス。
    12. List Data Extensions: データ拡張機能をテーブルとしてリスト化するかどうかを決定するブール値。
    13. Query All Accounts: イベントに関連するすべてのアカウント（親とすべての子を含む）を照会します。
    14. Schema: 接続先の Salesforce Marketing Cloud サーバーのバージョンを指定します。
    15. Subdomain: Salesforce Marketing Cloud API のサブドメイン。
    16. Use Legacy Authentication: 以前の認証を使用して Salesforce Marketing Cloud REST API に接続するかどうかを決定するブール値。
    17. （省略可）[詳細設定] セクションで、[プロキシを使用する] チェックボックスをオンにして、接続用のプロキシ サーバーを構成し、次の値を構成します。
      • 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 アドレスを指定します。

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

    18. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
    19. [NEXT] をクリックします。
  5. [認証] セクションで、認証の詳細を入力します。
    1. [認証タイプ] を選択し、関連する詳細を入力します。

      Salesforce Marketing Cloud 接続でサポートされる認証タイプは次のとおりです。

      • ユーザー名とパスワードを指定する
      • OAuth 2.0 - クライアント認証情報
      • OAuth 2.0 - 認証コード

        • これらの認証タイプの構成方法については、認証を構成するをご覧ください。

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

認証を構成する

使用する認証に基づいて詳細を入力します。

  • ユーザー名とパスワード
    • ユーザー名: コネクタのユーザー名
    • パスワード: コネクタに関連付けられたパスワードを含む Secret Manager の Secret。
  • OAuth 2.0 - クライアント認証情報
    • クライアント ID: 作成したアプリのクライアント ID。
    • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret Manager のシークレットです。
    • シークレットのバージョン: クライアント シークレットのバージョン。
  • OAuth 2.0 - 認証コード
    • クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
    • スコープ: 必要なスコープのカンマ区切りのリスト。
    • クライアント シークレット: アクセス トークンのリクエストに使用されるクライアント シークレット。
    • シークレットのバージョン: クライアント シークレットのバージョン。
    • 認証 URL: クライアントの作成時に生成された認証 URL

Salesforce Marketing Cloud を構成する

Salesforce Marketing Cloud を設定するには、既存のアカウントにログインするか、Salesforce Marketing Cloud ログインを使用して新しいアカウントを作成します。コミュニティ サポートと追加情報については、Trailblazer Community を参照してください。Salesforce Marketing Cloud REST API については、Salesforce Marketing Cloud REST API をご覧ください。Salesforce Marketing Cloud SOAP API については、SOAP API をご覧ください。

API クライアントを作成する

  1. Salesforce Marketing Cloud のプロフィール ページで、[設定] をクリックします。
  2. 左側のパネルで [Installed Packages] を選択し、[New] をクリックします。
  3. 統合の名前と説明を入力します。
  4. [統合タイプ] で [サーバー間] を選択します。
  5. [保存] をクリックします。

    6. クライアント ID、クライアント シークレット、SOAP ベース URL、REST ベース URL などの詳細を表示できます。

基本認証 - 接続タイプ

次の表に、基本認証接続タイプのサンプル構成値を示します。

フィールド名 詳細
ロケーション us-east1
コネクタ Salesforce Marketing Cloud
コネクタのバージョン 1
接続名 sfmcconn1
説明 SOAP - ユーザー パスワード
Cloud Logging を有効にする ○
サービス アカウント service-account@my-project.iam.gserviceaccount.com
API 統合タイプ サーバー間
スキーマ SOAP
アカウント ID ACCOUNT_ID
Display Child Data Extensions ○
インスタンス s11
データ拡張機能の一覧表示 ○
詳細レベル 5
サブドメイン SUBDOMAIN
ユーザー名 ユーザー名
パスワード パスワード
シークレットのバージョン 1

OAuth 2.0 - 接続タイプ

次の表に、OAuth 2.0 クライアント認証情報の接続タイプのサンプル構成値を示します。

フィールド名 詳細
ロケーション us-east1
コネクタ Salesforce Marketing Cloud
コネクタのバージョン 1
接続名 sfmc-rest-conn
Cloud Logging を有効にする ×
サービス アカウント service-account@my-project.iam.gserviceaccount.com
API 統合タイプ サーバー間
スキーマ REST
アカウント ID ACCOUNT_ID
Display Child Data Extensions ○
インスタンス s11
データ拡張機能の一覧表示 ○
すべてのアカウントをクエリする ○
詳細レベル 4
サブドメイン SUBDOMAIN
クライアント ID CLIENT_ID
クライアント シークレット CLIENT_SECRET
シークレットのバージョン 1

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

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

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

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

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

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

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

システムの上限

Salesforce Marketing Cloud コネクタは、ノードごとに 1 秒あたり最大 7 件のトランザクションを処理でき、この上限を超えるトランザクションをスロットルします。 デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

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

アクション

このセクションでは、Salesforce Marketing Cloud 接続でサポートされているすべてのアクションを一覧表示します。

GetJourneyPublicationStatus アクション

このアクションでは、ジャーニー パブリケーションのステータスを取得します。

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

パラメータ名 データ型 必須 説明
StatusId 文字列 True ジャーニー パブリケーションのステータス ID。

GetJourneyPublicationStatus アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

FireEntryEvent アクション

ジャーニーを開始するエントリ イベントを発生させます。

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

パラメータ名 データ型 必須 説明
ContactKey 文字列 True サブスクライバーまたは連絡先を一意に識別する ID
EventDefinitionKey 文字列 True イベントを作成して保存した後、イベント管理で EventDefinitionKey を見つけます。これは、標準イベントとカスタム イベントの両方に当てはまります。イベント定義キーにピリオドを含めないでください。
データ 文字列 False イベントのプロパティ。カスタム イベントまたはイベントで定義されている場合にのみ必要です。

FireEntryEvent アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

StopJourney アクション

実行中のジャーニーを停止します

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

パラメータ名 データ型 必須 説明
JourneyId 文字列 True 停止するジャーニーの ID（GUID（UUID）形式）
JourneyVersion 整数 True 停止するジャーニーのバージョン番号

StopJourney アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

PublishJourney アクション

PublishJourney アクションは、ジャーニーのバージョンを非同期でパブリッシュする

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

パラメータ名 データ型 必須 説明
JourneyId 文字列 True 停止するジャーニーの ID（GUID（UUID）形式）
JourneyVersion 整数 True 停止するジャーニーのバージョン番号。

PublishJourney アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

CreateTriggeredSend アクション

CreateTriggeredSend アクションは、トリガーされたメール送信の特定のインスタンスを表すトリガーされた送信オブジェクトを作成します。

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

パラメータ名 データ型 必須 説明
キー 文字列 False トリガー送信の関連付けられたトリガー送信定義を定義します。このプロパティは、Marketing Cloud のオブジェクトに割り当てられた外部キーに対応します。
SendId 文字列 False TriggeredSendDefinition の作成時にレスポンスから返される、エントリ イベント送信定義の ID。この ID または外部キーのいずれかが必要です。
FromAddress 文字列 False 送信者として表示されるメールアドレス。
FromName 文字列 False 送信者の名前
ToAddress 文字列 True メッセージ受信者のメールアドレス。
SubscriberKey 文字列 True メッセージ受信者用に定義された固有識別子。
SubscriberAttributes 文字列 False メッセージ用に定義されたサブスクライバーの属性の名前と値のペア。
RequestType 文字列 False 有効な値は ASYNC と SYNC です。定義されていない場合のデフォルト値は ASYNC です。リクエストが非同期で処理されるかどうかを決定します。

CreateTriggeredSend アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

SendTransactionalMessageToRecipient アクション

SendTransactionalMessageToRecipient アクションは、送信定義を介して 1 人の受信者にメッセージを送信します。

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

パラメータ名 データ型 必須 説明
MessageKey 文字列 True ユーザー定義のメッセージ識別子。
DefinitionKey 文字列 True 定義の固有識別子。
RecipientContactKey 文字列 True Marketing Cloud のサブスクライバーの固有識別子。各リクエストには contactKey が含まれている必要があります。既存のサブスクライバー キーを使用することも、受信者のメールアドレスを使用して送信時に作成することもできます。
RecipientTo 文字列 False 受信者のチャンネル アドレス。メールの場合は、受信者のメールアドレス
属性 文字列 False 受信者向けにメッセージをパーソナライズするために使用される情報。鍵ペアとして記述します。属性がプロファイル属性、コンテンツ属性、トリガーされた送信データ拡張機能の属性と一致している

SendTransactionalMessageToRecipient アクションの出力パラメータ

このアクションは、すべての結果を示すレスポンスの本文でステータス 200（OK）を返します。

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

アクションの例

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

例 - ジャーニー パブリケーションのステータスを取得する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [GetJourneyPublicationStatus] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "StatusId": "3acf1f54-5c9e-4719-b7f7-bfc2e5caf10a"
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

     [{
  "Status": "PublishCompleted",
  "Message": null
}]

例 - エントリ イベントを送信してジャーニーを開始する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [FireEntryEvent] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ContactKey": "Email",
  "EventDefinitionKey": "APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c",
  "Data": "{\"Email\": \"usr1@test.com\"}"
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

     [{
  "EventInstanceId": "0d6f6dd1-1aaa-4eec-9727-f99550ab68f9"
}]

例 - 実行中のジャーニーを停止する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [StopJourney] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "JourneyId": "37D2789E-2B1D-433E-8E18-8F47E4D8E865",
  "JourneyVersion": 1.0
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

      [{
  "Success": true
}]

例 - ジャーニーのバージョンをパブリッシュする

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [PublishJourney] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "JourneyId": "0868BF36-3107-460E-9EF1-09633A0592E8",
  "JourneyVersion": 1.0
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

     [{
  "StatusId": "acb1734d-483e-400a-97d7-0501b94f03b2"
}]

例 - ジャーニーを開始するトリガーを作成する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [CreateTriggeredSend] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Key": "BU27_SendDefinition1",
  "ToAddress": "usr1@test.com",
  "SubscriberKey": "107",
  "SubscriberAttributes": "{\"FirstName\": \"John\", \"LastName\": \"P\"}"
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

     [{
  "Success": "True",
  "RecipientSendId": "5d06edb1-d07c-48ad-a1f2-d6350eb863f8",
  "Messages": "Queued"
}]

例 - 単一の受信者にメッセージを送信する

  1. [Configure connector task] ダイアログで、[Actions] をクリックします。
  2. [SendTransactionalMessageToRecipient] アクションを選択してから、[完了] をクリックします。
  3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "MessageKey": "T9999009",
  "DefinitionKey": "Send-Definition-SFMC-Demo-2",
  "RecipientContactKey": "107",
  "RecipientTo": "usr1@test.com",
  "Attributes": "FirstName :John"
}

    4. アクションの実行に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

    [{
  "RequestId": "d8fb9e9e-3ae2-412f-b01e-d198433cfc16"
}]

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

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

サポートされているエンティティ オペレーション

このセクションでは、Salesforce Marketing Cloud コネクタでサポートされているエンティティ オペレーションを一覧表示し、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

エンティティ オペレーション
DataExtensionObject_Custom List、Get、Delete、Create、Update
Campaign List、Get、Delete
CampaignAssets List、Get、Delete
Journeys List、Get、Delete、Create、Update
リスト List、Create、Update
パブリケーション リスト
サブスクライバー リスト、作成
SubscriberList リスト
ListSubscriber リスト
JourneyActivities 取得、削除
キャンペーン 作成
アセット List、Get、Delete、Create、Update

例 - すべてのアセットを一覧表示する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Assets を選択します。
  3. [List] オペレーションを選択し、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、お客様の要件に応じて filterClause を設定できます。

    5. フィルタ句の値は単一引用符（'）で囲む必要があり、CategoryName='Content Builder' のように直接渡す必要があります。ここで、CategoryName は列名、Content Builder は値です。

    フィルタ句を使用すると、列に基づいてレコードをフィルタできます。たとえば、レコードをフィルタするには、次のフィルタ句を使用します。Location='US' と region='us-east1'

    場合によっては、エンティティ ID を渡すとエラーがスローされることがあります。このような場合は、id=172 などのフィルタ句を使用できます。

例 - Assets レコードを取得する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Assets を選択します。
  3. [Get] オペレーションを選択し、[完了] をクリックします。
  4. エンティティ ID を 49851.0 に設定します。これは渡されるキーです。エンティティ ID を設定するには、[コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] に 49851.0 を入力します。

    エンティティ ID の値は直接渡す必要があります（Id= 49851.0 など）。ここで、49851.0 は一意の主キー値であり、渡される必要があります。

例 - アセット レコードを削除する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Assets を選択します。
  3. [Delete] オペレーションを選択し、[完了] をクリックします。
  4. エンティティ ID を 49851.0 に設定します。これは渡されるキーです。エンティティ ID を設定するには、[コネクタ] タスクの [タスク入力] セクションで [EntityId] をクリックし、[デフォルト値] に 49851.0 を入力します。

    エンティティ ID の値は直接渡す必要があります（ID= 49851.0 など）。ここで、49851.0 は一意の主キー値であり、渡される必要があります。

例 - DataExtensionObject_Custom レコードを作成する

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

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "StudentID": 1
}

例 - Assets レコードを作成する

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

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": 60188.0
}

例 - Campaigns レコードを作成する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Campaigns を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Name": "Campaigns - Tested via Googlecloud",
  "CampaignCode": "annual2023",
  "Color": "0000ff",
  "Favorite": false
}

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": 247.0
}

例 - Journeys レコードを作成する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Journeys を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Version": 1.0,
  "Name": "API_Journey_Googlecloud_Retest_1",
  "CreatedDate": "2023-04-26 04:20:29.87",
  "ModifiedDate": "2023-05-10 07:45:06.04",
  "LastPublishedDate": "2023-04-26 04:37:18.0",
  "Description": "API_Journey_Googlecloud_Retest_1",
  "WorkFlowApiVersion": 1.0,
  "Tags": null,
  "Goals": "",
  "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
  "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
}

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": "aa03afe4-6a28-481f-bec4-564712127414"
}

例 - List レコードを作成する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から List を選択します。
  3. [Create] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "ID": "04052023.0",
  "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
  "PartnerKey": "null",
  "CreatedDate": "2023-03-16 10:52:48.097",
  "ModifiedDate": "2023-03-17 10:30:34.497",
  "Client_ID": "5.14012689E8",
  "Client_PartnerClientKey": null,
  "ListName": "Googlecloud_Created_Subscriber_List",
  "Description": "null",
  "Category": "15449.0",
  "Type": "Public",
  "CustomerKey": "Googlecloud_BCONE",
  "ListClassification": "ExactTargetList",
  "AutomatedEmail_ID": "null"
}

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": 4052023.0
}

例 - Subscriber レコードを作成する

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

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Success": true
}

例 - DataExtensionObject_Custom レコードを更新する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から DataExtensionObject_Custom を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
"StudentName":"Charlie",
"Rank":"1"
}
  5. エンティティ ID を「103032」に設定します。これは渡される主キーです。エンティティ ID を設定するには、[コネクタ] タスクの [タスク入力] セクションで [entityId] をクリックし、[デフォルト値] に 10 を入力します。

    エンティティに複合ビジネスキーまたは複合主キーがある場合、entityId を指定する代わりに、filterClause を Rank='1' and StudentID='10' に設定することもできます。

    6. 統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
    "StudentID": 1
}

例 - アセット レコードを更新する

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

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": 52080.0
}

例 - Journeys レコードを更新する

  1. [Configure connector task] ダイアログで、[Entities] をクリックします。
  2. Entity から Journeys を選択します。
  3. [Update] オペレーションを選択してから、[完了] をクリックします。
  4. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。 
    {
  "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
}
  5. エンティティ ID をジャーニーのエンティティに設定します。エンティティ ID を設定するには、[エンティティ ID] をクリックし、[デフォルト値] フィールドに「 0868BF36-3107-460E-9EF1-09633A0592E8」と入力します。

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
}

例 - リストレコードを更新する

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

    統合が成功すると、コネクタタスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

    {
  "ID": 1234.0
}

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

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

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

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

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

パラメータ名 データ型 必須 説明
apiintegration_type ENUM False OAuth フローの付与タイプ。有効なエントリは、Server-to-Server と Web-App です。サポートされている値は、Server-to-Server、Web-App です。
schema ENUM True 接続する Salesforce Marketing Cloud API を指定します。サポートされている値は、REST と SOAP です。
account_id STRING False 目的のビジネス ユニットのアカウント ID（MID）
display_child_data_extensions BOOLEAN False 子アカウントのデータ拡張機能が設定されている場合は表示されます。
インスタンス STRING False 使用される Salesforce Marketing Cloud API のインスタンス。注: インスタンスが s10 より大きい場合は、サブドメインを指定する必要があります。
list_data_extensions BOOLEAN False データ拡張機能をテーブルとしてリスト化するかどうかを決定するブール値。
query_all_accounts BOOLEAN False イベントに関連するすべてのアカウント（親とすべての子を含む）をクエリします。
詳細度 STRING False 接続の詳細レベルは 1～5 です。詳細レベルが高いと、すべての通信の詳細（リクエスト、レスポンス、SSL 証明書）がログに記録されます。
サブドメイン STRING False Salesforce Marketing Cloud API のサブドメイン。
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 です。

インテグレーションで Salesforce Marketing Cloud 接続を使用する

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

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

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

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

次のステップ