リリースノート

APIの最小利用制限の拡大

すべてのプランでAPIの最小上限を拡大し、APIの使用環境を改善しました。

この変更の詳細については、APIの制限を参照してください。

リリース日：2014年11月1日

新規メソッド：searchRecords

タブからデータを検索できるように、searchRecordsメソッドを導入しました。この新規メソッドの詳細については、APIガイドを参照してください。

リリース日：2014年10月20日

新規メソッド：getModulesとgetDeletedRecordIds

CRMタブリストとごみ箱にある削除済みデータのIDリストを取得できるように、以下のメソッドを導入しました。

• getModules
• getDeletedRecordIds

これらの新規メソッドの詳細については、APIガイドを参照してください。

リリース日：2014年8月7日

APIリクエスト数

Zoho CRM API は、Zoho CRMの全プランで使用できます。APIを使用するには、CRMアカウントのZoho CRM認証トークンが必要です。APIサービスにアクセスする権限があることを確認してください。権限がない場合は、CRM管理者にお問い合わせください。

API制限

重要事項：

• たとえば、無料プランでgetRecordsメソッドを使用すると、1リクエストあたり最大200データを取得できるため、1日あたり合計50,000データ（250 x 200 = 50,000データ）を取得できます。
• getSearchRecordsまたはgetCVRecordsメソッドを使用する場合、ご利用のZoho CRMプランに関係なく、1日あたり最大250呼び出しを送信できます。

リリース日：2013年6月15日

新規メソッド：開発者APIを使用した、データへのファイルまたは写真の添付

ファイルや写真をデータに添付できるように、以下のメソッドを導入しました。

• uploadFile
• downloadFile
• deleteFile
• uploadPhoto
• downloadPhoto
• deletePhoto

開発者APIフォーラムでは、発表内容をすべて確認できます。
これらの新規メソッドの詳細については、APIガイドを参照してください。

リリース日：2012年7月11日

認証トークンの導入

開発者APIの実装において、認証トークンがサポート対象になりました。

このトークンは永続的なトークンです。削除を選択した場合にのみ無効になります。

認証トークンの詳細については、APIガイドを参照してください。

リリース日：2012年3月5日

新規メソッドの導入

開発者APIに以下のメソッドを導入しました。

• getFields
• getRelatedRecords
• updateRelatedRecords

開発者APIフォーラムでは、発表内容をすべて確認できます。これらの新規メソッドの詳細については、APIガイドを参照してください。

リリース日：2012年1月27日

2011年4月28日以降はHTTPSのみをサポート：

現時点では、HTTPとHTTPSの両方をサポートしながら開発者APIを実装しています。4週間後、すべてのAPIトランザクションをHTTPS経由でのみサポートし、HTTPプロトコルを完全に廃止する予定です。この追加のSSL、256ビットセキュリティシステムによって、データ転送時のセキュリティの問題から外部サービス連携を保護できます。

2011年4月28日以降、プログラムでHTTPを使用し続けた場合、APIリクエストは実行されません。そのため、開発者コミュニティの皆さまには、できるだけ早くHTTPSリクエストを使ってZoho CRM APIを呼び出すようにすることを強くお勧めします。

新規パラメーター「version」の導入

開発者APIメソッドに、versionという新しいパラメーターを導入しました。このパラメーターを使用すると、「キャンペーンのデータ元」項目の値を取得できます。
［キャンペーン］タブの最近の強化では、キャンペーンメンバー機能をサポートするためにキャンペーンのデータ元項目が削除されました。この強化の内容は次のとおりです。

• 複数の見込み客と連絡先をキャンペーンに関連付けることができるようになりました。
• 複数の見込み客/連絡先を1件ずつ関連付けるのではなく、インポートすることで時間を節約できるようになりました。
• キャンペーンのデータ元項目は、［見込み客］タブと［連絡先］タブで使用できなくなりました。

この強化の詳細については、移行ガイドをご覧ください。

APIリクエストにおけるversionパラメーターの使い方

メソッドのversionパラメーターを使用すると、API実装でキャンペーンのデータ元項目の値を取得できます。
値が「1」の「version」パラメーターは、キャンペーンのデータ元項目からもレスポンスを取得します。
値が「2」の「version」パラメーターは、現在のAPI実装に基づいてレスポンスを取得します。この場合、「キャンペーンのデータ元」項目の値は取得されません。

これは必須パラメーターではありません。2011年10月30日までは、すべてのレスポンスが強化前の実装に基づいて取得されます。この期間中に新しい実装に基づいてレスポンスを取得する場合は、リクエスト内で値が「2」のversionパラメーター（version=2）を使用してください。

「version」パラメーターの使い方の例はこちらです。
また、getRelatedRecordsという新しいAPIメソッドも導入しました。別のタブにあるデータに関連するデータ（見込み客や連絡先など）を取得できます。
たとえば、特定のキャンペーンに関連付けられている見込み客や連絡先を取得できます。詳細はこちら

リリース日：2011年4月17日

Zoho CRM開発者APIとその他の変更点のGAリリース

Zohoは、Zoho CRMサービス用APIのGAリリースを発表します。ZohoのAPIはXML形式とJSON形式で利用可能で、開発者コミュニティは好みのプログラミング言語を使用してアプリケーションを構築できます。リアルタイム導入ニーズに対応できるよう、堅牢でより優れたAPIメソッドを用意しました。バグの特定、新しい利用例やサンプルの公開など、お客さまのご協力のおかげで、CRMシステム用APIを改善できました。GAリリースに加え、既存のAPI実装も大幅に変更されています。このため、開発者コミュニティの将来のニーズにも対応できます。これらの変更には、検索メソッドの廃止、新しいレスポンス形式、APIリクエストの制限、CRMビジネスロジックを追加実装する新しいAPIメソッドなどがあります。Zohoは、これらの変更により、開発者コミュニティの開発環境が改善され、Zoho CRM開発者プラットフォームが次のレベルに進化するものと確信しています。

重要な変更点

• 既存の検索メソッドgetAllSearchRecordsとgetMySearchRecordsの廃止
• 全メソッドに対する新しいレスポンス形式の実装
• Zoho CRMプランに基づくAPIリクエストの制限
• 検索、見込み客の返還削除機能への新しいメソッドの導入

APIの廃止

今後のコミュニティの成長、より優れた開発者サービスの提供、高いパフォーマンスを必要とする運用の最適化を考慮し、次のAPIメソッドを段階的に廃止します。

• getAllSearchRecords
• getMySearchRecords

最近、getAllSearchRecordsとgetMySearchRecordsの実装中にリソースの使用量が予想より多くなっています。このような状況を解決するため、同様の機能を持つ新しい検索メソッドgetSearchRecordsとgetSearchRecordsByPDCを導入しました。これらの新しいメソッドを最適化し、パフォーマンスを向上させました。

サポート終了日：2010年1月21日

重要：

サポート終了前に、アプリケーションを更新して新しい検索メソッド（getSearchRecordsまたはgetSearchRecordsByPDC）を使用することを強くお勧めします。ご不明な点がありましたら、support@zohoccrm.comまでお問い合わせください（英語対応）。

廃止されたメソッドの詳細については、APIガイドを参照してください。

新しいレスポンス形式

現在、APIレスポンスのXML形式は< fieldlabel value = "LEADID" > 項目値 </ fieldlabel>となっており、開始タグと終了タグには約26文字（スペースを含む）が使われています。新しい実装では、XMLタグを<FL val="LEADID">項目値</FL>（合計8文字）に変更することでタグのサイズを短縮し、項目ごとのバイト数を約18バイト節約しています。これで、帯域幅の使用率を大幅に最適化できます。
2010年1月21日まで、レスポンスはデフォルトで以前の形式で返されます。新しい形式でレスポンスを取得する場合、APIリクエストで追加引数newFormat=1または2を渡して、Zoho CRMからデータを取得する必要があります。

重要：

データを挿入または更新するには、newFormat=1パラメーターのXMLデータを使用する必要があります。

古い形式：

この例では、データ内に「null」値があっても全項目が取得されます。タブに150項目ある場合も、全項目のデータを取得する必要があります。そのため、帯域幅が無駄に使用されます。新しい形式：

この例では、newFormat=1パラメーターを渡すことにより、「null」値を含む項目を取得していません。重要なポイント：

• XMLタグは、<fieldlable value="">項目値</fieldlable>から<FL val="">項目値<FL>に変更されています。
• APIリクエストでnewFormat=1を渡すことにより、「null」値を持つデータの取得を停止できます。全項目（null値を含む）を取得する場合は、newFormat=2パラメーターを使用してください。

新しいレスポンス形式 - 2009年10月22日より提供開始

古いレスポンス形式のEOL：2010年1月21日

APIリクエスト数

パフォーマンスと開発者サービスを向上させるため、以下のようにAPIリクエスト数を制限してください。

たとえば、無料プランでgetSearchRecordsメソッドを使用すると、1リクエストあたり最大200データを取得できるため、1日あたり合計50,000データ（250 x 200 = 50,000データ）を取得できます。

重要：

上記の制限は、すべての既存ユーザーと新規ユーザーに適用されます。将来的には、お客さまの組織が上記の制限を超えるとCRM管理者（Zoho CRMアカウントの特権管理者）に通知する予定です。また、連携要件をより的確に評価するAPI統計情報も提供します。

実装日：2010年1月21日

2010年1月21日（12:00 AM PST）より、ご利用のZoho CRMプランに従ってAPI呼び出しをリクエストできます。アプリケーションが上限を超える呼び出しを必要とした場合、追加のAPIリクエストは処理されません。データ転送の問題を回避するには、API要件を事前に評価してください。サポートが必要な場合は、Zohoのサポート（support@zohoccrm.com）までお問い合わせいただくか、0120-007-542までお電話ください（英語対応）。

新しいAPIメソッド

Zohoは、成長し続ける開発者コミュニティのために以下の新規メソッドを導入いたします。

• getSearchRecords
• getSearchRecordsByPDC
• deleteRecords
• convertLead

上記のメソッドは検索機能の実装に非常に有効で、ZohoのAPIによる追加のビジネスロジックの開発に役立ちます。これらのメソッドは、すべてのプランですぐに使用できるようになります。

提供開始：2009年10月22日

新しいAPIメソッドの詳細については、APIガイドを参照してください。

その他の変更点

さらに、以下のような小さい変更も行っています。

• APIリクエストごとに最大200データを取得
• すべてのAPIメソッド（新規メソッドと既存メソッド）に適用可能な新しいレスポンス形式
• selectColumnsパラメーターを使用して、指定した項目を持つデータを取得
• APIガイドを更新し、公式開発者フォーラムを開設