Merge and Store V1からV2への移行方法は?

Merge and Store V1からV2への移行方法は?

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

なぜMerge and Store V2 APIへ移行する必要があるのか?   

Merge and Store V1 APIでは、マージ処理が完全に完了した後にのみレスポンスが返品済みとなります。しかし、Delugeスクリプトでは最大許容タイムアウトが40秒です。マージにそれ以上の時間がかかる場合、タイムアウトが発生し、DREワークフローが失敗する原因となります。
この制限を解決するために、Merge and Store V2 APIが導入されました。V2では、
  • レスポンスが今すぐvirtual RIDとともに返品され、マージが完了する前でも取得可能です。
  • マージ処理はバックエンドでスケジューリングされ、マージ後のドキュメントはvirtual RIDを利用して保存されます。
  • ユーザーはvirtual RIDを使ってワークフローを継続できます。最終的なマージが完了するまで一時的なコンテンツが利用可能です。
マージのステータスを追跡するには、下記いずれかのレスポンス項目を使用できます。
  • merge_report_data_url
  • merge_report_url
パラメーターおよびスコープはMerge and Store V1と同じです。さらにV2では、「output_settings」パラメーター内に新たなオプションキーとしてmerge_toが追加されており、マージ後のドキュメント保存先を指定できます。

差出人 Merge and Store V1 から V2 への移行方法? 

差出人 Merge and Store V1 から V2 へ移行するには、以下のキーとなる変更を行ってください。
  • Endpoint を更新: API エンドポイントを以下に更新してください: https://{zohoapis_domain}/writer/api/v2/ドキュメント/{{document_id}}/merge/store
  • HTTP メソッド: POST
  • データ内容の形式: マージデータおよび設定情報を JSONリクエスト本文 に含めて送信します。
  • レスポンス処理: 各マージ済みドキュメントの詳細なステータスを含む構造化されたJSONレスポンスが返されます。
API の詳細は、以下のドキュメントをご参照ください: Merge and Store V2 API


    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  • 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リクエストを送信してください。 ...
                                  • なぜmergeAndDownloadタスクまたはAPIでjava.lang.Object例外が発生するのか?その防止方法は?

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 理由: このエラーは、Writerサーバーがマージされたファイルを40秒以内に返品できない場合に発生します。delugeの各APIの実行時間制限は40秒です。 ...
                                  • ライターマージテンプレートでの高度な自動化の設定方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 詳細自動化Flow Builderを活用すると、複数のテンプレートにまたがる動的なドキュメントワークフローを設計できます。生成の自動化、法人ルールに基づくルーティング、ドキュメントの結合、配布や保管の自動化までをシームレスに実現します。 前提条件 ...
                                  • Zoho WriterでDelugeスクリプトを使用してカスタムワークフローを設定する方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho ...
                                  • Zoho CRMでメールマージタスクを実行するためのワークフロールールの作成方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CRMでWriterのメールマージタスクを自動化するには、ワークフフロー ルールを作成します。たとえば、Zoho CRMアカウントでリード登録時にマージと送信タスクを自動化したい場合(各リード登録をマージし、そのリードにメール通知を自動送信するワークフロー ...

                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.