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

ウェブサービス


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!


Web サービスについて

アンケートに、より複雑な機能を含めたい場合があります。ニュースウェブサイトから上位10件の見出しをアンケートに取り込んだり、2つ目のアンケート配信を自動化して最初のアンケートの回答者にメールで送信したりする場合もあります。Web サービスでは、指定された URL に対して要求を行うだけで、これを行うことができます。

ヒント:このページには、アクセスに特別な権限を必要とするクアルトリクスのAPIへの参照が含まれています。この機能へのアクセス権の取得に関心がある場合は、ブランド管理者に連絡して詳細を確認してください。
注意:Web サービスの設定には、高度なプログラミング知識が必要になることがよくあります。サポートチームは、Web サービスに情報を入れるという基本的なサポートを喜んで行っていますが、プログラミングに関するサポートを提供することはできません。ただし、 コミュニティの経験豊かなユーザー(英語) に尋ねてみることは可能です。

Web サービスの追加

  1. アンケートの編集中に、左側のナビゲーションバーの[アンケートフロー]アイコンをクリックします。
    左側のナビゲーションバーのアンケートフローアイコンをクリックして[アンケートフロー]に移動する
  2. 下に追加]または[こちらに新しい要素を追加]をクリックします。
    下に追加およびここに新規エレメントを追加ボタン、何を追加しますかの Web サービスオプションメニュー
  3. Web サービスを選択します。
  4. [URL] フィールドに、外部 Web サービスの URL を貼り付けます。
    メソッドが続く Web サービスの URL のフィールド

    ヒント:テキストの差し込みを使用すると、クエリ文字列を介してエンドポイントURLにアンケート情報を渡すことができます。
  5. Web サービスのメソッドを選択します。さまざまな方法については、以下のセクションで詳しく説明します。

メソッド

当社の Web サービス機能では、一連のメソッドから選択して、指定した URL から情報を要求することができます。

メソッドタイプ アクション
GET Web サービスは URL に移動し、情報を取得します。 連絡先リストのメンバーに関する情報を取得します。詳細については、Get Contact API 呼出を参照してください。
POST URL に移動し、そこで情報を保存します。 ライブラリメッセージを登録します
PUT 既存の情報を更新または置換します。 ユーザー名を変更します。これは、ユーザ更新呼出で実行できる処理のうちの 1 つです。
PATCH 既存の情報を更新または置換します。PUT によく似ています。Web サービスではこのメソッドが提供されますが、API では PATCH 呼び出しは使用されません。 サーバに保存されたデータを変更します。
削除 情報を削除します。 ライブラリからグラフィックを削除します

 

API コールを使用している場合は、以下のスクリーンショットに示すように、使用するメソッドが文書に示されます。

API 文書で各呼出の横に記載されているメソッド

パラメーター

現在、リクエストに追加できるパラメータは 3 種類あります。

強調表示されている Web サービス: クエリパラメータの追加、本文パラメータの追加、およびカスタムヘッダの追加

  1. クエリパラメータ: Web サービス URL の末尾にクエリ文字列を追加する代わりに、ここにクエリパラメータを配置します。
  2. 本文パラメータ: このパラメータは、GET 要求または DELETE 要求には使用できません。これには 2 つの書式設定オプションがあります。
    a) application/x-www-form-urlencoded: Web サービスの指定された領域に本文パラメータを入力する代わりに、指定した URL の最後にクエリ文字列として追加します。
    b) application/json: Dot Notation にキーを入力します。たとえば、API 呼び出しでヘッダー [fromEmail] の指定を求められる場合があります。ドット表記では、header.fromEmail になります。

    注意: JSON オブジェクトのすべてのキーと値、および JSON 配列 (差し込みテキストを含む) のすべての要素には、二重引用符が必要です。 本文パラメータでは、JSON オブジェクトのすべてのキーと値、および JSON 配列のすべてのエレメントに、二重引用符が必要です。
  3. カスタムヘッダ: ここに URL ヘッダを挿入します。
    ヒント:認証 URL をカスタムヘッダーに追加する必要があります。

API コールを使用している場合は、含めるパラメータの種類が文書に記載されています。以下の例は、設定するボディパラメータを示しています。

API 文書で、本文パラメータを示す矢印

Web サービスへのパラメータの追加

Web サービスで入力される本文パラメータ

  1. 前のセクションで示した Web サービスに送信する 3 パラメータの追加オプションのいずれかを選択します。上記の例では、クエリパラメータを示しています。
  2. 左側の Web サービスへのパラメータボックスにパラメータの名前を入力します。
  3. 右側の [] ボックスに、パラメータの対応する値を入力します。
  4. 別のパラメータを追加するには、パラメータの右側にあるプラス (+) 記号をクリックします。
  5. 終了したら、[適用] をクリックします。

パラメータのテスト

URL をペーストしてパラメータを設定したら、URL をテストして、取り込むことができる項目を確認することができます。

  1. URL のテストをクリックして、外部 Web サービスから取得できる情報を確認します。
    URL 項目の横にある URL テストボタン
  2. アンケートで使用または記録するフィールドを選択します。項目名が左側に表示され、対応するサンプル値が右側に表示されます。
    URL から取得するフィールドの選択
  3. 埋め込みデータを追加]をクリックして選択したフィールドをデータに追加します。
    ヒント:[埋め込みデータの設定]列で、ウェブサービスのフィールドに関連付けられている埋め込みデータ名を変更できます。埋め込みデータ名は等号 (=) 記号の左にあり、緑色の ED アイコンで示されます。右側は変更しないでください。左側で設定する名前は、データに表示されるフィールドの名前になります。
  4. Fire and Forget を選択すると、Web サービス呼出から返されるデータは保存されません。この機能は、返されたデータを保存する必要がない場合に役立ちます。
    上記のフィールドの Fire および Forget オプション、右下に適用

    ヒント:[起動]と[忘れ]を選択すると、回答を待たずに、アンケートでウェブサービスにリクエストできます。つまり、回答者は、ウェブサービスのためにアンケート全体に遅滞なく回答できます。このオプションは、処理に時間がかかる Web サービスリクエストがある場合に使用できますが、埋め込みデータが保存されないようにするため、この機能はテスト中にのみ使用することをお奨めします。
  5. 完了したら、適用をクリックします。

TLS エラーの修正

2021 年 9 月 1 日以降、トランスポートレイヤセキュリティ (TLS) エラーがある Web サービス要求は失敗します。TLS は、(プレーン HTTP ではなく) HTTPS を介した Web 要求を安全にするものです。これにより、要求データがサードパーティに表示されなくなり、要求が正しい宛先に送信されるようになります。TLSエラーを無視すると、これらのセキュリティ上のメリットが効果的に解消されます。この変更は、Qualtricsプラットフォームのセキュリティを向上させるための継続的な取り組みの重要なステップです。

各 TLS エラーを解決するには、以下のいずれかを実行する必要があります。

  • TLS エラーを修正します。TLS エラーの性質により、サポートチームはその方法についての具体的なガイダンスを提供できませんが、ネットワーク管理者はエラーの修正方法を把握することができます。
  • HTTPS ではなく HTTP を介して行われるフローエレメント Web サービス要求を変更します。たとえば、URL “https://example.com” を “http://example.com” に変更できます。このアプローチを使用する場合は、HTTP URL が HTTPS URL にリダイレクトされないようにする必要もあります。
    注意:このアプローチにより、Web サービスリクエストデータが暗号化されずに送信されることに注意してください。

フロー要素の URL フィールドの横にあるテストボタンを使用して、Web サービス要素がこの変更に対応できるかどうかを確認できます。結果ウィンドウ (下にも表示) にローデータを表示しても、エラーは表示されません。

アンケートフロー上で開き、[埋め込みデータとして含めるフィールドを選択]というダイアログWeb サービスはフィールドを返しませんでした。未加工データを表示するには、ここをクリックします。ダイアログの左下隅に、View raw data というボタンがあります。

注意:Web サービス要素を更新してエラーを修正する場合は、アンケートに対する変更も公開する必要があります。 期限後に以前のサーベイバージョンを使用する進行中のサーベイセッションを回避するために、エラーをできるだけ早く解決することをお奨めします。代わりに、(Web サービス要素の対象となるサーバで TLS 設定を修正するなどして) 別の方法でエラーを解決する場合は、公開する必要はありません。

この機能を使用できるプロジェクトの種類

ライセンスの一部としてウェブサービスにアクセスできる限り、任意の種類のプロジェクトのアンケートフローにウェブサービスを追加できます。含まれる内容は以下のとおりです:

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