カルーセルテンプレート

複数のカラムオブジェクトをスクロールして閲覧できるカルーセルメッセージを送信します。

カルーセルは多言語に対応しており、メンバーの言語設定に合わせて表示を切り替えることができます。

カルーセルの構造は下記の通りです。

structure_carousel

参考

  • すべてのカラムに対して Action 数は同一に設定してください。
  • 画像またはタイトルを設定する場合には、すべてのカラムで一律に設定してください。

Request Content {#carousel-request}

common {#carousel-request-common}

パラメータタイプ説明
typestring"carousel"
required
imageAspectRatiostring画像の比率
すべてのカラムに適用。
• "rectangle": 1.51:1 (既定値)
• "square": 1:1
imageSizestring画像のサイズ
すべてのカラムに適用。
• "cover": 画像領域全体に画像を表示(既定値)。画像領域に収まらない部分は切り詰められる。
• "contain": 画像領域に画像全体を表示。縦長の画像では左右に、横長の画像では上下に余白を表示
columnsarrayカルーセルのオブジェクトリスト
最大：10 個
required
columns[].originalContentUrlstring画像 URL ( PNG 形式、HTTPS のみ)
originalContentUrl、fileId のいずれか一方を選択。
最大サイズ：1MB
最大 1,000 文字
columns[].fileIdstring画像のファイル ID
originalContentUrl、fileId のいずれか一方を選択。
最大サイズ：1MB
columns[].titlestringタイトル
最大 40 文字
columns[].textstringテキスト
• 画像とタイトルがない場合、最長：4 行、120 文字
• 画像またはタイトルがある場合、最長：2 行、60 文字
required
columns[].defaultActionAction Objectimage、title、text エリアを押した時の動作
columns[].actionsarray<Action Object>Action が定義されたボタン
最大：3 個
required

参考

  • カルーセル本文の最大文字数を超過していない場合であっても、最大行数を超過した場合には超過分の文字列が表示されません。
  • そのため、デバイスの画面サイズ、文字タイプ等によってカルーセル本文に表示される文字数が減少することがあります。

multi language {#carousel-request-multilang}

パラメータタイプ説明
columns[].i18nOriginalContentUrls[]array多言語の画像 URL リスト
columns[].i18nOriginalContentUrls[].languagestring言語コード
required
columns[].i18nOriginalContentUrls[].originalContentUrlstring画像 URL (PNG 形式、HTTPS のみ)
最大サイズ：1MB
最大 1,000 文字
required
columns[].i18nFileIds[]array多言語の画像のファイル ID リスト
columns[].i18nFileIds[].languagestring言語コード
required
columns[].i18nFileIds[].fileIdstring画像のファイル ID
最大サイズ：1MB
required

Request Example {#carousel-request-example}

example_carousel

{  "content": {    "type": "carousel",    "columns": [{      "originalContentUrl": "https://example.com/1.png",      "title": "LINE WORKS",      "text": "Press the button to visit",      "defaultAction": {        "type":"uri",        "uri":"https://line-works.com"      },      "actions": [{        "type":"uri",        "label":"Visit",        "uri":"https://line-works.com"      }]    }, {      "originalContentUrl": "https://example.com/2.png",      "title": "LINE WORKS",      "text": "Business chat with LINE connection",      "defaultAction": {        "type":"uri",        "uri":"https://line-works.com"      },      "actions": [{        "type":"uri",        "label":"Talk",        "uri":"https://talk.worksmobile.com"      }]    }]  }}