연습 - Graph Explorer를 사용하여 Microsoft Graph에서 사용자 정보에 액세스

  • 8분

다음 연습에서는 Graph 탐색기를 직접 살펴보고 애플리케이션에서 호출할 수 있는 주요 Microsoft Graph API를 확인합니다.

Graph 탐색기 시작하기

영업 사원이 이름, 직위, 메일, 휴대전화가 포함된 프로필 정보를 보고 싶어한다고 가정해 보겠습니다. Graph 탐색기에서 사용자 프로필을 가져오는 프로세스는 다음과 같습니다.

  1. Graph 탐색기 웹 사이트를 방문하세요.
  2. 왼쪽의 샘플 쿼리에서 Microsoft Graph API를 선택합니다.
  3. 선택한 쿼리는 Graph 탐색기에서 자동으로 실행됩니다. 테스트하기로 선택한 API의 URL을 확인합니다.
  4. 쿼리가 성공적으로 실행되면 OK – 200 알림을 받습니다.
  5. 요청 결과는 응답 미리 보기 아래에 나타납니다.

사용자 프로필을 가져오는 프로세스를 보여주는 스크린샷

Graph 탐색기에서 자신의 계정으로 쿼리 테스트

이 연습에서는 영업 사원이 모임, Teams 채팅 또는 전자 메일에서 공유되는 문서를 찾고 있다고 가정해 보겠습니다. 영업 회사는 또한 사용자 주변의 추세 문서를 보다 쉽게 ​​볼 수 있기를 원합니다. 개발자는 Graph 탐색기에서 통찰력을 얻기 위해 Microsoft Graph API를 사용하여 추세 항목 가져오기를 테스트할 수 있습니다.

Graph 탐색기는 기본적으로 샘플 계정 데이터를 사용합니다. 자체 데이터를 가져오는 쿼리를 테스트하려면 계정으로 로그인하면 됩니다. Graph 탐색기의 인증 기능을 사용하여 테스트를 수행할 수 있습니다.

참고

Microsoft 365 개발자 테넌트를 만들었는지 확인합니다. 이 모듈의 전제 조건 중 하나입니다.

  1. 왼쪽의 Graph 탐색기에 로그인 버튼을 선택하고 Microsoft 365 개발자 테넌트 계정으로 로그인한 다음 동의를 선택하여 Graph 탐색기에서 요청한 권한에 대한 동의를 제공합니다.

    로그인하면 왼쪽에 프로필 정보가 나타납니다.

  2. 샘플 쿼리에서 내 주변에서 인기 있는 항목 가져오기를 선택합니다.

  3. 인사이트용 Microsoft Graph API에 쿼리를 실행하려면 일부 권한이 필요하다는 경고가 표시됩니다.

  4. 권한 수정을 선택합니다. 선택한 쿼리에 필요한 권한이 나타납니다.

  5. 동의를 선택하여 각 권한에 대한 동의를 제공합니다.

    Graph 탐색기에서 자신의 계정으로 쿼리를 테스트하는 방법을 보여주는 스크린샷

  6. 쿼리 실행을 선택합니다.

  7. Insights API가 실행되면 OK – 200 메시지가 표시됩니다.

  8. 결과로 응답 미리 보기 탭에서 인기 있는 항목을 볼 수 있습니다.

    Graph 탐색기에서 자신의 계정으로 쿼리 결과를 얻는 방법을 보여주는 스크린샷

Graph 탐색기에서 POST 요청 시도

Teams의 영업 팀 채널에 새 영업 사원이 추가될 때마다 새 영업 사원을 환영하는 메시지를 채널에 보내는 것을 자동화할 수 있습니다. Microsoft Teams의 채널에 메시지를 보내려면 Graph 탐색기에서 POST 요청을 사용할 수 있습니다.

  1. HTTP 동사 드롭다운 목록에서 POST를 선택합니다.

  2. 샘플 쿼리에서 "팀"을 검색합니다.

  3. Microsoft Teams 드롭다운 목록에서 POST 전송 채널 메시지를 선택합니다.

  4. 이 쿼리에 팀 ID와 채널 ID가 필요함을 알려주는 팁 팝업이 표시됩니다. 또한 필요한 팀 ID와 채널 ID를 얻으려면 내 참가 팀 가져오기(GET) 및 내가 속한 팀의 채널 가져오기(GET)을 실행하는 것이 좋습니다.

    Microsoft Graph 탐색기의 게시 요청을 보여주는 스크린샷.

  5. 팀 ID와 채널 ID를 얻은 후 쿼리 편집기를 사용하여 쿼리를 편집합니다. {team-id} 및 {channel-id}을(를) ID로 바꿔야 합니다.

  6. 권한 수정 탭에서 필수 권한에 대한 동의를 제공합니다.

  7. 요청 본문에는 "Hello world"와 같은 기본 콘텐츠가 있습니다. 이것은 Microsoft Teams의 채널에 보낼 메시지입니다. 요청 본문의 내용을 보내고 싶은 문장으로 자유롭게 변경하세요.

  8. 쿼리 실행을 선택하여 요청을 실행합니다.

  9. 요청이 성공적으로 완료되면 Created – 201 메시지가 표시됩니다.

    Microsoft Graph 탐색기의 게시 요청 결과를 보여주는 스크린샷

  10. 결과를 보려면 https://teams.microsoft.com(으)로 이동하여 왼쪽 메뉴에서 Teams를 선택합니다. 메시지를 보내기 위해 선택한 팀과 채널을 찾아 채널 이름을 선택하세요. 채널 게시물 아래에 귀하가 보낸 "Hello world" 메시지가 표시되어야 합니다.

    Microsoft Teams의 게시 요청 결과를 보여주는 스크린샷.

Graph 탐색기를 사용하여 앱에서 Microsoft Graph 사용

Graph 탐색기에는 앱을 Microsoft Graph와 연결하는 데 도움이 되는 다른 기능이 있습니다.

  1. 액세스 토큰: Microsoft Graph API는 액세스 토큰을 사용하여 사용자의 ID를 설정하고 인증 및 승인을 수행합니다. 액세스 토큰 탭에서 액세스/인증 토큰을 복사할 수 있습니다.

  2. 코드 스니펫: Graph 탐색기에서 Microsoft Graph 쿼리를 테스트하고 앱에서 동일한 쿼리를 사용하려는 경우 코드 스니펫 탭으로 이동하여 관련 코드를 얻고 앱에 추가할 수 있습니다. 코드 조각은 모든 샘플 쿼리에 대해 C#, JavaScript, Java 및 Objective-C에서 사용할 수 있습니다.

  3. 도구 키트 구성 요소: Microsoft Graph 도구 키트 구성 요소는 프레임워크에 연결되지 않고 Microsoft Graph에 액세스하는 데 도움이 되는 웹 구성 요소입니다. 도구 키트 구성 요소 탭을 사용하여 이러한 HTML 구성 요소를 테스트하고 Microsoft Graph를 통해 Microsoft 365 데이터를 검색하기 위해 웹 앱에서 사용할 수 있습니다. 쿼리를 실행하고 쿼리에 대해 도구 키트 구성 요소를 사용할 수 있는 경우 탭 오른쪽에 파란색 점이 나타납니다.

  4. 적응형 카드: 적응형 카드는 플랫폼에 연결되지 않고 봇에서 사용되는 UI 구성 요소입니다. 앞서 제공된 일정 봇 예시와 같이 챗봇에서 Microsoft Graph를 사용하려는 경우 적응형 카드 탭을 사용하여 UI 스니펫을 가져올 수 있습니다. 쿼리를 실행하고 쿼리에 적응형 카드를 사용할 수 있는 경우 탭 오른쪽에 파란색 점이 나타납니다.

    Graph 탐색기를 사용하여 앱에서 Microsoft Graph를 사용하는 방법을 보여주는 스크린샷

Graph 탐색기는 Microsoft Graph 기능을 발견하는 사람들이 쉽게 배우고 연습할 수 있도록 도와주는 많은 기능을 갖춘 지속적으로 발전하는 도구입니다.