スニペット

最終更新日： 2026年10月8日

作成対象：

管理

スニペットは、電子メールやランディングページに埋め込むことができる、再利用可能なHTMLコンポーネントです。動的コンテンツ用にスニペットをセグメント化することができます。スニペットはテンプレートを使用せず、他のMarketo アセット内で作成およびデプロイできます。

クエリ

ID🔗または閲覧によってスニペットをクエリします。 APIは名前によるクエリのメソッドを提供しません。両方のエンドポイントは、承認済みまたはドラフトのバージョンを取得するためにstatus フィールドを受け入れます。

ID 別

GET /rest/asset/v1/snippet/{id}.json?status=approved

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"fa0f#14b04375f0a",
   "result":[
      {
         "id":83,
         "name":"BYkHVJEedl",
         "description":"yzSLvNFyrmeVmyLzqryUfGlDOJTnvyyfsQTXPDCGdCwcWUlfoCNApUqYgwZGElrUFoxBHJcMdXdqTKvtjtfsmPgokyRgVLeHyJCw",
         "createdAt":"2015-01-19T22:01:52Z+0000",
         "updatedAt":"2015-01-19T22:01:52Z+0000",
         "folder":{
            "type":"Folder",
            "value":662
         },
         "status":"approved",
         "workspace":"Default"
      }
   ]
}

参照

GET /rest/asset/v1/snippets.json?maxReturn=3

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"f9cc#14b04376181",
   "result":[
      {
         "id":23,
         "name":"ADJvMLBMpS",
         "description":"XkzFUVLXVHrojLGLJVLPpwguOXuDvhAqaaSkBUVzgHrgDhqqRzyXlULIXSHJvfBHjCSaMwjyEdrdxcjFCRoNFVvdBBTDfSrUJzaR",
         "createdAt":"2015-01-15T20:10:39Z+0000",
         "updatedAt":"2015-01-15T20:10:39Z+0000",
         "url": null,
         "folder":{
            "type":"Folder",
            "value":620,
            "folderName": "Snippets"
         },
         "status":"draft",
         "workspace":"Default"
      },
      {
         "id":46,
         "name":"Biswa Snippet",
         "description":"",
         "createdAt":"2015-01-16T05:18:55Z+0000",
         "updatedAt":"2015-01-16T05:19:27Z+0000",
         "url": null,
         "folder":{
            "type":"Folder",
            "value":630,
            "folderName": "Snippets"
         },
         "status":"draft",
         "workspace":"Default"
      },
      {
         "id":12,
         "name":"dJJQkKbUYq",
         "description":"VXuHkYMREHrhxUSgYbKfaNeLisdFxOromCXQNrgmModvkuoyZdQjtAbXxDUbBvoDVCZmAVbasiHyWoWfTwgrGxnzpKepGrAUvfen",
         "createdAt":"2015-01-15T05:12:33Z+0000",
         "updatedAt":"2015-01-15T05:12:33Z+0000",
         "url": null,
         "folder":{
            "type":"Folder",
            "value":615,
            "folderName": "Snippets"
         },
         "status":"draft",
         "workspace":"Default"
      }
   ]
}

クエリコンテンツ

スニペット IDでスニペットコンテンツを取得します。

GET /rest/asset/v1/snippet/{id}/content.json

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"5c50#14b04376159",
   "result":[
      {
         "type":"HTML",
         "content":"draft testUpdateSnippetContent1 HTML Content"
      },
      {
         "type":"Text",
         "content":"draft testUpdateSnippetContent1 Text Content"
      }
   ]
}

応答には、タイプ HTMLまたはDynamicContentのセクションが含まれています。 Text型のセクションを含めることもできます。

作成と更新

スニペットアセットとそのコンテンツを別々に作成します。まず、create snippet エンドポイントを呼び出します。説明はオプションです。データをJSONではなくx-www-form-urlencodedとして渡します。

POST /rest/asset/v1/snippets.json

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

name=Test Snippet 09 - deverly&folder={"id":395,"type":"Folder"}&description=This is a test snippet

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "bd57#14e231ee3a1",
    "result": [
        {
            "id": 13,
            "name": "Test Snippet 09 - deverly",
            "description": "This is a test snippet",
            "createdAt": "2015-06-24T01:11:43Z+0000",
            "updatedAt": "2015-06-24T01:11:43Z+0000",
            "url": "https://app-abm.marketo.com/#SN13B2ZN395",
            "folder": {
                "type": "Folder",
                "value": 395,
                "folderName": "Snippets"
            },
            "status": "draft",
            "workspace": "Default"
        }
    ]
}

スニペットコンテンツをIDで追加または置換します。コンテンツの種類はText、HTML、またはDynamicContentです。

Textの場合、content パラメーターにプレーンテキストを渡します。
HTMLの場合、content パラメーターにマークアップを渡します。
DynamicContentの場合、contentをスニペットに関連付けられたセグメントのIDに設定します。

POST /rest/asset/v1/snippet/{id}/content.json

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

type=HTML&content=draft testUpdateSnippetContent1 HTML Content

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"73d9#14b04376139",
   "result":[
      {
         "id":82
      }
   ]
}

メタデータを更新するには、スニペット IDを指定します。更新できるのは、名前と説明のみです。

POST /rest/asset/v1/snippet/{id}.json

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

name=Test Snippet&description=New Description

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"9ad0#14b043762b1",
   "result":[
      {
         "id":82,
         "name":"Test Snippet",
         "description":"New Description",
         "createdAt":"2015-01-19T22:01:52Z+0000",
         "updatedAt":"2015-01-19T22:01:53Z+0000",
         "url": "https://app-abm.marketo.com/#SN3B2ZN395",
         "folder":{
            "type":"Folder",
            "value":662,
            "folderName": "Snippets"
         },
         "status":"draft",
         "workspace":"Default"
      }
   ]
}

動的コンテンツ

スニペットは、1つの完全なコンテンツセクションを表し、1つの動的セクションのみを含めることができます。このセクションには、関連するセグメント内の各セグメントの内部セクションを含めることができます。

スニペットには1つの動的セクションしか含めることができないので、スニペット IDでその動的コンテンツをクエリします。

GET /rest/asset/v1/snippet/{id}/dynamicContent.json

{
    "success": true,
    "warnings": [ ],
    "errors": [ ],
    "requestId": "ae3#14c2b499111",
    "result": [
        {
            "createdAt": "2015-03-13T06:24:35Z+0000",
            "updatedAt": "2015-03-17T20:29:42Z+0000",
            "id": 70,
            "segmentation": 1001,
            "content": [
                {
                    "id": "Nzk*",
                    "segmentId": 1001,
                    "segmentName": "Area",
                    "content": "Sample HTML for Area",
                    "type": "HTML"
                },
                {
                    "id": "Nzk*",
                    "segmentId": 1001,
                    "segmentName": "Area",
                    "content": "Sample Text for Area",
                    "type": "Text"
                },
                {
                    "id": "Nzk*",
                    "segmentId": 1002,
                    "segmentName": "Default",
                    "content": "Sample HTML for Default",
                    "type": "HTML"
                },
                {
                    "id": "Nzk*",
                    "segmentId": 1002,
                    "segmentName": "Default",
                    "content": "Sample Text for Default",
                    "type": "Text"
                }
            ]
        }
    ]
}

承認

スニペットは、承認、承認の削除、ドラフトの破棄のためのエンドポイントを提供します。スニペットは承認前にドラフトステータスである必要があります。

承認

POST /rest/asset/v1/snippet/{id}/approveDraft.json

{
    "success": true,
    "warnings": [ ],
    "errors": [ ],
    "requestId": "11903#14db1af2f6c",
    "result": [
        {
            "id": 3,
            "name": "Test Snippet 02 - deverly",
            "description": "hey this is a test snippet!",
            "createdAt": "2015-06-02T00:32:37Z+0000",
            "updatedAt": "2015-06-02T00:32:37Z+0000",
            "url": "https://app-abm.marketo.com/#SN3B2ZN395",
            "folder": {
                "type": "Folder",
                "value": 395,
                "folderName": "Snippets"
            },
            "status": "approved",
            "workspace": "Default"
        }
    ]
}

未承認

unapprove エンドポイントは、承認済みスニペットに対してのみ使用できます。

POST /rest/asset/v1/snippet/{id}/unapprove.json

{
    "success": true,
    "warnings": [ ],
    "errors": [ ],
    "requestId": "7d20#14db1c7a2a9",
    "result": [
        {
            "id": 89,
            "name": "Test Snippet 01 - deverly",
            "description": "",
            "createdAt": "2015-05-15T19:01:22Z+0000",
            "updatedAt": "2015-05-15T19:07:07Z+0000",
            "url": "https://app-abm.marketo.com/#SN1B2ZN395",
            "folder": {
                "type": "Folder",
                "value": 395,
                "folderName": "Snippets"
            },
            "status": "draft",
            "workspace": "Default"
        }
    ]
}

下書きを破棄

スニペットを破棄するには、メールがドラフトステータスである必要があります。承認済みスニペットは破棄できません。

POST /rest/asset/v1/snippet/{id}/discardDraft.json

{
   "success":true,
   "warnings":[ ],
   "errors":[ ],
   "requestId":"674c#14b043760de",
   "result":[
      {
         "id":88
      }
   ]
}

複製

スニペット 🔗を複製するには、名前、ソーススニペット ID、フォルダーを指定します。説明はオプションです。ソースに承認済みのバージョンがない場合、エンドポイントはドラフトを複製します。

POST /rest/asset/v1/snippet/{id}/clone.json

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

name=Test Snippet Clone 3 - deverly&folder={"id":395,"type":"Folder"}&description=This is a test snippet

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "21c9#14e2327e33d",
    "result": [
        {
            "id": 14,
            "name": "Test Snippet Clone 3 - deverly",
            "description": "This is a test snippet",
            "createdAt": "2015-06-24T01:21:33Z+0000",
            "updatedAt": "2015-06-24T01:21:33Z+0000",
            "url": "https://app-abm.marketo.com/#SN14B2ZN395",
            "folder": {
                "type": "Folder",
                "value": 395,
                "folderName": "Snippets"
            },
            "status": "draft",
            "workspace": "Default"
        }
    ]
}

recommendation-more-help

marketo-developer-help