--- title: "プレビュー GraphQL API" slug: "preview-graphql-api" abstract: "プレビュー GraphQL APIの概要。未公開(ドラフト)および公開されたSitecoreコンテンツへのアクセスを提供します。" --- # プレビュー GraphQL API 読み取り専用プレビュー GraphQL APIでは、コンテンツ管理インスタンスから提供される未公開(ドラフト)および公開済みSitecoreコンテンツの両方を取得できます。このAPIは通常、ローカル開発やアプリの非本番環境(テストやステージング)で使用されます。未公開コンテンツの閲覧は、コンテンツを最終決定しExperience Edgeに公開する前に、コンテンツ開発ライフサイクルの重要な部分です。 本番環境で公開されたコンテンツのみを取得する場合は、代わりにDelivery GraphQL APIをご利用ください。 ## 認可およびAPIアクセス [認証およびAPIアクセスオプション](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/authorization-and-api-access.html "Authorization and API access") は、アクセス先によってAPIによって異なります。 ## 要請本体 リクエスト本体はGraphQLクエリです。クエリ [の例](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/query-examples-for-the-delivery-graphql-api.html "Query examples for the Delivery GraphQL API")も参照してください。 ## 応答形式 レスポンスはJSONオブジェクトです。クエリ [の例](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/query-examples-for-the-delivery-graphql-api.html "Query examples for the Delivery GraphQL API")も参照してください。 ## スキーマと参照ドキュメント [GraphQL IDE](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/set-up-the-graphql-ides.html "Set up the GraphQL IDEs")内のGraphQLスキーマとAPI参照ドキュメントにアクセスできます。 ## 制限と制限 [プレビュー GraphQL API制限や制限](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/preview-graphql-api/preview-graphql-api-limitations-and-restrictions.html "Preview GraphQL API limitations and restrictions")を確認してください。 ## スキーマ拡張 プレビュー GraphQL APIスキーマはデリバリー GraphQL APIのスキーマを反映しています。プレビュー GraphQL APIスキーマはExperience Edgeとの互換性を保つ必要があるため拡張できません。 ## トークン化検索索引 Delivery GraphQL APIとは異なり、プレビュー GraphQL APIエンドポイントはトークン化された検索インデックスを使用します。その結果、検索の挙動はフィールドのインデックス付け方法に依存します: - CONTAINS演算子はトークン化されたフィールド値に基づいて複数の結果を返すことができます。 - EQ(等)演算子は、完全に一致が期待されていてもトークン化されたテキストフィールドに対して複数の結果を返すこともあります。 プレビューエンドポイントのEQと正確に一致させるために、SearchQueryFieldMapping機能を使ってトークン化されたフィールドを非トークン化された計算フィールドにマッピングします。関連するサポート記事も参照[KB1003665](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB1003665)。 探索演算子の挙動に関する情報は「 [Search演算子の挙動](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/the-experience-edge-schema.html#search-operator-behavior)」を参照してください。 ## メディアアイテムの認証を無効にすること デフォルトでは、プレビューエンドポイントでメディア項目を表示するには[認証が必要です](https://developers.sitecore.com/changelog/xm-cloud/14112024/access-control-improvement-for-xm-cloud)。ただし、sitecore.configファイルのMedia.UrlSignatureExpirationTimeout設定を以下の形式で使用することで、指定された期間その要件を無効にすることができます。 値が0に設定されている場合、認証は常に強制されます。 設定を更新した後は、[パッチファイルを使って](https://doc.sitecore.com/sai/ja/developers/sitecoreai/development/use-a-patch-file-to-customize-the-sitecore-configuration.html) 設定変更を適用することを忘れないでください。