Node.JS에 Google 캘린더 API 통합: 이벤트 생성 및 회의 예약 가이드

Google Calendar API는 프로그래밍 방식으로 이벤트를 관리하고 회의 일정을 예약할 수 있는 강력한 도구입니다. 이 튜토리얼에서는 API를 Node.js 애플리케이션에 통합하여 OAuth 인증을 처리하고, 액세스 토큰을 검색하고, 이벤트를 생성하는 과정을 안내합니다. 또한 원활한 사용자 경험을 위해 프런트엔드 애플리케이션의 리디렉션 처리에 대해서도 다룹니다.

전제조건

• Node.js(버전 18).
• 캘린더 API가 활성화된 Google 클라우드 프로젝트
• Google Cloud Console의 자격 증명. 설정하려면 다음 단계를 따르세요.
  1. Google Cloud Console으로 이동합니다.
  2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요.
  3. 프로젝트에 Google Calendar API를 활성화하세요.
  4. API 및 서비스 >로 이동 자격 증명 및 OAuth 2.0 자격 증명을 생성합니다.
  5. 자격증명 JSON 파일을 다운로드하여 프로젝트에 cleint_secrets.json으로 저장하세요.
• 자격증명(client_id, client_secret 등)을 안전하게 저장하기 위한 .env 또는 client_secrets.json 파일.
• googleapis npm 패키지가 설치되었습니다(npm install googleapis).

---

Google OAuth 인증 설정

첫 번째 단계는 사용자가 Google 계정으로 인증하고 캘린더 관리에 대한 액세스 권한을 부여하도록 허용하는 것입니다. 이는 OAuth2 프로토콜

을 사용하여 달성됩니다.

1단계: 인증 URL 생성

Google OAuth2 인증 URL을 생성하는 방법은 다음과 같습니다.

async googleAuthConsent() {
  try {
    // Read credentials from a file
    const credentials = JSON.parse(
      await promisify(fs.readFile)('./client_secrets.json', 'utf-8'),
    );

    // change this with your redirect url
    const REDIRECT_URI = "http://localhost:3000";

    const oauth2Client = new google.auth.OAuth2(
      credentials.web.client_id,
      credentials.web.client_secret,
      REDIRECT_URI,
    );

    const scopes = ['https://www.googleapis.com/auth/calendar'];

    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
    });

    return {
      message: 'Auth URL created successfully',
      url: authUrl,
    };
  } catch (error) {
    throw new Error(error.message || 'Internal Server Error');
  }
}

핵심 포인트:

• 범위: 액세스 수준을 지정합니다. 캘린더 이벤트의 경우 범위는 https://www.googleapis.com/auth/calendar입니다.
• 액세스 유형: 오프라인으로 설정하면 새로 고침 토큰이 반환됩니다.

---

2단계: 액세스 토큰 처리

사용자는 생성된 URL을 통해 인증한 후 코드를 통해 애플리케이션으로 리디렉션됩니다. 이 코드는 토큰으로 교환됩니다.

async generateGoogleOAuthToken(
  data: { code: string; scope: string },
) {
  try {
    const { code } = data;

    const credentials = JSON.parse(
      await promisify(fs.readFile)('./client_secrets.json', 'utf-8'),
    );

    // change this with your redirect url
    const REDIRECT_URI = "http://localhost:3000";

    const oauth2Client = new google.auth.OAuth2(
      credentials.web.client_id,
      credentials.web.client_secret,
      REDIRECT_URI,
    );

    const { tokens } = await oauth2Client.getToken(code);

    // your logic for storing token i.g. database or file 

    return {
      message: 'User OAuth Token Generated Successfully',
      token,
    };
  } catch (error) {
    throw new Error(error.message || 'Internal Server Error');
  }
}

---

3단계: 이벤트 생성

토큰이 안전하게 저장되었으므로 이제 Google Calendar API를 사용하여 이벤트를 만들 수 있습니다. 다음은 시간, 참석자, 알림 및 선택적 Google Meet 링크와 같은 이벤트 세부정보를 포함하여 회의를 예약하는 일반적인 방법입니다.

일반 이벤트 생성 방법

이 방법은 다음을 달성합니다.

1. 사용자 인증: OAuth2를 사용하여 Google로 인증합니다.
2. 이벤트 만들기: 사용자의 기본 캘린더에 이벤트를 삽입합니다.
3. 추가 기능 포함: Google Meet 링크, 참석자, 맞춤 알림과 같은 옵션을 추가하세요.

async googleAuthConsent() {
  try {
    // Read credentials from a file
    const credentials = JSON.parse(
      await promisify(fs.readFile)('./client_secrets.json', 'utf-8'),
    );

    // change this with your redirect url
    const REDIRECT_URI = "http://localhost:3000";

    const oauth2Client = new google.auth.OAuth2(
      credentials.web.client_id,
      credentials.web.client_secret,
      REDIRECT_URI,
    );

    const scopes = ['https://www.googleapis.com/auth/calendar'];

    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
    });

    return {
      message: 'Auth URL created successfully',
      url: authUrl,
    };
  } catch (error) {
    throw new Error(error.message || 'Internal Server Error');
  }
}

핵심 포인트:

• OAuth2 인증: 사용자의 Google 캘린더에 대한 보안 액세스를 보장합니다.
• 회의 데이터: 지정 시 Google Meet 링크를 자동으로 추가합니다.
• 알림: 이메일 및 팝업 알림과 같은 맞춤형 옵션
• 오류 처리: 더 나은 디버깅을 위한 적절한 오류 메시지.

---

프런트엔드 통합

Google 인증 후 리디렉션을 처리하려면 프런트엔드에서 다음을 수행해야 합니다.

1. Google 인증 URL로 리디렉션: 사용자가 인증 프로세스를 시작할 때 트리거됩니다.
2. 콜백 처리: 인증 코드를 캡처하여 토큰 생성을 위해 백엔드로 보냅니다.

예시 흐름:

• 버튼 클릭 -> 인증 URL로 리디렉션합니다.
• Google이 인증하고 다시 앱으로 리디렉션합니다.
• 앱이 코드를 캡처하고 API 엔드포인트를 호출하여 토큰을 생성합니다.

최종 생각

이 통합은 NodeJS 애플리케이션에 강력한 일정 기능을 구축하기 위한 첫 번째 단계입니다. 다음 부분에서는 일반적인 이벤트 생성 방법을 다룹니다. 사용자 상호 작용을 위한 프런트엔드와 결합하면 최소한의 노력으로 강력한 일정 관리 솔루션을 만들 수 있습니다.

완전한 구현과 이벤트 관리 과정을 지켜봐 주시기 바랍니다!

이 튜토리얼 영상을 보고 싶으시다면 아래 댓글을 남겨주세요!

위 내용은 Node.JS에 Google 캘린더 API 통합: 이벤트 생성 및 회의 예약 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!