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

Qualtrics 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 文書について

Qualtrics APIドキュメンテーションページには、現在提供されているすべてのドキュメントの詳細が記載されています。

このページでは、各セクションの内容と利用可能な内容の概要を説明しながら、ドキュメントをナビゲートする方法について説明します。

概要

APIの概要では、Qualtrics APIに関する一般情報と、ページ付けに関する情報を確認できます(例:リストの連絡先リクエストを実行し、連絡先が100件を超える場合、結果にはページ番号が付けられ、次の100個のページURLが表示されます。これはすべてのコレクションリクエストに適用されます)。

クアルトリクスサーバーの許可リスト

クアルトリクスサーバーの許可リストを参照してください。

ベース URL およびデータセンタ ID

このサブセクションでは、API 要求のベース URL に含める必要があるデータセンタ ID を検索する方法を示します。

クアルトリクスIDの検索

このサブセクションでは、API 要求の実行時に必要なさまざまな ID を見つけることができる場所を示します。このセクションで使用できない ID については、「要素を検査してQualtrics IDを検索する」を参照してください。

認証

認証サブセクションには、要求の認証に必要な情報、および API トークンの保護に関する提案の概要が示されています。認証プロセスの詳細については、API トークンの生成を参照してください。

パラメーター

パラメータサブセクションでは、使用する HTTP メソッド (GET、POST、PUT、または DELETE) に応じてパラメータを渡すさまざまなメソッドについて説明します。

回答数

応答サブセクションには、要求の実行時に返すことができるさまざまな HTTP 応答コードの例と、各応答コードに対して考えられる理由が含まれています。当社の API は常に JSON で応答を返します。ただし、使用可能な任意の形式でファイルを返すことができる応答エクスポート要求の場合を除きます。

ヒント:ドキュメントでオプションとして[回答]または[以前のバージョンからアップグレード]が表示されない場合は、APIセクションの一覧の下部にある[すべて表示 7]を選択してください。

Qualtrics API の使用

文書のこのセクションには、Python および Java のコードスニペットが含まれており、サーベイとユーザを管理したり、サーベイ結果を取得したりするためのワークフローを開発する際に役立ちます。

警告:カスタムコーディング機能は現状のまま提供されており、実装にはプログラミングの知識が必要となる場合があります。クアルトリクスサポートチームでは、カスタムコーディングに関するサポートやコンサルティングは提供していません。ただし、 コミュニティの経験豊かなユーザー(英語) に尋ねてみることは可能です。カスタムコーディングサービスの詳細については、クアルトリクスの営業担当にお問い合わせください。

参照

参照セクションには、受入可能な日付と時刻の書式、言語コード、要求制限、およびイベントサブスクリプションに関する詳細に関する重要な情報が含まれています。イベントサブスクリプションを使用すると、イベントの発生後にパブリケーション URL に通知を送信できます (例: 応答の記録)。

リクエスト

ドキュメントを整理し、ユーザーが探している API 要求を見つけやすくするために、要求は以下のように分類されます。

  • 組織
  • 部署
  • グループ
  • ユーザー
  • アンケート
  • アンケートの回答のエクスポート
  • 回答数
  • 回答のインポート
  • メッセージライブラリ
  • グラフィックライブラリ
  • 配信
  • インサイトプラットフォームコンタクト
  • イベントサブスクリプション
  • XM Directory(ターゲットオーディエンス)

要求パラメータおよびオプション

各 API 要求には、名前、簡単な説明、使用可能なパラメータを一覧表示するテーブル、応答、cURL での要求例、および “Try It Out” ウィザードがあります。この情報の使用方法を理解すると、作業を合理化することができます。

名前、説明、および URL

API 要求に対して一覧表示される最初の 3 つは、HTTP 動詞、API 要求の名前、および要求の簡単な説明です。

API 呼出の名称と内容説明

要求 (または “定義”) で使用される URL が、HTTP 動詞の横に一覧表示されます。

URL で使用されるドリルダウン構造に注意してください。例:

本文パラメータの一覧

API 要求ごとに、使用可能な本文パラメータをすべて一覧表示するテーブルが表示されます (一部はオプション、一部は必須)。このテーブルには、以下の情報が含まれます。

  • 各パラメータの名前
  • 各パラメータに対して許可される形式
  • パラメータが必要かどうか
  • パラメータの簡単な説明
注意: すべてのパラメータ名と値で、大文字と小文字が区別されます。

API 呼出のパラメータ一覧

要求サンプル

マニュアルに記載されている要求サンプルでは、要求を cURL で書式設定する方法を示します。これらの要求には、ルート URL およびパラメータテーブルからのすべての必須パラメータが含まれます。

cURL 書式での例

ヒント:IDは単なる例であり、実際の ID ではないため、例のリクエストは実際には機能しませんが、単に自分のアカウントの ID に置き換えることができます。

応答の例

このセクションでは、API 要求が成功した場合に受信できる内容の例を示します。たとえば、API 要求 Create User を使用している場合、応答は新たに作成されたユーザのユーザ ID になります。

結果書式の例

API サイトでの API 要求の完了

API 文書を使用すると、API 要求を迅速かつ容易に実行することができます。(ほとんどのAPIリクエストにはクアルトリクスIDが必要です。)

注意: API のテストには注意が必要です。API 呼び出しを実行するために必要な最小限の情報を入力すると、このモーダルで API 要求が完了します。必須フィールドは API 呼び出しによって異なり、呼び出しのページに表示されます。
  1. API キーOAuth 2.0 のいずれかを選択します。
    パラメータの入力と API 呼出の実行を可能にする API 文書の黒色のモーダル
  2. API トークンフィールドにアカウントの API トークンを入力します。(または、OAuth 2.0 を選択した場合は対応する OAuth 2.0 情報)
  3. 追加パラメータを入力します。
  4. ユーザをクリックして、テストするサーバを選択します。最も正確にテストするため、これはアカウントのデータセンターと一致させる必要があります。
  5. API 要求の送信を押して、API 呼び出しをテストします。
ヒント:各パラメータで使用できる値を確認するには、リクエストのパラメータの表を参照してください。文書で cURL の例を参照することもできます。

依頼に必要な値を入力すると、”応答” にコールの出力が表示されます。

出力は、API 呼び出しをテストしたすぐ下にある黒いモーダルに表示されます。

注意: 一部の依頼はこのテスト機能では機能しませんこれは、申請のページに示されます。

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