Microsoft Graph를 사용하여 사용자의 일정 이벤트에 액세스

  • 8분

이 단원에서는 다음 주에 대한 사용자의 일정 이벤트를 표시하는 방법을 알아봅니다. 또한, 지정된 기간에 데이터 이벤트를 쿼리하고선택 및 정렬과 같은 개념을 사용하여 원하는 정보를 표시하는 방법도 알아봅니다.

앱에 필요한 사용 권한 결정

Microsoft Graph에 노출되는 모든 데이터는 보호됩니다. 앱에 액세스하려면 적절한 권한이 부여되어야 합니다. 필요한 권한은 앱에서 액세스해야 하는 정보 유형에 따라 달라집니다. 예를 들어 사용자의 일정에 액세스하려면 앱에 Calendars.Read 권한이 있어야 합니다. 각 작업에 필요한 사용 권한의 정확한 목록은 Microsoft Graph API 참조에서 확인할 수 있습니다.

앱이 다른 유형의 데이터를 로드하는 경우 사용자는 이 정보에 액세스하는 데 필요한 여러 권한을 부여해야 합니다. 앱에서 필요한 권한만 요청합니다. 이 모듈에서 앱은 처음에 사용자의 이름을 읽을 수 있는 권한을 요청하고 이벤트를 표시할 단추를 선택할 때만 일정을 읽도록 요청합니다. 이 패턴을 동적 동의라고 하며 권한 요청 시 권장 방법입니다. 동적 동의를 통해 사용자는 사용하는 앱과 공유하는 데이터를 제어하여 보안 위험을 최소화합니다.

필요한 사용 권한 지정

앱에 부여된 사용 권한 목록은 액세스 토큰에 바로 적용됩니다. OAuth 표준은 범위를 호출합니다. 애플리케이션이 Microsoft 인증 라이브러리를 사용하여 액세스 토큰을 가져오는 경우 Microsoft Entra ID에 대한 요청에 범위 목록을 포함해야 합니다. Microsoft Graph 각 작업에는 고유한 범위 목록이 있습니다. 액세스 토큰 중 하나가 없는 경우 요청이 거부됩니다.

샘플 응용 프로그램은 현재 Microsoft 인증 라이브러리 요청을 msalRequest라는 전역 변수에 저장합니다. 처음에는 범위의 빈 배열을 포함합니다.

const msalRequest = { scopes: [] };

다음은 샘플 응용 프로그램에서 요청에 더 많은 범위를 추가하는 데 사용하는 도우미 함수입니다.

function ensureScope (scope) {
  if (!msalRequest.scopes.some((s) => s.toLowerCase() === scope.toLowerCase())) {
    msalRequest.scopes.push(scope);
  }
}

Microsoft Graph를 호출하여 데이터를 검색할 때 도우미 함수를 호출하여 필요한 권한이 포함되는지 확인합니다.

async function getEvents() {
  ensureScope('Calendars.read');
  // ...
}

지정된 기간에 사용자의 일정 이벤트 검색

Microsoft Graph에서 사용자의 일정 이벤트를 가져오려면 앞에서 설명한 대로 /me/calendarview 엔드포인트를 호출합니다. 로그인한 사용자의 기본 일정에서 일정 이벤트의 발생 목록과 단일 인스턴스를 반환합니다. Microsoft Graph SDK를 사용하여 엔드포인트 및 실행하려는 요청 유형을 지정하여 Microsoft Graph 엔드포인트를 호출할 수 있습니다.

다음 주의 일정 이벤트만 표시하려면 다음 쿼리를 사용하여 결과의 시간 범위를 전달합니다.

graphClient
    .api('/me/calendarview')
    .query(`startDateTime=${dateNow.toISOString()}&endDateTime=${dateNextWeek.toISOString()}`);

여기서 dateNow는 현재 날짜이며, dateNextWeek는 1주 기간을 얻기 위해 현재 날짜에 7일을 더합니다.

Microsoft Graph에서 검색하고 전송하는 데이터의 양을 최소화하면 앱의 성능이 크게 향상됩니다. select 메서드를 사용하여 앱에서 사용할 결과에서 특정 속성을 선택할 수 있습니다. 반환할 속성은 쉼표로 구분된 목록으로 select에 전달됩니다.

graphClient
    .api('/me/calendarview')
    .query(` startDateTime=${dateNow.toISOString()}&endDateTime=${dateNextWeek.toISOString()} `)
    .select('subject,start,end');

orderby 메서드를 사용하여 결과의 항목을 정렬하는 방법을 지정합니다. 여러 필드를 기준으로 정렬하려면 쉼표로 구분된 필드 목록을 지정합니다. 쿼리에 asc 또는 desc 키워드를 추가하여 항목을 오름차순으로 정렬할지 또는 내림차순으로 정렬할지를 지정할 수도 있습니다.

이 앱에서는 시작 필드를 기준으로 데이터를 오름차순으로 정렬합니다. asc 또는 desc와 같은 키워드가 지정되지 않은 경우 이 순서는 기본값입니다.

graphClient
    .api('/me/calendarview')
    .query(` startDateTime=${dateNow.toISOString()}&endDateTime=${dateNextWeek.toISOString()} `)
    .select('subject,start,end')
    .orderby('Start/DateTime');

최종 Microsoft Graph 호출은 다음과 같습니다.

graphClient
    .api('/me/calendarview')
    .query(` startDateTime=${dateNow.toISOString()}&endDateTime=${dateNextWeek.toISOString()} `)
    .select('subject,start,end')
    .orderby('Start/DateTime')
    .get();