更新情報のお知らせです！
これまで画面プレビュー機能では、プレビューURLにコンテンツIDやドラフトキーを埋め込むことができましたが、コンテンツのフィールド値を利用することはできませんでした。
今回のアップデートにより、テキストフィールドや数値、セレクトフィールドなどの値をプレビューURLに埋め込めるようになりました。
設定方法
API設定の「画面プレビュー」から、プレビューURLを設定します。
URL内に {FIELD:フィールドID} の形式で指定すると、画面プレビューを開く際に、対象コンテンツのフィールド値に置き換えられます。なお、フィールド値はURLエンコードされた状態で埋め込まれます。
設定例
例えば、slug というフィールドIDを設定している場合、以下のように指定できます。
https://example.com/preview/{FIELD:slug}
対象コンテンツの slug フィールドの値が sample-article の場合、以下のURLでプレビューが開かれます。
https://example.com/preview/sample-article
※ フィールドIDは大文字と小文字が区別されます。
※ プレビューURLに個人情報や機密情報などを含むフィールドを指定する場合は、情報の取り扱いにご留意ください。（ブラウザの閲覧履歴への保存など）
対応するフィールド
以下のフィールドの値を利用できます。
- テキストフィールド
- 数値フィールド
- セレクトフィールド（単一選択）
- コンテンツ参照（参照先のコンテンツID）
コンテンツ参照の場合は、以下のように .id を指定することで参照先のコンテンツIDを利用できます。
{FIELD:フィールドID.id}
※ 複数コンテンツ参照や、参照先コンテンツの任意のフィールド値には対応していません。
コンテンツ参照先の読み取り権限がない場合
URLにコンテンツ参照 {FIELD:フィールドID.id} が含まれる場合、画面プレビューを実行するユーザーに参照先コンテンツの読み取り権限がなければ、画面プレビューは中止されます。
おわりに
コンテンツのフィールド値をプレビューURLに利用できるようになり、画面プレビューの設定の自由度が高まりました。ぜひご活用ください！
