このページは Cloud Translation API によって翻訳されました。

Marketo

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

始める前に

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

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）
  サービスを有効にする方法については、サービスを有効にするをご覧ください。
以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。

コネクタを構成する

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

Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
[接続] ページに移動
[+ 新規作成] をクリックして [接続の作成] ページを開きます。
[ロケーション] セクションで、接続のロケーションを選択します。
1. リージョン: プルダウンリストからロケーションを選択します
  コネクタをサポートしているリージョンは次のとおりです。
  サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。
2. [次へ] をクリックします。
[接続の詳細] セクションで、次の操作を行います。
1. コネクタ: 使用可能なコネクタのプルダウンリストから [Marketo] を選択します。
2. コネクタのバージョン: 使用可能なバージョンのプルダウンリストからコネクタのバージョンを選択します。
3. [接続名] フィールドに、接続インスタンスの名前を入力します。
  接続名は次の条件を満たす必要があります。
  - 接続名には英字、数字、ハイフンを使用できます。
  - 文字は小文字のみを使用できます。
  - 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
  - 接続名は 49 文字以内で指定してください。
4. 必要に応じて、接続インスタンスの [説明] を入力します。
5. サービスアカウント: 必要なロールを持つサービスアカウントを選択します。
6. 必要に応じて、接続ノードの設定を構成します。
  - ノードの最小数: 接続ノードの最小数を入力します。
  - ノードの最大数: 接続ノードの最大数を入力します。
  ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
7. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
8. [次へ] をクリックします。
[宛先] セクションに、接続するリモートホスト（バックエンドシステム）の詳細を入力します。
1. 宛先タイプ: 宛先の詳細は、ホストアドレスまたはサービスアタッチメントとして指定できます。次のいずれかの宛先タイプを選択します。
  - ホストアドレス: 宛先のホスト名または IP アドレスを指定する場合。
  - サービスアタッチメント: 内部 IP アドレスのプライベートエンドポイントを指定する場合。サービスアタッチメントを使用すると、外部ネットワークから内部 IP アドレスを非表示にできます。Private Service Connect 機能を使用して、Google Cloud でサービスアタッチメントを作成できます。Private Service Connect の構成については、マネージドサービスを公開するをご覧ください。
  選択した宛先タイプに基づいて、ホストアドレスまたはサービスアタッチメント名を入力します。
  
  他の宛先を入力するには、[+ 宛先を追加] をクリックします。
2. [次へ] をクリックします。
[認証] セクションで、認証の詳細を入力します。
1. [認証タイプ] を選択し、関連する詳細を入力します。
  Marketo 接続でサポートされる認証タイプは次のとおりです。
  - OAuth 2.0 クライアント認証情報
  - ユーザー名とパスワードを指定する
2. [次へ] をクリックします。
Review: 接続と認証の詳細を確認します。
[作成] をクリックします。

認証を構成する

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

OAuth 2.0 クライアント認証情報
- クライアント ID: 作成したアプリ用にコネクタから提供されたクライアント ID。
- クライアントシークレット: 作成した接続されているアプリのクライアントシークレットを含む Secret Manager のシークレットです。

ユーザー名とパスワード
- UserId: Marketo SOAP API のユーザー ID。
- EncryptionKey: Marketo SOAP API 暗号鍵を含む Secret Manager の Secret。

システムの上限

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

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

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
サブスクリプションベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンドシステムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。

統合で Marketo 接続を使用する

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

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

アクション

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

注: すべてのアクションの結果は、統合を実行した後に Connectors タスクの connectorOutputPayload レスポンスパラメータで JSON レスポンスとして利用できます。

AddLandingPageContentSection アクション

ターゲットランディングページにコンテンツセクションを追加します。

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

パラメータ名	データ型	必須	説明
LandingPageId	文字列	正しい	ランディングページの ID
ContentId	文字列	正しい	コンテンツセクションの ID。セクションの HTML ID も指定します。
タイプ	文字列	正しい	コンテンツセクションのタイプ。指定できる値は、Image、Form、Rectangle、Snippet、RichText、HTML です。

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

DeleteLandingPageContentSection アクション

Marketo のランディングページコンテンツのセクションを削除します。

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

パラメータ名	データ型	必須	説明
LandingPageId	文字列	正しい	ランディングページの ID。
ContentId	文字列	正しい	コンテンツセクションの ID。セクションの HTML ID も指定します。

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

UpdateEmailContent アクション

メールのコンテンツを更新します。

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

パラメータ名	データ型	必須	説明
EmailId	文字列	正しい	メールの ID。
FromEmail	文字列	正しい	メールの送信元アドレス
FromName	文字列	正しい	メールの送信者名
ReplyTo	文字列	正しい	メールの Reply-To アドレス
件名	文字列	正しい	メールの件名

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

UpdateLandingPageContentSection アクション

Marketo でランディングページのコンテンツのセクションを追加または更新します。

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

パラメータ名	データ型	必須	説明
タイプ	文字列	正しい	コンテンツセクションのタイプ。有効な値は Image、Form、Rectangle、Snippet、RichText、HTML です。
値	文字列	正しい	コンテンツセクションのタイプ。
LandingPageId	文字列	正しい	ランディングページの ID。
ContentId	文字列	正しい	コンテンツセクションの ID。セクションの HTML ID も指定します。

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

GetImportProgramMembersStatus アクション

Marketo のファイルオペレーションからのインポートプログラムメンバーのステータスを取得します。

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

パラメータ名	データ型	必須	説明
BatchId	文字列	正しい	リードの一括インポートの ID。

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

ScheduleCampaign アクション

指定した時間に実行されるようにバッチキャンペーンをリモートでスケジュール設定します。

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

パラメータ名	データ型	必須	説明
CampaignId	文字列	正しい	スケジュールするバッチキャンペーンの ID。
RunAt	文字列	正しい	キャンペーンを実施する日時。設定されていない場合、キャンペーンは呼び出しから 5 分後に実行されます。

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

ListMembersOfList アクション

リードが Marketo のリストに含まれているかどうかを判断します。

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

パラメータ名	データ型	必須	説明
ListId	文字列	正しい	見込み顧客を確認するリストの ID。
LeadId	文字列	正しい	ListId で指定されたリストに含まれているかどうかを確認するリード ID のカンマ区切りのリスト。

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

AssociateLead アクション

既知の Marketo リードレコードを munchkin Cookie とその関連ウェブアクティビティ履歴に関連付けます

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

パラメータ名	データ型	必須	説明
LeadId	文字列	正しい	関連付ける見込み顧客の ID。
Cookie	文字列	正しい	関連付ける Cookie の値

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

MergeLeads アクション

2 つ以上の既知の見込み顧客レコードを 1 つの見込み顧客レコードに統合します。

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

パラメータ名	データ型	必須	説明
WinningLeadId	文字列	正しい	成約したリードレコードの ID
LoosingLeadId	文字列	正しい	失注したリード ID のカンマ区切りのリスト

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

GetImportLeadsStatus アクション

Marketo のファイルからのリードのインポートオペレーションのステータスを取得します。

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

パラメータ名	データ型	必須	説明
BatchId	文字列	正しい	リードの一括インポートの ID。

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

CancelExportJob アクション

エクスポートジョブをキャンセルします。

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

パラメータ名	データ型	必須	説明
JobId	文字列	正しい	エクスポートジョブの ID。
タイプ	文字列	正しい	BulkExtract のオブジェクトタイプ。使用可能な値は、Activities、Leads、ProgramMembers です。

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

EnqueueExportJob アクション

エクスポートジョブをキューに追加し、コンピューティングリソースが使用可能になったときにジョブを開始します。

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

パラメータ名	データ型	必須	説明
JobId	文字列	正しい	エクスポートジョブの ID。
タイプ	文字列	正しい	BulkExtract のオブジェクトタイプ。使用可能な値は、Activities、Leads、ProgramMembers です。指定できる値は、Activities、Leads、ProgramMembers です。

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

GetExportJobStatus アクション

エクスポートジョブのステータスを返します。ジョブのステータスは、[完了] または [失敗] のステータスに達してから 30 日間利用できます。

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

パラメータ名	データ型	必須	説明
JobId	文字列	正しい	エクスポートジョブの ID。
タイプ	文字列	正しい	BulkExtract のオブジェクトタイプ。使用可能な値は、Activities、Leads、ProgramMembers です。指定できる値は、Activities、Leads、ProgramMembers です。

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

CreateEmailTemplate アクション

新しいメールテンプレートを作成します。

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

パラメータ名	データ型	必須	説明
FolderId	文字列	正しい	フォルダの ID
FolderType	文字列	正しい	フォルダのタイプ。
名前	文字列	正しい	メールテンプレートの名前。親フォルダ内で一意である必要があります。
ファイル	文字列	正しい	マルチパートファイル。テンプレートの HTML コンテンツ。

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

UpdateLeadProgramStatus アクション

ターゲットプログラムのリードのリストのプログラムステータスを変更します。この API でステータスを変更できるのは、プログラムの既存のメンバーのみです。

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

パラメータ名	データ型	必須	説明
ProgramId	文字列	正しい	スケジュールするバッチキャンペーンの ID。
LeadIds	文字列	正しい	入力用のリード ID のカンマ区切りリスト。
ステータス	文字列	正しい	レコードのプログラムステータス。

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

RemoveLeadsFromList アクション

Marketo のリストから見込み顧客を削除します。

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

パラメータ名	データ型	必須	説明
ListId	文字列	正しい	見込み顧客を削除するリストの ID。
LeadId	文字列	正しい	ListId で指定されたリストから削除するリード ID のカンマ区切りのリスト。

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

ImportCustomObjectsFromFile アクション

ファイルから Marketo にカスタムオブジェクトをインポートします。

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

パラメータ名	データ型	必須	説明
ファイル	文字列	正しい	Marketo にインポートするカスタムオブジェクトを含むファイルへのパス（例: C:\temp\custom_object_import.csv）。
TableName	文字列	正しい	カスタムオブジェクトテーブルの名前。例: CustomObject_test
形式	文字列	正しい	カスタムオブジェクトを Marketo にインポートするために使用されるファイルの形式。使用できる値は csv、tsv、ssv です。
コンテンツ	文字列	正しい	File が指定されていない場合にアップロードする InputStream としてのコンテンツ。

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

アクションの例

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

例 - AddLandingPageContentSection

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddLandingPageContentSection ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "LandingPageId": "1005",
  "ContentId": "1120",
  "Type": "HTML"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、CampaignTest タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Id": "1130",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

例 - DeleteLandingPageContentSection

[Configure connector task] ダイアログで、[Actions] をクリックします。
[DeleteLandingPageContentSection] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "LandingPageId": "1005",
  "ContentId": "1009"
} 
```

この例では、特定の Object レコードを示します。アクションが成功すると、DeleteLandingPageContentSection タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

例 - UpdateEmailContent

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateEmailContent ] アクションを選択してから、[完了] をクリックします。

[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。

 {
  "EmailId": "1001",
  "FromName": "test",
  "FromEmail": "222larabrown@gmail.com",
  "Subject": "TestSubject Line",
  "ReplyTo": "222larabrown@gmail.com"
}

この例では、特定の Object レコードを示します。アクションが成功すると、UpdateEmailContent タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Id": "1001",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

例 - UpdateLandingPageContentSection

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateLandingPageContentSection ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "Type": "HTML",
  "Value": "
Test Update
",
  "LandingPageId": "1005",
  "ContentId": "1120"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、UpdateLandingPageContentSection タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Id": "1005",
  "json:repeatelementorder": "id",
  "requestsuccess": "true",
  "@affectedrows": "1"
}]

例 - GetImportProgramMembersStatus

[Configure connector task] ダイアログで、[Actions] をクリックします。
[GetImportProgramMembersStatus ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "BatchId": "1029"
} 
```

この例では、特定の Object レコードを示します。アクションが成功すると、GetImportProgramMembersStatus タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "BatchId": "1029",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "3",
  "Message": "Import succeeded, 3 records imported (3 members), 3 warning.",
  "importid": "1029",
  "requestsuccess": "true"
}]

例 - ScheduleCampaign

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ScheduleCampaign ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "CampaignId": "1065",
  "RunAt": "2024-05-23T18:05:00+0000"
} 
```

この例では、特定の Object レコードを示します。アクションが成功すると、ScheduleCampaign タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Success": "true",
  "id": "1065",
  "json:repeatelementorder": "id",
  "requestsuccess": "true"
}]

例 - ListMembersOfList

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ListMembersOfList ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "ListId": "1003",
  "LeadId": "13,25,21"
} 
```

この例では、特定の Object レコードを示します。アクションが成功すると、ListMembersOfList タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "LeadId": "13",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "13",
  "requestsuccess": "true"
}, {
  "LeadId": "25",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "25",
  "requestsuccess": "true"
}, {
  "LeadId": "21",
  "Status": "notmemberof",
  "ReasonCode": null,
  "ReasonMessage": null,
  "id": "21",
  "requestsuccess": "true"
}]

例 - AssociateLead

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AssociateLead ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "LeadId": 582.0,
  "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、AssociateLead タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
 [{
  "Status": "Success"
}]

例 - MergeLeads

[Configure connector task] ダイアログで、[Actions] をクリックします。
[MergeLeads ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
 {
  "LoosingLeadId": "10",
  "WinningLeadId": "45"
} 
```

この例では、特定の Object レコードを示します。アクションが成功すると、MergeLeads タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
  [{
  "Status": "Success"
}]

例 - GetImportLeadsStatus

[Configure connector task] ダイアログで、[Actions] をクリックします。
[GetImportLeadsStatus ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "BatchId": "1022"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、GetImportLeadsStatus タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
 [{
  "BatchId": "1022",
  "Status": "Complete",
  "NumOfLeadsProcessed": "3",
  "NumOfRowsFailed": "0",
  "NumOfRowsWithWarning": "0",
  "Message": "Import succeeded, 3 records imported (3 members)",
  "importid": "1022",
  "requestsuccess": "true"
}]

例 - エクスポートジョブをキャンセルする

[Configure connector task] ダイアログで、[Actions] をクリックします。
[CancelExportJob ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "Type": "Leads"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、CancelExportJob タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b",
  "JobStatus": "Cancelled",
  "Format": "CSV",
  "CreatedAt": "2024-05-28T05:45:13Z",
  "StartedAt": null,
  "QueuedAt": null,
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

例 - EnqueueExportJob

[Configure connector task] ダイアログで、[Actions] をクリックします。
[EnqueueExportJob ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "Type": "Leads"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、EnqueueExportJob タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303",
  "JobStatus": "Queued",
  "Format": "CSV",
  "CreatedAt": "2024-05-27T12:12:53Z",
  "QueuedAt": "2024-05-27T12:13:20Z",
  "exportid": null,
  "json:repeatelementorder": null,
  "status": null,
  "requestsuccess": null
}]

例 - GetExportJobStatus

[Configure connector task] ダイアログで、[Actions] をクリックします。
[GetExportJobStatus ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、GetExportJobStatus タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

例 - CreateEmailTemplate

[Configure connector task] ダイアログで、[Actions] をクリックします。
[CreateEmailTemplate ] アクションを選択してから、[完了] をクリックします。

[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。

{
  "FolderId": 27.0,
  "FolderType": "Folder",
  "Content": "\n\n\n \n
My First Heading
\n
My first paragraph.

\n \n\n",
  "Name": "Test1718166502676",
  "Filename": "FileName1718166502678"
}

この例では、特定の Object レコードを示します。アクションが成功すると、CreateEmailTemplate タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Id": "1048",
  "createdat": "2024-06-12T04:28:23Z+0000",
  "folder_type": "Folder",
  "workspace": "Default",
  "folder_foldername": "Templates",
  "name": "Test1718166502676",
  "version": "2",
  "requestsuccess": "true",
  "url": "https://app-abc.marketo.com/#ET1048B2ZN27",
  "folder_value": "27",
  "updatedat": "2024-06-12T04:28:23Z+0000",
  "status": "draft"
}]

例 - UpdateLeadProgramStatus

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateLeadProgramStatus ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "ProgramId": "1002",
  "Status": "Member",
  "LeadIds": "3"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、UpdateLeadProgramStatus タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "Success": "true",
  "id": "3",
  "status": "updated",
  "requestsuccess": "true"
}]

例 - RemoveLeadsFromList

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveLeadsFromList ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
 {
  "ListId": "1026",
  "LeadId": "57"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、RemoveLeadsFromList タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "LeadId": "57",
  "Status": "skipped",
  "ReasonCode": "1015",
  "ReasonMessage": "Lead not in list",
  "id": "57",
  "requestsuccess": "true"
}]

例 - ImportCustomObjectsFromFile

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ImportCustomObjectsFromFile ] アクションを選択してから、[完了] をクリックします。
[データマッピング] セクションで Open Data Mapping Editor をクリックし、Input フィールドに次のような値を入力します。
```
{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Type": "Leads"
}
```

この例では、特定の Object レコードを示します。アクションが成功すると、ImportCustomObjectsFromFile タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 
[{
  "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4",
  "Format": "CSV",
  "CreatedAt": "2024-05-23T10:12:09Z",
  "JobStatus": "Created",
  "QueuedAt": null,
  "StartedAt": null,
  "FinishedAt": null,
  "NumberOfRecords": null,
  "FileSize": null,
  "exportid": null,
  "status": null,
  "requestsuccess": null
}]

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

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

リストオペレーションを使用し、データ量が多くなると予想される場合は、LeadsLists、LeadPrograms、Activities、LandingPageContentSec、LeadChanges、LeadChangesFields、Emails、LandingPages、Forms、Programs、Leads、LandingPageTemplateCon、OpportunityRoles、SalesPersons、Tokens、ListStaticMemberShip、Opportunities、LeadChangesAttributes、Segments のエンティティにフィルタ句を指定することをおすすめします。また、結果セットを並べ替えるには、まずフィルタ句を適用する必要があります。

例 - すべてのメールを一覧表示する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [メール] を選択します。
[List] オペレーションを選択してから、[完了] をクリックします。

例 - 単一の SmartCampaigns を取得する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから SmartCampaigns を選択します。
[Get] オペレーションを選択し、[完了] をクリックします。
エンティティ ID を「Get single SmartCampaigns」に設定します。エンティティ ID を設定するには、[データマッピング] の [データマッパー] セクションで [データマッピングエディタを開く] をクリックし、[入力値] フィールドに 1002 を入力し、EntityId をローカル変数として選択します。

例 - メールを削除する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [メール] を選択します。
[Delete] オペレーションを選択し、[完了] をクリックします。
エンティティ ID を「メールを削除」に設定します。エンティティ ID を設定するには、[データマッピング] の [データマッパー] セクションで [データマッピングエディタを開く] をクリックし、[入力値] フィールドに 1048.0 を入力し、EntityId をローカル変数として選択します。

例 - メールを作成する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [メール] を選択します。
[Create] オペレーションを選択し、[完了] をクリックします。

[タスク] の [データマッパー] セクションで、OpenDataMapping エディタをクリックし、field: に次のような値を入力します。

{ "Template": 1.0, "FolderId": 1002.0, "Name": "Test Email", "FolderType": "Program" }

Running this example, returns a response similar to the following in the Connector task's connectorOutputPayload output variable:

{
"Id": "1048.0"
}

例 - EmailTemplates を更新する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから EmailTemplates を選択します。
[Update] オペレーションを選択し、[完了] をクリックします。
EntityID を設定して、EmailTemplates を更新します。EntityID を設定するには、[タスク] の [データマッパー] セクションで [EntityID] をクリックし、該当するフィールドに「1034.0」と入力します。
[タスク] の [データマッパー] セクションで、OpenDataMapping エディタをクリックし、field: に次のような値を入力します。
```
 
{
"Name": "temp email updated",
"Description": "updation"
}
```

この例を実行すると、コネクタタスクの connectorOutputPayload 出力変数で次のようなレスポンスが返されます。

{
"Id": 1034.0
}

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

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

Marketo

始める前に

コネクタを構成する

認証を構成する

システムの上限

統合で Marketo 接続を使用する

アクション

AddLandingPageContentSection アクション

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

DeleteLandingPageContentSection アクション

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

UpdateEmailContent アクション

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

UpdateLandingPageContentSection アクション

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

GetImportProgramMembersStatus アクション

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

ScheduleCampaign アクション

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

ListMembersOfList アクション

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

AssociateLead アクション

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

MergeLeads アクション

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

GetImportLeadsStatus アクション

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

CancelExportJob アクション

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

EnqueueExportJob アクション

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

GetExportJobStatus アクション

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

CreateEmailTemplate アクション

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

UpdateLeadProgramStatus アクション

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

RemoveLeadsFromList アクション

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

ImportCustomObjectsFromFile アクション

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

アクションの例

例 - AddLandingPageContentSection

例 - DeleteLandingPageContentSection

例 - UpdateEmailContent

例 - UpdateLandingPageContentSection

例 - GetImportProgramMembersStatus

例 - ScheduleCampaign

例 - ListMembersOfList

例 - AssociateLead

例 - MergeLeads

例 - GetImportLeadsStatus

例 - エクスポート ジョブをキャンセルする

例 - EnqueueExportJob

例 - GetExportJobStatus

例 - CreateEmailTemplate

例 - UpdateLeadProgramStatus

例 - RemoveLeadsFromList

例 - ImportCustomObjectsFromFile

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

例 - すべてのメールを一覧表示する

例 - 単一の SmartCampaigns を取得する

例 - メールを削除する

例 - メールを作成する

例 - EmailTemplates を更新する

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

次のステップ

例 - エクスポートジョブをキャンセルする

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