COQL(CRM Object Query Language)で発生する一般的なエラーとその原因

COQL(CRM Object Query Language)で発生する一般的なエラーとその原因

COQLの動作を検証/テストするためのスクリプトのサンプル(最小限必要な内容):

queryMap = Map();
query = 'select Last_Name from Contacts where Last_Name is not null'; queryMap.put('select_query', query);
response = invokeUrl [
      url: coqlurl
      type: POST
      parameters:queryMap.toString()
      connection: 'zcrm' ];
info response;

エラーメッセージの例:{'code':'INVALID_REQUEST','details':{},'message':'unable to process your request. please verify whether you have entered proper method name, parameter and parameter values.','status':'error'}

エラー発生時の確認事項:
1.APIのバージョンが適切かどうかをご確認ください。また、バージョン2(v2)とバージョン3(v3)の両方での動作をご確認ください。
2.外部連携の機能を利用してZoho OAuthの認証を行っている場合、認証の対象範囲(スコープ)においてCOQLが有効になっているかどうかをご確認ください。
3.COQLのすべてのリクエストでは、WHERE句が必須です。WHERE句を明示的に使用する必要がない場合でも必ず何らかの形で指定してください。なお、その場合は、取得結果に影響がないような条件を付加することで対応できます。例:where Last_Name is not null
4.APIではすべてのタブがサポートされていますが、COQLではすべてのタブはサポートされていません。COQLでサポートされているタブは以下のとおりです(2022年7月時点)。

見込み客、連絡先、取引先、商談、タスク、予定、通話、見積書、受注書、発注書、請求書、商品、価格表、仕入先、問い合わせ、ソリューション、キャンペーン、カスタムタブ

    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

                                  • HubSpotからZoho CRMへのデータ移行

                                    APIとインスタンスURLを使用するだけで、HubSpotからZoho CRMにデータを移行できます。APIキーを入力することで、移行の処理を実行できます。なお、移行の処理の実行中も他の操作は可能です(移行の処理はバックグラウンドで実行されます)。移行が完了すると、Zoho CRMから通知メールが送信されます。移行の取り消しや再実行は、3回まで可能です。 APIトークンを生成するには HubSpotアカウントにログインします。 [Settings](設定)→[Account ...
                                  • Zoho CRMのZoho Contracts拡張機能

                                    Zoho CRMとZoho Contractsの連携用の拡張機能を利用すると、Zoho CRM上で契約書を作成したり、契約書のステータスを確認したりすることができます。取引先との契約を担当する管理者や営業担当者が、契約業務を円滑に行うことが可能です。Zoho ...
                                  • Zoho CRMアカウントの削除

                                    さまざまな理由でZoho CRMアカウントを利用を停止したり、不要なアカウントを削除したりする必要がある場合は、Zoho CRMアカウントを削除できます。同様に、組織のユーザーが組織のZoho CRMアカウントを利用しなくなった場合は、アカウントを無効にしたり、削除したりできます。 Zoho CRMアカウントを削除する前の留意事項 アカウントを削除する前に、以下の点について必ずご確認ください: 無料プランを個人で利用している場合は、ユーザーや個人アカウントをすぐに削除できます。 ...
                                  • CRM for Everyoneの操作画面

                                    CRM for Everyoneでは、Zoho CRMの操作画面が新しくなりました。 新しい操作画面は、以下の2つの部分に分かれています。 メニュー:こちらから各種タブにすばやくアクセスできます。 メインの画面:実際にデータを表示したり、処理を実行したりする画面です。メニューで選択した内容が表示されます。 たとえば、画面左側のメニューで[商談]タブを選択すると、メインの画面には商談データの一覧が表示されます。 メインの画面 ...
                                  • CRM for Everyoneに関するよくある質問

                                    Zoho CRMとCRM for Everyoneは、同じサービスですか? それとも、CRM for Everyoneは、Zoho CRMとは別の新しいサービスですか? CRM for Everyoneは、現在のZoho CRMの新バージョンです。別の新しいサービスではありません。現在のZoho CRMに操作性の改善や機能の拡張を施したものが、CRM for Everyoneです。 CRM for Everyoneによる機能の改善と拡張 直感的に操作できる画面:より多くの人がZoho ...

                                  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.