Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

一般的な API の質問


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


一般的な API の質問について

クアルトリクスには、お客様が実用的なデータをリアルタイムで収集できるさまざまな製品があります。これらの製品には、アンケートプラットフォーム、ウェブサイト/アプリのフィードバック、XM Directory、Qualtrics 360などがあります。Qualtrics API機能を購入すると、ライセンスに含まれるすべての製品でAPIを使用できるようになります。

アンケートプラットフォーム

正しいパラメータはすべて揃っていますが、「無効な要求」というエラーメッセージが表示されます。パラメータ要求がないか、無効です。」なぜこんなことが起きているのか。

例:

curl -X POST \  https://yourdatacenterid.qualtrics.com/API/v3/responseexports \  
 -H 'content-type: application/json' \  -H 'x-api-token: 12345678901234567890' \   -
d '{"surveyId":"SV_1234567890","Format":"json"}'

Qualtrics APIパラメータでは大文字と小文字が区別されます。この例では、パラメータが “format” である必要がある場合、”Format” と呼ばれます。これを更新すると、API 要求を正常に実行できるようになります。

未加工のデータをダウンロードして Excelで開きたいと思いますどの API 要求を使用すればよいですか。
[回答のエクスポートの作成] 要求を使用してエクスポートプロセスを開始し、回答エクスポートファイル形式を CSV に指定します。次に、Get Response Export Progress 要求を使用してファイルの準備ができているかどうかを確認し、次に Get Response Export File 要求を使用して CSV ファイルをダウンロードする必要があります。
[連絡先のインポートを作成]を使用する場合、連絡先リストをクアルトリクスに投稿または送信するさまざまな方法は何ですか?
連絡先リストのアップロードには、2つのオプションがあります。

  1. Content-Type を multipart/form-data に設定し、連絡先を JSON ファイルとしてアップロードできます。
  2. Content-Type を application/json に設定し、要求本文で JSON 配列としてコンタクトを投稿できます。
組織に対して行うことができる依頼の数に制限されていますか。同時に実行できる API 要求はいくつありますか。
制限の詳細については、この API ページを参照してください
[アンケートをインポート]リクエストを使用しています自分のアンケートをTXTファイルとして保存しましたリクエストは成功しましたが、新しくインポートされたアンケートに質問が表示されません。なぜこんなことが起きているのか。
Qualtricsにアンケートをインポートするために必要な形式に従っていることを確認する必要があります。TXT形式の詳細については、「標準形式でのTXTファイルの準備」および「詳細形式でのTXTファイルの準備」を参照してください。ファイルが正しくフォーマットされると、要求は正常に実行されます。
パラメータ startDate および endDate を含む Create Response Export 要求を使用しています。しかし、ダウンロードしたデータを確認すると、予想される応答の日付範囲が表示されません。
startDate パラメータと endDate パラメータを使用する鍵は、作成する条件を評価するために使用される日付値 (つまり、設定した startDate および設定した endDate を評価するために参照される日付) を理解することです。これら 2 つのパラメータは、参加者がアンケートを開始した日付を使用します。この値は[開始日]と呼ばれ、[データと分析]タブとダウンロードしたデータにあります。startDate パラメータを 2017-01-01 に設定し、endDate パラメータを 2017-01-02 に設定すると、2017 年 1 月 1 日から 2017 年 1 月 2 日の日付範囲内に調査を開始した調査参加者に対して記録 (提出または不完全) された回答がダウンロードされます。

ヒント:参加者がアンケート内の[送信]ボタンをクリックするか、 不完全なアンケート回答 の時間枠が満たされています。

ウェブサイト/モバイルからのフィードバック

ウェブサイト/モバイルからのフィードバックの質問については、ウェブサイト/モバイルからのフィードバックのサポートチームにお問い合わせください

XM Directory

XM Directoryを使用しているアンケートプラットフォームAPIも使用できますか?
はい、もちろんです。XM Directoryには、アンケートプラットフォームAPIで行われたリクエストを置き換えるAPIリクエストがいくつかありますが、ほとんどの場合、すべてのアンケートプラットフォームのAPIリクエストを引き続き使用できます。変更される可能性があるのは、アンケートプラットフォーム連絡先のリクエストのみです。v3ドキュメントでは、XM DirectoryユーザーにはサポートされていないAPI要求(またはその逆)に通知があります。
XM Directory APIでは、アンケートプラットフォームAPIのみでアクセスできないどのような追加機能が提供されますか?
XM Directory APIでは、XM Directoryに固有のいくつかの一意のリクエストが提供されます。getBouncedContacts (API v2.4) を使用すると、自分のディレクトリ (または特定のメーリングリスト) で、これまでにメールバウンスが発生したことがあるすべてのコンタクトを検索することができます。リストディレクトリの連絡先リクエストを使用して、ディレクトリ全体のサブセットをエクスポートできます。getIncentiveRecipients 申請では、特定のインセンティブ (ポイント特典や懸賞エントリなど) を獲得したディレクトリ内のすべての連絡先の一覧をダウンロードできます。これらのリクエストなどは、XM DirectoryAPIで使用できます。
コンタクト ID と受信者 ID の違いは何ですか。
通常、XM DirectoryAPI要求ごとに連絡先の連絡先IDが求められます。この ID は “CID_” で始まり、その後に一意の英数字文字列が続きます。コンタクト ID は、ディレクトリ内のコンタクトの一意の ID です。一部の API 要求では、コンタクトの受信者 ID が求められます。この ID は “CGC_” で始まり、その後に一意の英数字文字列が続きます。[受信者ID]は、メーリングリスト内の連絡先の一意のIDです。

コンタクト ID と受信者 ID の違いを理解するには、各コンタクトがディレクトリに一度だけ存在することに注意してください。ディレクトリには1つの連絡先が一度ありますが、複数のメーリングリストのメンバーである可能性もあります。この連絡先が 3 つのメーリングリストのメンバーであった場合、連絡先は 1 つの連絡先 ID と 3 つの受信者 ID (リストごとに 1 つ) を持ちます。

Qualtrics 360

クアルトリクス360の質問については、クアルトリクス360サポートチームにお問い合わせください

当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。