---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GraphQL エクスプローラーで GraphQL API をテストする

# GraphQL エクスプローラーで GraphQL API をテストする {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：2分

統合された GraphQL テストツールを使用して、GraphQL API のクエリをテストします。

## 始める前に

GraphQL API のスキーマを作成します。詳細については、「[GraphQL スキーマの作成](https://servicenow-prod.fluidtopics.net/EiDJzRjSvstRApjSG9jJ8g#build-graphql-scripted-schema "GraphQL スキーマを作成して、GraphQL クエリでデータを使用できるようにします。")」を参照してください。

イントロスペクションクエリを有効にすると、GraphQL エクスプローラーはインスタンスのスキーマをドキュメントエクスプローラーに表示し、オートコンプリート提案として表示できるため、クエリとミューテーションを簡単に見つけることができます。詳細については、「[GraphQL スキーマのイントロスペクションクエリを有効にする](https://servicenow-prod.fluidtopics.net/a0Cb6a_FDJiZcZhJ84_GRQ "イントロスペクションを有効にして、インスタンスのスキーマでサポートされているクエリとミューテーションを検出します。")」を参照してください。  
注:  
本番環境ではイントロスペクションクエリを使用しないでください。

必要なロール:graphql_schema_admin または admin

## このタスクについて

GraphQL エクスプローラーは、GraphiQL IDE を ServiceNow AI Platformに統合します。インターフェイスの詳細については、GraphiQL GitHubリポジトリの [GraphiQL readme](https://github.com/graphql/graphiql/blob/main/packages/graphiql/README.md) を参照してください。

## 手順

1. 移動先 すべてシステム Web サービスGraphQLGraphQL エクスプローラー.
2. **オプション:** イントロスペクションを有効にした場合は、左側のサイドバーで \[ドキュメントエクスプローラーを表示\] アイコン ( \[ ![ドキュメントエクスプローラーを表示\] アイコン]()) を選択して、使用可能なクエリまたはミューテーションを表示および検索します。
3. エディターで、スキーマに対するクエリーを入力します。  
   クエリにアプリケーションとスキーマの両方の名前空間を含めます。適用できるディレクティブの詳細については、「 [ディレクティブとグローバル関数](https://servicenow-prod.fluidtopics.net/pvMJxlDC7aInS0uXKgmGXg#scripted-graph-ql__section_zdw_rnc_glb)」を参照してください。  
   次の例は、アプリケーションとスキーマの両方の名前空間の使用を示しています。
   * アプリケーション名前空間: `x_graph_scope`
   * スキーマ名前空間: `惑星`

   {#test-gql-schema__ul_ihg_pzh_dlb}

       query {
         x_graph_scope {
           planet {
             findAll {
               name
               mass
               distance
             }
           }
         }
       }

   この例では、最初のインシデント応答後に @defer ディレクティブを使用して openedBy フィールドの結果をストリーミングする方法を示しています。

       query findIncidents {
         now {
           incident {
             findAll {
               description {
                 displayValue
               }
               ...
               @defer(label: "my-label", if: true) {
                 openedBy {
                   firstName
                   lastName
                 }
               }
             }
           }
         }
       }

4. **オプション:** エディターの下部で \[変数\] を選択し、必要な変数を入力します。
5. \[クエリを実行\] アイコン ( ![クエリを実行アイコン]()) を選択します。  
   ヒント:  
   キーボードショートカットを使用することもできます。使用可能なキーボードショートカットのリストを表示するには、\[ショートキーダイアログを開く\] アイコン ( ![\[ショートキーダイアログを開く\] アイコン]()) を選択します。  
   クエリの結果が右側のペインに戻ります。
6. **オプション:** \[タブの追加\] アイコン (タブ ![の追加アイコン]()) を選択して、追加のクエリを実行します。

## 次のタスク

以前のクエリのリストを表示する必要がある場合は、左側のサイドバーで \[履歴を表示\] アイコン ( ![\[履歴を表示\] アイコン]()) を選択します。

コンポーネント内のレコードデータにアクセスするには、カスタムコンポーネントを作成し、コンポーネントからスクリプト化された GraphQL スキーマをクエリします。詳細については、「[コンポーネントからの GraphQL スキーマのクエリ](https://servicenow-prod.fluidtopics.net/RAI2WsmRgHDgmcdmfpowvA "スクリプト化された GraphQL スキーマを照会して、コンポーネント内のレコードデータにアクセスします。")」を参照してください。