MailChimp

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

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

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

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

• オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
  • リスト
  • 取得
  • 作成
  • 更新
  • 削除

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

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

アクション

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

CampaignTest アクション

MailChimp キャンペーンのテストメールを送信します。

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

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

CampaignSend アクション

MailChimp キャンペーンを送信します。

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

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

CampaignPause アクション

MailChimp RSS キャンペーンを一時停止します。

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

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

CampaignResume アクション

MailChimp RSS キャンペーンを再開します。

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

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

アクションの例

例 - CampaignTest

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

   {
   "CampaignID": "4bd7a9abac",
   "TestEmails": "sample@gmail.com",
   "SendType": "plaintext"
   }
   

アクションが成功すると、CampaignTest タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

{
"Success": "true"
}

例 - CampaignSend

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

   {
   "CampaignID": "1699382f6d"
   }
   

アクションが成功すると、CampaignSend タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

{
"Success": "true"
}

例 - CampaignPause

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

   {
   "CampaignID": "4bd7a9abac"
   }

アクションが成功すると、CampaignPause タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

 {
"Success": "true"
}

例 - CampaignResume

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

   {
   "CampaignID": "4bd7a9abac"
   }

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

{
"Success": "true"
}

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

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

例 - すべてのキャンペーンを一覧表示する

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

例 - 1 つの自動化を取得する

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

   ここで、1ac204985e は Automations エンティティの一意のレコード ID です。

例 - キャンペーンを削除する

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

例 - キャンペーン フォルダを作成する

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

   {
   "Name": "CampaignFolderCreated1707812599459"
   }
   Running this example, returns a response similar to the following in the connector
   task's connectorOutputPayload output variable:
   {
   "Id": "650469bb07"
   }
   

例 - ファイル マネージャー フォルダを更新する

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

   {
   "Name": "MyNewFolder9"
   }

5. [エンティティ ID] をクリックし、[デフォルト値] フィールドに「18159」と入力します。

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

   {
   "Id": "18159"
   }