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 ...
                                  • CRM for Everyoneとは

                                    CRM for Everyoneは、Zoho CRMを営業チームだけでなく、組織内の複数のチームと連携しながら利用するための機能です。複数のチームでスムーズに連携して、迅速な顧客対応を行うことで、顧客体験価値を高めることが可能です。 ...
                                  • Zoho CRMポータルでのSAML認証によるシングルサインオン(SSO)の概要

                                    この記事では、SAMLを使用したシングルサインオン(SSO)の基本的な概要を説明します。 Zoho CRMのポータルユーザーに対してシングルサインオンを実際に有効にする手順については、「Zoho CRMポータルでのSAML認証によるシングルサインオン(SSO)の設定方法」の記事をご参照ください。 対応しているプラン 用語の説明 対応しているプラン エンタープライズ アルティメット パッケージ製品(Zoho CRM PlusまたはZoho One) 試用版:対応していません。 ...
                                  • HubSpotとZoho CRMの連携

                                    Zoho CRMのHubSpot拡張機能を利用すると、Zoho CRMの画面においてHubSpotのデータを表示できます。Zoho CRMからHubSpotに連絡先や見込み客を追加することもできます。この連携により、HubSpotとZoho CRMのデータ(見込み客と連絡先)を簡単に同期できます。 メモ: この拡張機能は、Zoho CRMの[見込み客]タブと[連絡先]タブに対してのみ利用できます。 Zoho ...
                                  • GoCardlessとZoho CRMの連携

                                    GoCardlessでは、顧客からの支払いに関する処理を効率よく管理することができます。決済後すぐに顧客の支払い口座から代金が引き落とされ、指定した口座で代金を受け取ることが可能です。Zoho CRMのGoCardless拡張機能を利用すると、Zoho CRMから直接顧客に請求書を送信したり、支払いを受け取ったりできるようになります。顧客からの支払いは、GoCardlessアカウントに関連付けられている銀行口座に直接入金されます。 拡張機能のインストール GoCardless拡張機能は、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.