간단한 온라인 설문조사에 참여해 주시면 Google Workspace 문서를 개선하는 데 큰 도움이 됩니다.
Gmail API는 Gmail 메일함에 액세스하고 메일을 보내는 데 사용할 수 있는 RESTful API입니다. 대부분의 웹 애플리케이션에서 Gmail API는 사용자의 Gmail 데이터에 대한 승인된 액세스를 위한 최적의 선택이며 다음과 같은 다양한 애플리케이션에 적합합니다.
읽기 전용 메일 추출, 색인 생성, 백업
자동 또는 프로그래매틱 메시지 전송
이메일 계정 이전
메일 필터링 및 정렬을 비롯한 이메일 정리
조직 전체의 이메일 서명 표준화
다음은 Gmail API에서 사용되는 일반적인 용어 목록입니다.
메시지
보낸 사람, 받는 사람, 제목, 본문이 포함된 이메일 메시지 메시지가 생성된 후에는 메시지를 변경할 수 없습니다. 메시지는 메시지 리소스로 표시됩니다.
스레드
대화를 구성하는 관련 메시지의 컬렉션입니다. 이메일 클라이언트 앱에서 하나 이상의 수신자가 자체 메시지로 메시지에 응답하면 스레드가 형성됩니다.
라벨
메시지와 대화목록을 정리하는 메커니즘입니다. 예를 들어 '세금' 라벨을 만들어 사용자의 세금과 관련된 모든 메시지와 대화에 적용할 수 있습니다. 라벨에는 다음 두 가지 유형이 있습니다.
시스템 라벨
내부적으로 생성된 라벨(예: INBOX, TRASH, SPAM) 이러한 라벨은 삭제하거나 수정할 수 없습니다. 하지만 INBOX와 같은 일부 시스템 라벨은 메일 및 대화에 적용하거나 삭제할 수 있습니다.
사용자 라벨
사용자가 만든 라벨입니다. 이러한 라벨은 사용자나 애플리케이션에 의해 삭제되거나 수정될 수 있습니다. 사용자 라벨은 라벨 리소스로 표시됩니다.
초안
전송되지 않은 메시지입니다. 초안에 포함된 메일은 대체할 수 있습니다.
임시보관 메일을 보내면 임시보관 메일이 자동으로 삭제되고 SENT 시스템 라벨이 지정된 메일이 생성됩니다. 초안은 초안 리소스로 표시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-03(UTC)"],[],[],null,["|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\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- 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)."]]
