ドキュメントMarketo 開発者ガイド

フォーム

最終更新日： 2026年5月13日

作成対象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

Forms エンドポイントリファレンス

フォームフィールドエンドポイントリファレンス

フォームエンドポイントを使用して、リモートシステムからフォームを管理します。 フォームには、複数のオブジェクトタイプを含めることができます。

  • フォーム
  • フィールド
  • Fieldsets
  • 表示ルール
  • フォローアップページルール

クエリ

Formsでは、標準のアセット取得方式（id、名前、および参照）がサポートされています。 フォーム応答には、フィールドリストを除くすべてのフォームプロパティが含まれます。

ID 別

フォーム idをパス パラメーターとしてIDでフォームを取得に渡します。 エンドポイントは、一致するフォームレコードを返します。

GET /rest/asset/v1/form/{id}.json

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "948f#154e3bad8e3",
    "result": [
        {
            "id": 736,
            "name": "newForm",
            "description": "test",
            "createdAt": "2016-05-24T17:05:54Z+0000",
            "updatedAt": "2016-05-24T17:05:54Z+0000",
            "url": "https://app-devlocal1.marketo.com/#FO736B2",
            "status": "draft",
            "theme": "simple",
            "language": "French",
            "locale": "fr_FR",
            "progressiveProfiling": false,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 293,
                "folderName": "yyLNLHzgOM"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Envoyer",
            "waitingLabel": "Veuillez patienter"
        }
    ]
}

名前別

フォーム nameを渡して名前でフォームを取得します。 エンドポイントは、一致するフォームレコードを返します。

GET /rest/asset/v1/form/byName.json?name=newForm

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "948f#154e3bad8e3",
    "result": [
        {
            "id": 736,
            "name": "newForm",
            "description": "test",
            "createdAt": "2016-05-24T17:05:54Z+0000",
            "updatedAt": "2016-05-24T17:05:54Z+0000",
            "url": "https://app-devlocal1.marketo.com/#FO736B2",
            "status": "draft",
            "theme": "simple",
            "language": "French",
            "locale": "fr_FR",
            "progressiveProfiling": false,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 293,
                "folderName": "yyLNLHzgOM"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Envoyer",
            "waitingLabel": "Veuillez patienter"
        }
    ]
}

参照

Get Formsは、標準のAsset API参照パターンに従っています。 次のオプションのフィルターをサポートしています。

  • status: approved、approved with draftまたはdraftでフィルタリングします。
  • maxReturn：返されるレコードの数を制限します。
  • offset：結果セットをページ化します。
GET /rest/asset/v1/forms.json

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "645d#154e3d499ac",
    "result": [
        {
            "id": 227,
            "name": "aKAUVDfbsX",
            "description": "",
            "createdAt": "2016-05-18T20:36:20Z+0000",
            "updatedAt": "2016-05-18T20:36:20Z+0000",
            "url": "https://app-devlocal1.marketo.com/#FO227B2",
            "status": "draft",
            "theme": "simple",
            "language": "English",
            "locale": "en_US",
            "progressiveProfiling": false,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 293,
                "folderName": "yyLNLHzgOM"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Submit",
            "waitingLabel": "Please Wait"
        },
        {
            "id": 695,
            "name": "AoMXgfFbma",
            "description": "",
            "createdAt": "2016-05-19T18:50:40Z+0000",
            "updatedAt": "2016-05-19T18:50:40Z+0000",
            "url": "https://app-devlocal1.marketo.com/#FO695B2",
            "status": "draft",
            "theme": "simple",
            "language": "English",
            "locale": "en_US",
            "progressiveProfiling": true,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 565,
                "folderName": "WfUvYmlcyT"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Submit",
            "waitingLabel": "Please Wait"
        }
    ]
}

フィールドリスト

フォーム IDを渡して、各フォームのフィールドリストを個別に取得します。

GET /rest/asset/v1/form/{id}/fields.json

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "2165#154eee00d01",
    "result": [
        {
            "id": "FirstName",
            "label": "First Name:",
            "dataType": "text",
            "validationMessage": "This field is required.",
            "rowNumber": 0,
            "columnNumber": 0,
            "maxLength": 255,
            "required": false,
            "formPrefill": true,
            "visibilityRules": {
                "ruleType": "alwaysShow"
            }
        },
        {
            "id": "LastName",
            "label": "Last Name:",
            "dataType": "text",
            "validationMessage": "This field is required.",
            "rowNumber": 1,
            "columnNumber": 0,
            "maxLength": 255,
            "required": false,
            "formPrefill": true,
            "visibilityRules": {
                "ruleType": "alwaysShow"
            }
        },
        {
            "id": "Email",
            "label": "Email Address:",
            "dataType": "email",
            "validationMessage": "Must be valid email. <span class='mktoErrorDetail'>example@yourdomain.com</span>",
            "rowNumber": 2,
            "columnNumber": 0,
            "required": false,
            "formPrefill": true,
            "visibilityRules": {
                "ruleType": "alwaysShow"
            }
        },
        {
            "id": "Profiling",
            "dataType": "profiling",
            "rowNumber": 3,
            "columnNumber": 0
        }
    ]
}

フィールドを更新または削除したり、その動作を変更したりする前に、フォームのフィールドリストを取得します。 後続のリクエストで返されたフィールド IDを使用します。

フィールドのタイプ

UI タイプ
API 名
チェックボックス
checkbox
ラジオボタン
radio
テキストエリア
textarea
選択リスト
picklist
文字列
string
メール
email
日付
date
数字
number
Double
double
電話
phone
URL
URL
通貨
currency
チェックボックス
single_checkbox
スライダ
range

依存関係

フォーム idをパス パラメーターとして使用するフォームを取得に渡します。 エンドポイントは、フォームに依存するアセットを返します。

フォームを使用できるアセットタイプは次のとおりです。

  • ランディングページ
  • スマートリスト
  • スマートキャンペーン
  • レポート
  • メールプログラム
GET /rest/asset/v1/form/{id}/usedBy.json

{
    "success": true,
    "errors": [],
    "requestId": "fdf4#17285b25038",
    "warnings": [],
    "result": [
        {
            "id": 1038,
            "name": "LP Redirect Rules Program.LP Test 01",
            "type": "Landing Page",
            "status": "approved",
            "updatedAt": "2020-02-23T01:31:21Z+0000"
        }
    ]
}

作成と更新

​ フォームを作成するには、次の2つの必須フィールドを指定します。

  • フォームの親フォルダー。
  • フォーム名。

その他のすべてのパラメーターはオプションで、デフォルト値があります。 新しいフォームには、3つのデフォルト フィールド（名、姓、電子メール）が含まれます。

POST /rest/asset/v1/forms.json

Content-Type: application/x-www-form-urlencoded

name=newForm&description=test&folder={"type": "Folder","id": 293}&language=French

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "948f#154e3bad8e3",
    "result": [
        {
            "id": 736,
            "name": "newForm",
            "description": "test",
            "createdAt": "2016-05-24T17:05:54Z+0000",
            "updatedAt": "2016-05-24T17:05:54Z+0000",
            "url": "https://app-devlocal1.marketo.com/#FO736B2",
            "status": "draft",
            "theme": "simple",
            "language": "French",
            "locale": "fr_FR",
            "progressiveProfiling": false,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 293,
                "folderName": "yyLNLHzgOM"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Envoyer",
            "waitingLabel": "Veuillez patienter"
        }
    ]
}

​ フォームを更新するには、そのIDを渡します。 作成または更新時に、フォームの表示方法を制御する基本スタイル設定パラメーターを設定できます。

POST /rest/asset/v1/form/736.json

Content-Type: application/x-www-form-urlencoded

name=updated name&description=This is a test for updateapi&language=English&progressiveProfiling=true&locale=en_US

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "6307#154e3cf6efe",
    "result": [
        {
            "id": 736,
            "name": "updated name",
            "description": "This is a test for update api",
            "createdAt": "2016-05-24T17:05:54Z+0000",
            "updatedAt": "2016-05-24T17:28:23Z+0000",
            "status": "draft",
            "theme": "simple",
            "language": "English",
            "locale": "en_US",
            "progressiveProfiling": true,
            "labelPosition": "left",
            "fontFamily": "Helvetica",
            "fontSize": "13px",
            "folder": {
                "type": "Folder",
                "value": 293,
                "folderName": "yyLNLHzgOM"
            },
            "knownVisitor": {
                "type": "form",
                "template": null
            },
            "thankYouList": [
                {
                    "followupType": "none",
                    "followupValue": null,
                    "default": true
                }
            ],
            "buttonLocation": 120,
            "buttonLabel": "Submit",
            "waitingLabel": "Please Wait"
        }
    ]
}

フォームエンドポイントを作成および更新しても、既知の訪問者やサンキューページの動作は変更されません。 対応するエンドポイントを使用して、これらの動作を管理します。

フィールドメタデータ

フォームフィールドを追加または編集する前に、ターゲットインスタンスの有効なフィールドを取得します。 フィールド操作では、各フィールドに対して返されるid プロパティを使用します。

リードフィールドの場合は、使用可能なフォームフィールドを取得 エンドポイントを使用します。 応答には、各フィールドのデータタイプと、フィールドがフォームに追加されたときに適用されるデフォルトのメタデータが含まれます。

GET /rest/asset/v1/form/fields.json

{
    "success": true,
    "errors": [],
    "requestId": "176ca#167a9808f4c",
    "warnings": [],
    "result": [
        {
            "id": "AnnualRevenue",
            "isRequired": false,
            "dataType": "currency"
        },
        {
            "id": "City",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Company",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Country",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Description",
            "isRequired": false,
            "dataType": "textarea",
            "maxLength": 32000,
            "visibleRows": 2
        },
        {
            "id": "Email",
            "isRequired": false,
            "dataType": "email"
        },
        {
            "id": "Fax",
            "isRequired": false,
            "dataType": "phone"
        },
        {
            "id": "FirstName",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Industry",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "LastName",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "LeadSource",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "MobilePhone",
            "isRequired": false,
            "dataType": "phone"
        },
        {
            "id": "NumberOfEmployees",
            "isRequired": false,
            "dataType": "int"
        },
        {
            "id": "Phone",
            "isRequired": false,
            "dataType": "phone"
        },
        {
            "id": "PostalCode",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Rating",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "Salutation",
            "isRequired": false,
            "dataType": "picklist",
            "picklistValues": "Mr.,Ms.,Mrs.,Dr.,Prof."
        },
        {
            "id": "State",
            "isRequired": false,
            "dataType": "picklist",
            "picklistValues": "AK::AK,AL::AL,AR::AR,AZ::AZ,CA::CA,CO::CO,CT::CT,DE::DE,FL::FL,GA::GA,HI::HI,IA::IA,ID::ID,IL::IL,IN::IN,KS::KS,KY::KY,LA::LA,MA::MA,MD::MD,ME::ME,MI::MI,MN::MN,MO::MO,MS::MS,MT::MT,NC::NC,ND::ND,NE::NE,NH::NH,NJ::NJ,NM::NM,NV::NV,NY::NY,OH::OH,OK::OK,OR::OR,PA::PA,RI::RI,SC::SC,SD::SD,TN::TN,TX::TX,UT::UT,VA::VA,VT::VT,WA::WA,WI::WI,WV::WV,WY::WY"
        },
        {
            "id": "Street",
            "isRequired": false,
            "dataType": "textarea",
            "maxLength": 2000,
            "visibleRows": 2
        },
        {
            "id": "Title",
            "isRequired": false,
            "dataType": "picklist"
        }
    ]
}

プログラムメンバーのカスタムフィールドの場合は、利用可能なフォームプログラムメンバーフィールドを取得 エンドポイントを呼び出します。 応答には、プログラムメンバーカスタムフィールドデータタイプとデフォルトメタデータが含まれます。

これらのフィールドを使用するには、フォームがDesign Studioではなくプログラムの下にある必要があります。 これらのフィールドを含むフォームを含むランディングページも、プログラムの下にある必要があります。 Design Studio内で作成したり、Design Studioに複製したりすることはできません。

GET /rest/asset/v1/form/programMemberFields.json

{
    "success": true,
    "errors": [],
    "requestId": "109c6#16fa0b9c51a",
    "warnings": [],
    "result": [
        {
            "id": "pMCFCustomField01",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "pMCFCustomField02",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        },
        {
            "id": "myPMCF",
            "isRequired": false,
            "dataType": "string",
            "maxLength": 255
        }
    ]
}

フィールドの編集

各フォームには、フォームの読み込み時にユーザーに表示される編集可能なフィールドのリストがあります。 対応するエンドポイントを使用して、一度に1つのフィールドを追加、更新または削除します。

​ フィールド ​を追加するには、親フォーム IDとフィールド fieldIdを指定します。 その他のすべてのプロパティは空であるか、フィールドのデータタイプとメタデータに基づいてデフォルトを使用します。

データをJSONではなくapplication/x-www-form-urlencodedを使用したPOSTとして送信します。

POST /rest/asset/v1/form/{id}/fields.json

Content-Type: application/x-www-form-urlencoded

fieldId=NumberOfEmployees&maxLength=125&defaultValue=this is default&required=true&fieldWidth=100&validationMessage=hey, you there?&label=employee count&hintText=Hint me&minValue=10

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "1826e#154f41b214c",
    "result": [
        {
            "id": "NumberOfEmployees",
            "label": "employee count",
            "fieldWidth": 100,
            "dataType": "number",
            "defaultValue": "this is default",
            "validationMessage": "hey, you there?",
            "rowNumber": 5,
            "columnNumber": 0,
            "required": true,
            "formPrefill": true,
            "fieldMetaData": {
                "minValue": 10,
                "maxValue": null
            },
            "visibilityRules": {
                "ruleType": "alwaysShow"
            },
            "hintText": "Hint me"
        }
    ]
}

更新プログラムは、フィールドの追加時に使用するのと同じプロパティを編集できます。 また、フォーム IDとfieldIdが必要ですが、更新エンドポイントはfieldIdをクエリパラメーターではなくパスパラメーターとして渡します。

POST /rest/asset/v1/form/{id}/field/LastName.json

Content-Type: application/x-www-form-urlencoded

label=enter the last name here

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "5634#15508303abb",
    "result": [
        {
            "id": "LastName",
            "label": "enter the last name here",
            "dataType": "text",
            "validationMessage": "This field is required.",
            "rowNumber": 0,
            "columnNumber": 0,
            "maxLength": 255,
            "required": false,
            "formPrefill": true,
            "visibilityRules": {
                "ruleType": "alwaysShow"
            }
        }
    ]
}

前の例では、単純な文字列フィールドであるLastNameを更新しています。 その他のフォームフィールドには、より複雑なメタデータがあります。 例えば、Salutationは、項目のリストとデフォルト値を持つselect フィールドです。

選択フィールドを追加または更新する際に、1つの選択肢のisDefault値をtrueに設定します。 それ以外の場合、最初の選択肢には値がなく、Select...というラベルが付けられます。

敬称

リスト項目を更新するには、次の例に示すようにvalues パラメーターを書式設定します。

POST /rest/asset/v1/form/{id}/field/Salutation.json

Content-Type: application/x-www-form-urlencoded

values=[{"label":"Select...","value":"","isDefault":true,"selected":true}, {"label":"MR","value":"MR"}, {"label":"MS","value":"MS"}, {"label":"MRS","value":"MRS"}, {"label":"DR","value":"DR"}, {"label":"PROF","value":"PROF"}]

{
  "success": true,
  "warnings": [ ],
  "errors": [ ],
  "requestId": "71fd#1588d9d1b0c",
  "result": [
    {
      "id": "Salutation",
      "label": "Salutation:",
      "dataType": "select",
      "validationMessage": "This field is required.",
      "rowNumber": 3,
      "columnNumber": 0,
      "required": false,
      "formPrefill": true,
      "fieldMetaData": {
        "multiSelect": false,
        "values": [
          {
            "label": "Select...",
            "value": "",
            "isDefault": true,
            "selected": true
          },
          {
            "label": "MR",
            "value": "MR"
          },
          {
            "label": "MS",
            "value": "MS"
          },
          {
            "label": "MRS",
            "value": "MRS"
          },
          {
            "label": "DR",
            "value": "DR"
          },
          {
            "label": "PROF",
            "value": "PROF"
          }
        ],
        "visibleLines": 1
      },
      "visibilityRules": {
        "ruleType": "alwaysShow"
      }
    }
  ]
}

複雑なフォームフィールドの書式設定方法を決定するには、「フォームにフィールドを追加」応答を使用します。

フィールドの並べ替え

​ フォームフィールドの位置を変更 エンドポイントを使用して、すべてのフォームフィールドを1つの単位として並べ替えます。 エンドポイントには、次の3つのメンバーを持つオブジェクトのJSON配列であるpositionsが必要です。

  • columnNumber
  • rowNumber
  • fieldName。フィールド IDを参照します

フォームフィールドでは、最大3列10行の表のような配置を使用できます。 行と列のインデックスは0から始まるので、最初の行と列の両方で0を使用します。 すべてのフィールドは一意の位置を占める必要があります。

ターゲットフィールドがフィールドセットの場合、positionsのレコードにもfieldListが含まれている必要があります。 このパラメーターは、同じcolumnNumber、rowNumber、fieldNameのメンバーを持つオブジェクトの配列です。

親リストは、フィールドセットを1つのフィールドとして扱います。 fieldListの位置によって、子フィールドの配置が決まります。

POST /rest/asset/v1/form/{id}/reArrange.json

Content-Type: application/x-www-form-urlencoded

positions=[{"columnNumber":0,"rowNumber":0,"fieldName":"FirstName"},{"columnNumber":0,"rowNumber":1,"fieldName":"LastName"}, {"columnNumber":0,"rowNumber":2, "fieldName":"Email"}]

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "bb18#15508ef9c04",
    "result": [
        {
            "id": 764
        }
    ]
}

リッチテキスト

個別のエンドポイント ​を使用して、リッチテキストフィールドを追加します。 multipart/form-data リクエストでコンテンツをHTMLとして渡します。 HTMLには、スクリプト、メタタグまたはリンクタグを含めることはできません。

POST /rest/asset/v1/form/{id}/richText.json

Content-Type: multipart/form-data; boundary=---------------------------9051914041544843365972754266
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="text"
Content-Type: text/html
<div>Fancy Rich Text Component</div>
-----------------------------9051914041544843365972754266--

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "82c8#154f423bf5c",
    "result": [
        {
            "id": "SHRtbFRleHRfMjAxNi0wNS0yN1QxNDozNDoyNC4xMTVa",
            "labelWidth": 260,
            "dataType": "htmltext",
            "rowNumber": 8,
            "columnNumber": 0,
            "visibilityRules": {
                "ruleType": "alwaysShow"
            },
            "text": "<div>Fancy Rich Text Component</div>"
        }
    ]
}

フィールドセット

フィールドセットは、オプションのフィールドグループです。 トップレベルのフィールドリストでは、フィールドセットはポジショニングルールと表示ルール用の1つのフィールドとして扱われます。 例えば、「コンプライアンス要件」フィールドで「はい」を選択すると、HIPAAおよびPCI コンプライアンスのフィールドを含むフィールドセットを表示できます。

フィールドはフォーム内で一意である必要があります。 フォームの親フィールドリストと子フィールドセットの両方に同じフィールドを表示することはできません。

Add Fieldset to Form エンドポイントを使用してフィールドセットを追加します。 次に、フィールドセットがフォーム 🔗の応答の フィールドを取得に表示されます。 フィールドセットにフィールドを追加するには、​ フィールド位置の更新を使用して、フィールドをfieldListに移動します。

これらのエンドポイントの場合は、JSONではなくapplication/x-www-form-urlencodedを使用してPOSTとしてデータを送信します。

表示ルール

表示ルールは、フォームに入力された値に基づいて、訪問者がフィールドを表示できるかどうかを決定します。 各ルールは、フォーム内のsubjectFieldの値とルール内の値のリストを比較します。

フィールドには、1つの表示ルールタイプ（show、hide、またはalwaysShow）を指定できます。 APIは、フィールドのルールを上から下に評価し、最初のルールをtrueに評価して適用します。

表示ルールの変更は、破壊的な更新です。

POST /rest/asset/v1/form/{id}/field/Email/visibility.json

Content-Type: application/x-www-form-urlencoded

visibilityRule={"ruleType":"show", "rules":[{"subjectField": "LastName", "operator": "isNotEmpty", "values": [], "altLabel": "Email:"}]}

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "ab4a#15509030601",
    "result": [
        {
            "formFieldId": "Email",
            "ruleType": "show",
            "rules": [
                {
                    "subjectField": "LastName",
                    "operator": "isNotEmpty",
                    "values": [],
                    "altLabel": "Email:"
                }
            ]
        }
    ]
}

演算子の完全なリストについては、​ フォームフィールドの表示ルールの追加を参照してください。

フォローアップ

動的なフォローアップルールにより、送信時に指定されたフィールド値にもとづいて、訪問者をページにリダイレクトしたり、現在のページに維持したりできます。 サンキューページルールとフォローアップページルールは、同じ動作を参照します。

ルールを、followupType、followupValue、operator、subjectField、valuesおよびdefaultを含むレコードを持つJSON配列として表します。 配列内の1つのレコードのみが、ブール値defaultをtrueに設定できます。 フォームは、訪問者が別のルールに適格でない場合に、そのレコードを使用します。

followupTypeの値はlpまたはurlです。 lp値は、followupValueがMarketo ランディングページ IDであることを示します。 url値は、followupValueが別のページのURLであることを示します。 オペレーターは、件名フィールドの値と指定された値を比較します。

送信ボタン

送信ボタンのスタイル設定を変更するには、送信ボタンを更新 エンドポイントを使用します。 buttonPosition、buttonStyle、labelおよびwaitingLabelを更新できます。 送信が保留中の間、waitingLabelが表示されます。

これは破壊的な更新です。

承認

Formsは、ドラフト承認済みのライフサイクルに従います。 フォームには、ドラフトバージョン、承認済みバージョン、またはその両方を含めることができます。 更新は常にドラフトに適用され、承認後にのみ公開されます。

フォームを承認すると、既存の承認済みバージョンがある場合は、現在のドラフトに置き換えられます。 ライブフォームの承認を解除すると、現在のドラフトが削除され、承認されたバージョンはドラフトのみの状態に格下げされます。 フォームを削除する前に、必ず承認を取り消してください。

プログレッシブプロファイリング

プログレッシブプロファイリングが有効になっている場合、フォームフィールドリストにはProfilingという名前のフィールドセットが含まれます。 「フィールド位置を更新」エンドポイントを使用して、プログレッシブプロファイルリストからフィールドを追加または削除します。

このエンドポイントは破壊的な更新を実行するので、すべてのリクエストにはフォームのすべてのフィールドを含める必要があります。 次の例では、プログレッシブプロファイリングリストにPhoneを追加します。

POST /rest/asset/v1/form/{id}/reArrange.json

Content-Type: application/x-www-form-urlencoded

positions=[{"columnNumber":0,"rowNumber":0,"fieldName":"Email"},{"columnNumber":0,"rowNumber":1,"fieldName":"LastName"},{"columnNumber":0,"rowNumber":2,"fieldName":"Company"},{"columnNumber":0,"rowNumber":3,"fieldName":"Website"},{"columnNumber":0,"rowNumber":4,"fieldName":"Profiling","fieldList":[{"columnNumber":0,"rowNumber":0,"fieldName":"Phone"}]}]

{
    "success": true,
    "errors": [],
    "requestId": "3d6a#164190dbdf2",
    "result": [
        {
            "id": 1031
        }
    ]
}
recommendation-more-help
marketo-developer-help