Merge and Store V1からV2への移行方法は？
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
なぜMerge and Store V2 APIへ移行する必要があるのか？
Merge and Store V1 APIでは、マージ処理が完全に完了した後にのみレスポンスが返品済みとなります。しかし、Delugeスクリプトでは許容される最大タイムアウトは40秒です。マージ処理にそれ以上の時間がかかる場合、タイムアウトが発生し、DREワークフローが失敗する原因となります。
この制限を克服するため、Merge and Store V2 APIが導入されました。V2では以下のようになります。
-
レスポンスは今すぐ返品済みとなり、マージ処理が完了する前でも仮想RIDが返却されます。
-
マージ処理はバックエンドでスケジュールされ、マージされたドキュメントは仮想RIDを用いて保存されます。
-
ユーザーは仮想RIDを利用してワークフローを継続できます。最終的なマージが完了するまで、一時的なコンテンツが利用可能です。
マージのステータスを追跡するには、以下のいずれかのレスポンス項目を使用できます。
-
merge_report_data_url
-
merge_report_url
パラメーターとスコープはMerge and Store V1と同じです。さらに、V2では新たにオプションキーmerge_toが「output_settings」パラメーター内に追加され、マージ後のドキュメント保存先を指定できます。
Merge and Store V1 から V2 への移行方法？
Merge and Store V1 から V2 に移行するには、次のキー変更を行ってください。
-
エンドポイントの更新: APIエンドポイントを以下のURLに更新してください: https://{zohoapis_domain}/writer/api/v2/ドキュメント/{{document_id}}/merge/store
-
HTTP メソッド: POST
-
データ内容の形式: マージデータおよび設定情報を JSONリクエスト本文 に含めて送信します。
-
レスポンスの処理: 各マージ済みドキュメントごとに詳細なステータスを含む構造化されたJSONレスポンスが返されます。
APIの詳細については、以下のドキュメントをご参照ください: Merge and Store V2 API
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
Zoho WorkDrive Resources
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
Related Articles
WriterにおけるMerge&Email、Merge&Sign、Sign、Combine and Store APIの前提条件
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Merge and メール、Merge and Sign、SignまたはCombine and StoreAPIを利用するには、最初にWriter UIの「Automate」パネルにアクセスしてからAPIリクエストを送信してください。 ...Zoho WriterでDelugeスクリプトを使用してカスタムワークフローを設定する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho ...Zoho Writerで文書を統合して保存する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Merge and Storeオプションを利用すると、接続済みデータ元内の各データに対して自動的にパーソナライズされたドキュメントを生成し、保存できます。マージが完了すると、それぞれのドキュメントはZoho WorkDrive、Zoho ...Zoho CRMでメールマージタスクを実行するためのワークフロールールの作成方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CRMでWriterのメールマージタスクを自動化するには、ワークフフロー ルールを作成します。たとえば、Zoho CRMアカウントでリード登録時にマージと送信タスクを自動化したい場合（各リード登録をマージし、そのリードにメール通知を自動送信するワークフロー ...Zoho Writerのマージテンプレートでrecord_idパラメータを使用する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho Writerのrecord_idパラメーターをマージテンプレートで使用することで、record_id値に基づいて必要な項目の値を簡単に取得できます。この新しいパラメーターを利用すれば、Delugeコードでテンプレート内の頻度項目を手動でマッピングする必要がありません。 ...