Microsoft SharePoint Online REST API を使用して取得可能なページコンテンツを表示する

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • Microsoft SharePoint Online 外部コンテンツコネクタによって取得できるMicrosoft SharePoint Onlineページのコンテンツの要素を確認します。

    始める前に

    取得可能なコンテンツを表示する各 Microsoft SharePoint Online ページについて、次の詳細が必要です。
    • サイトの URL。通常、これは https://<tenant-name>.sharepoint.com/sites/<site-name> の形式です。ここで、 <tenant-name> はテナントのホスト名で、 <site-name> はページが存在するサイトの名前です。たとえば、サイト URL が https://example.sharepoint.com/sites/my-site の場合などです。
    • .aspxページのファイル名 (拡張子なし)。たとえば、ページの URL が https://example.sharepoint.com/sites/my-site/SitePages/sample-page.aspx の場合、ページのファイル名は sample-age です。
      注:
      Microsoft SharePoint Online ページファイル名では大文字と小文字が区別されるため、Web ブラウザの [URL] フィールドに表示されるファイル名を正確にコピーします。

    必要なロール：なし

    このタスクについて

    この手順を実行して、 Microsoft SharePoint Online ページの CanvasContent1 および WikiFields メタデータフィールドの内容を確認します。これらのフィールドには、コネクタが取得して AI 検索 アプリケーションで検索可能にする静的コンテンツが含まれています。

    Microsoft SharePoint Online ページは、サイトのサイト ページ ライブラリに .aspx ファイルとして格納されます。これらのファイルには、CanvasContent1 および WikiFields メタデータフィールドに静的コンテンツが含まれていますが、サーバー側エンジンを呼び出して、要求時に表示可能なコンテンツを動的にレンダリングするスクリプトも含まれています。レンダリングされる正確なコンテンツは、ページ要求の一部として読み込まれたユーザーコンテキスト、アクセス許可、Web パーツによって異なります。

    ページの完全な表示可能なコンテンツをレンダリングするには、認証されたユーザーセッションが必要です。Microsoft SharePoint Online コネクタは、ユーザーの代理操作を行い、このレンダリングプロセスをトリガーすることはできません。その結果、コネクタは、Web ブラウザーに表示される最終的な HTML 出力をキャプチャできません。

    取得されたページごとに、 Microsoft SharePoint Online コネクタは SharePoint REST API にクエリを実行して、ページの基礎となるリストアイテムにアクセスします。使用される API エンドポイントは _api/web/lists('<list-id>')/items(<item-id>) です。ここで、 <list-id> と <item-id> は動的に置換される値です。このコネクタは、主にページの CanvasContent1 および WikiFields メタデータフィールドからコンテンツを取得し、タイトル、作成者、変更日 (利用可能な場合) などのページの他のメタデータフィールドもキャプチャします。動的 Web パーツにのみ格納されているページ コンテンツは、そのコンテンツがリスト アイテム メタデータに存在しないため、部分的にしか取得されないか、まったく取得されない場合があります。

    この制限の結果、主に Microsoft SharePoint Online エディターで作成された静的テキストコンテンツで構築されたページは、ユーザーが Web ブラウザーで表示するものにより近い検索可能なコンテンツを生成するようになります。対照的に、動的 Web パーツに依存するページには、ユーザーが Web ブラウザーで表示するすべてのコンテンツが含まれていない場合があります。

    手順

    1. サイトのサイトページリストの ID を取得します。
      1. Web ブラウザーで、 Microsoft SharePoint Online テナントに移動してログインします。
      2. ブラウザーで、 <site-url>/_api/web/lists?$select=ID,Title&$filter=Title%20eq%20%27Site%20Pages%27 に移動し、 <site-url> を Microsoft SharePoint Online サイト URL に置き換えます。
        この要求が [サイトページ] リストを説明する XML 応答を返さない場合は、 代わりに <site-url>/_api/web/lists?$select=ID,Title に移動し、フィルタリングされていない応答で [サイトページ] リストのエントリを見つけます。
      3. XML 応答で <d:Id> 要素を見つけて、その値として指定されたリスト GUID をコピーします。
        たとえば、リスト GUID は 4acc128d-166d-441d-a7a6-d96ae2e8b46f のようになります。
    2. 選択したページのスタティックコンテンツを表示します。
      1. Web ブラウザーで、 <site-url>/_api/web/lists('<list-id>')/items?$filter=FileLeafRef%20eq%20%27<filename>.aspx%27 に移動し、 <site-url> を自分のサイト URL に、 <list-id> をステップ 1.c でコピーした GUID に、 <filename> を検索可能なコンテンツを表示するページのファイル名に置き換えます。
      2. XML 応答で、CanvasContent1 および WikiField メタデータフィールドを見つけて、それらの値を調べます。
        これらのフィールドには、ページの取得時に Microsoft SharePoint Online コネクタによって検索可能にする静的コンテンツが含まれています。
        注:
        CanvasContent1 メタデータ フィールドと WikiField メタデータ フィールドが見つからないか空の場合、ページは動的 Web パーツを介して完全にレンダリングされ、 Microsoft SharePoint Online 外部コンテンツ コネクタによって取得できる静的コンテンツは含まれていない可能性があります。