Gmail API 개요

Gmail API는 Gmail 메일함에 액세스하고 메일을 보내는 데 사용할 수 있는 RESTful API입니다. 대부분의 웹 애플리케이션에서 Gmail API는 사용자의 Gmail 데이터에 대한 승인된 액세스를 위한 최적의 선택이며 다음과 같은 다양한 애플리케이션에 적합합니다.

  • 읽기 전용 메일 추출, 색인 생성, 백업
  • 자동 또는 프로그래매틱 메시지 전송
  • 이메일 계정 이전
  • 메일 필터링 및 정렬을 비롯한 이메일 정리
  • 조직 전체의 이메일 서명 표준화

일반적인 용어

다음은 이 API에서 사용되는 일반적인 용어의 목록입니다.

위임자 및 대리인
위임자는 동일한 Google Workspace 조직 내 다른 사용자에게 편지함 액세스 권한을 부여하는 Gmail 사용자입니다. 이 액세스 권한을 부여받는 사용자가 위임자입니다. 대리인은 위임자의 계정을 대신하여 메일을 읽고 보내고 삭제할 수 있으며, 연락처를 조회하고 추가할 수도 있습니다. 자세한 내용은 위임 관리를 참고하세요.
초안
보내지 않은 메시지입니다. 초안에 포함된 메일은 대체할 수 있습니다. 임시 메일을 전송하면 임시 메일이 자동으로 삭제되고 SENT 시스템 라벨이 지정된 메일이 생성됩니다. 초안은 drafts 리소스로 표현됩니다. 자세한 내용은 임시 파일 작업을 참고하세요.
필터
수신 메일을 특정 일치 기준 (예: 발신자, 제목, 크기)에 대해 평가하도록 계정에 구성된 고급 규칙입니다. 메일이 일치하면 필터는 라벨 추가 또는 삭제, 지정된 주소로 이메일 전달과 같은 작업을 자동으로 트리거합니다. 자세한 내용은 필터 관리를 참고하세요.
전달 주소
사용자 계정에서 자동 전달된 메시지를 수신하도록 구성된 특정 확인된 이메일 주소입니다. 주소를 전달 규칙이나 필터에서 사용하려면 소유권을 증명하기 위해 공식적으로 등록하고 인증해야 합니다. 자세한 내용은 전달 관리를 참고하세요.
라벨

메시지와 대화목록을 정리하는 메커니즘입니다. 예를 들어 '세금' 라벨을 만들어 사용자의 세금과 관련된 모든 메시지와 대화에 적용할 수 있습니다. 자세한 내용은 라벨 관리를 참고하세요.

라벨에는 다음 두 가지 유형이 있습니다.

시스템 라벨
내부적으로 생성된 라벨(예: INBOX, TRASH, SPAM) 이러한 라벨은 삭제하거나 수정할 수 없습니다. 하지만 INBOX와 같은 일부 시스템 라벨은 메일 및 대화목록에 적용하거나 삭제할 수 있습니다.
사용자 라벨
사용자가 만든 라벨입니다. 이러한 라벨은 사용자나 애플리케이션에 의해 삭제되거나 수정될 수 있습니다. 사용자 라벨은 labels 리소스로 표시됩니다.
메시지

보낸 사람, 받는 사람, 제목, 본문이 포함된 이메일 메시지입니다. 메시지가 생성되면 변경할 수 없습니다. 메시지는 messages 리소스로 표현됩니다.

푸시 알림

Google Cloud Pub/Sub와 통합되는 서버 측 알림 시스템 애플리케이션은 메일함을 '감시'할 수 있으며, 변경사항 (예: 새 이메일 도착)이 발생할 때마다 Gmail API가 자동 웹훅이나 알림을 전송하므로 앱이 업데이트를 위해 서버를 지속적으로 폴링할 필요가 없습니다. 자세한 내용은 푸시 알림을 참고하세요.

S/MIME 인증서

사용자가 암호화되고 디지털 서명된 이메일을 보낼 수 있도록 특정 '보내기' 별칭에 업로드된 디지털 인증서로, 메시지 보안과 발신자 진위성을 보장합니다. 자세한 내용은 S/MIME 인증서 관리하기를 참고하세요.

보낸 사람 별칭

계정에서 메일을 보낼 수 있는 다양한 이메일 주소를 나타냅니다. 모든 계정에는 기본 이메일 주소를 나타내는 별칭이 하나 이상 있습니다. 별칭은 Gmail 웹 인터페이스의 '다음으로 보내기' 기능에 해당하며 주소별 이메일 서명을 구성하는 기반이기도 합니다. 자세한 내용은 별칭 관리를 참고하세요.

스레드

대화를 구성하는 관련 메시지의 모음입니다. 이메일 클라이언트 앱에서 하나 이상의 수신자가 자체 메시지로 메시지에 응답하면 스레드가 형성됩니다. 자세한 내용은 스레드 관리를 참고하세요.

  • 인증 및 승인 처리를 비롯한 Google Workspace API를 사용한 개발에 대해 알아보려면 Google Workspace에서 개발을 참고하세요.

  • Gmail API 앱을 구성하고 실행하는 방법을 알아보려면 빠른 시작을 참고하세요.