REST API를 사용하여 Microsoft SharePoint Online 검색 가능한 페이지 콘텐츠 보기

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 외부 콘텐츠 커넥터로 검색할 수 있는 페이지 콘텐츠의 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 페이지 파일 이름은 대소문자를 구분하므로 웹 브라우저의 URL 필드에 표시된 대로 파일 이름을 정확하게 복사하십시오.

    필요한 역할: 없음

    이 태스크 정보

    페이지의 CanvasContent1 및 WikiFields 메타데이터 필드의 내용을 Microsoft SharePoint Online 검토하려면 이 절차를 수행합니다. 이러한 필드에는 커넥터가 검색하여 애플리케이션에서 검색 가능하게 만드는 정적 컨텐츠가 포함되어 있습니다 AI 검색 .

    Microsoft SharePoint Online 페이지는 사이트의 사이트 페이지 라이브러리에 .aspx 파일로 저장됩니다. 이러한 파일은 CanvasContent1 및 WikiFields 메타데이터 필드에 정적 컨텐츠를 포함하지만, 요청 시 볼 수 있는 컨텐츠를 동적으로 렌더링하기 위해 서버 측 엔진을 호출하는 스크립트도 포함합니다. 렌더링되는 정확한 콘텐츠는 사용자 컨텍스트, 권한 및 페이지 요청의 일부로 로드된 웹 파트에 따라 달라집니다.

    페이지의 전체 조회 가능 컨텐츠를 렌더링하려면 인증된 사용자 세션이 필요합니다. 커넥터는 Microsoft SharePoint Online 사용자를 가장하여 이 렌더링 프로세스를 트리거할 수 없습니다. 따라서 커넥터는 웹 브라우저가 표시할 최종 HTML 출력을 캡처할 수 없습니다.

    검색된 각 페이지에 대해 커넥터는 Microsoft SharePoint Online SharePoint REST API를 쿼리하여 페이지의 기본 목록 항목에 액세스합니다. 사용된 API 엔드포인트는 _api/web/lists('<list-id>')/items(<item-id>)이며, 여기서 <list-id> 와 <item-id> 는 동적으로 대체되는 값입니다. 커넥터는 주로 페이지의 CanvasContent1 및 WikiFields 메타데이터 필드에서 콘텐츠를 검색하고 제목, 작성자 및 수정 날짜(있는 경우)와 같은 페이지의 다른 메타데이터 필드도 캡처합니다. 동적 웹 파트에만 저장된 페이지 콘텐츠는 해당 콘텐츠가 목록 항목 메타데이터에 존재하지 않으므로 부분적으로만 검색되거나 전혀 검색되지 않을 수 있습니다.

    이 제한의 결과는 편집기에서 Microsoft SharePoint Online 작성된 정적 텍스트 콘텐츠로 주로 빌드된 페이지가 사용자가 웹 브라우저에서 보는 것과 더 근접하게 일치하는 검색 가능한 콘텐츠를 생성한다는 것입니다. 반면, 동적 웹 파트를 사용하는 페이지에는 사용자가 웹 브라우저에서 보는 모든 콘텐츠가 포함되어 있지 않을 수 있습니다.

    프로시저

    1. 사이트의 사이트 페이지 목록에 대한 ID를 검색합니다.
      1. 웹 브라우저에서 테넌트로 이동하여 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. 웹 브라우저에서 <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 메타데이터 필드가 누락되거나 비어 있는 경우 페이지는 동적 웹 파트를 통해 완전히 렌더링되며 외부 콘텐츠 커넥터에서 Microsoft SharePoint Online 검색할 수 있는 정적 콘텐츠가 포함되어 있지 않습니다.