API基本概要(Discover)

スイート
Customer Experience
製品
Qualtrics

このページの内容

XM Discover API概要について

XM Discover APIにより、開発者はXM Discoverの感情およびテキスト分析機能にアクセスし、サードパーティのアプリケーションで使用することができます。

利用可能なAPIサービス

以下のAPIリクエストはRESTful APIで利用可能です:

  • 輸出 API:分類、感情、その他のメタデータで強化されたフィードバックデータをエクスポートします。
    注意: Discoverからのデータ抽出タスクは、エクスポートされたデータを別の場所に保存するためのローダータスクと組み合わせる機能など、特筆すべき改良が加えられた同じ機能を提供します。Export APIの代わりにこの機能をご利用ください。
  • インポート API:XM Discoverにドキュメントをインポートします。

レガシーAPIサービス

XM Discoverは、メンテナンスモードで多くのレガシーAPIサービスをサポートしています。可能であれば、サポートされているApiサービスに切り替えてください。

  • リアルタイム・サービスとアドホック・アップロード・サービス機能が、Import APIとXM Discover Linkコネクタを通じてサポートされるようになりました。
  • ModelサービスやDataflowサービスのような他のサービスには、サポートされているAPIアナログがない。これらのレガシーエンドポイントに関するドキュメントのご請求は、クアルトリクスサポートまでご連絡ください。
  • 積極的にExport API v1を使用している場合は、Export API v2に切り替えてください。

APIレート制限

デフォルトでは、APIコールを行う速度に制限があります。デフォルトのAPIレート制限は以下の通り:

  • 1秒あたりの通話回数:65回
  • 秒間リアルタイム文字数:200,000文字

料金制限の引き上げをご希望の場合は、XM Discoverサポートまで、ご利用のケースに関する情報を添えてご連絡ください。

APIレート制限の例

秒単位のリアルタイム文字数制限は、メッセージレベルで適用されるため、秒単位の呼数制限とは異なる。以下は、毎秒20,000文字に設定されていると仮定した場合のシステム動作の例である:

まず、4万文字のリアルタイムリクエストが届く。このリクエストは受理される。
他のリクエストが2秒以内に到着した場合、そのリクエストはRATE_LIMIT エラーメッセージとともに拒否される。
2秒後に別のリクエストが到着した場合、そのリクエストは受け入れられる。
当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい! フィードバックありがとうございます!

フィードバックありがとうございます!