Gmail API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Gmail API는 Gmail 메일함에 액세스하고 메일을 보내는 데 사용할 수 있는 RESTful API입니다. 대부분의 웹 애플리케이션에서 Gmail API는 사용자의 Gmail 데이터에 대한 승인된 액세스를 위한 최적의 선택이며 다음과 같은 다양한 애플리케이션에 적합합니다.
- 읽기 전용 메일 추출, 색인 생성, 백업
- 자동 또는 프로그래매틱 메시지 전송
- 이메일 계정 이전
- 메일 필터링 및 정렬을 비롯한 이메일 정리
- 조직 전체의 이메일 서명 표준화
다음은 Gmail API에서 사용되는 일반적인 용어 목록입니다.
- 메시지
- 보낸 사람, 받는 사람, 제목, 본문이 포함된 이메일 메시지 메시지가 생성된 후에는 메시지를 변경할 수 없습니다. 메시지는 메시지 리소스로 표현됩니다.
- 스레드
- 대화를 구성하는 관련 메시지의 컬렉션입니다. 이메일 클라이언트 앱에서 하나 이상의 수신자가 자체 메시지로 메시지에 응답하면 스레드가 형성됩니다.
- 라벨
메시지와 대화목록을 정리하는 메커니즘입니다. 예를 들어 '세금' 라벨을 만들어 사용자의 세금과 관련된 모든 메시지와 대화에 적용할 수 있습니다. 라벨에는 다음 두 가지 유형이 있습니다.
- 시스템 라벨
- 내부적으로 생성된 라벨(예:
INBOX
, TRASH
, SPAM
) 이러한 라벨은 삭제하거나 수정할 수 없습니다. 하지만 INBOX
와 같은 일부 시스템 라벨은 메일 및 대화목록에 적용하거나 삭제할 수 있습니다.
- 사용자 라벨
- 사용자가 만든 라벨입니다. 이러한 라벨은 사용자나 애플리케이션에 의해 삭제되거나 수정될 수 있습니다. 사용자 라벨은 라벨 리소스로 표시됩니다.
- 초안
전송되지 않은 메시지입니다. 초안에 포함된 메일은 대체할 수 있습니다.
임시보관 메일을 보내면 임시보관 메일이 자동으로 삭제되고 SENT
시스템 라벨이 지정된 메일이 생성됩니다. 초안은 초안 리소스로 표시됩니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Gmail API Overview\n\nThe Gmail API is a RESTful API that can be used to access Gmail mailboxes and\nsend mail. For most web applications the Gmail API is the best choice for\nauthorized access to a user's Gmail data and is suitable for various\napplications, such as:\n\n- Read-only mail extraction, indexing, and backup\n- Automated or programmatic message sending\n- Email account migration\n- Email organization including filtering and sorting of messages\n- Standardization of email signatures across an organization\n\nFollowing is a list of common terms used in the Gmail API:\n\n*Message*\n: An email message containing the sender, recipients, subject, and body. After a\n message has been created, a message cannot be changed. A message is represented\n by a [message resource](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n*Thread*\n: A collection of related messages forming a conversation. In an email client\n app, a thread is formed when one or more recipients respond to a message with\n their own message.\n\n*Label*\n\n: A mechanism for organizing messages and threads. For example,\n the label \"taxes\" might be created and applied to all messages and threads\n having to do with a user's taxes. There are two types of labels:\n\n *System labels*\n : Internally-created labels, such as `INBOX`, `TRASH`, or `SPAM`. These labels\n cannot be deleted or modified. However, some system labels, such as `INBOX`\n can be applied to, or removed from, messages and threads.\n\n *User labels*\n : Labels created by a user. These labels can be deleted or modified by the\n user or an application. A user label is represented by a\n [label resource](/workspace/gmail/api/reference/rest/v1/users.labels).\n\n*Draft*\n\n: An unsent message. A message contained within the draft can be replaced.\n Sending a draft automatically deletes the draft and creates a message with\n the `SENT` system label. A draft is represented by a\n [draft resource](/workspace/gmail/api/reference/rest/v1/users.drafts).\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Gmail API app, read the\n [Quickstarts overview](/workspace/gmail/api/guides/quickstarts-overview)."]]