이 문서에서는 Gmail API를 사용하여 메시지를 쿼리하고 찾는 방법을 설명합니다.
messages.list 및 threads.list 메서드를 사용하여 파일을 검색하거나 필터링할 수 있습니다. 이러한 메서드는 Gmail 웹 인터페이스와 대부분 동일한 고급 검색 문법을 지원하는 q 쿼리 매개변수를 허용합니다. Gmail UI와 Gmail API 간의 검색 및 필터 차이점 목록은 Gmail UI와의 차이점을 참고하세요.
이 고급 검색 구문을 사용하면 발신자, 날짜, 라벨과 같은 속성으로 메일을 필터링할 수 있습니다. 예를 들어 다음 messages.list 메서드 쿼리는 2014년 1월에 사용자가 보낸 모든 메일을 검색합니다.
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
검색어 외에도 labelIds[] 매개변수를 사용하여 라벨별로 메일과 대화목록을 필터링할 수 있습니다. 이렇게 하면 지정된 시스템 또는 사용자 라벨이 적용된 메일과 대화목록을 검색할 수 있습니다. 자세한 내용은 messages.list 및 threads.list 메서드를 참고하세요. 라벨에 대한 자세한 내용은 라벨 관리를 참고하세요.
Gmail UI와의 차이점
Gmail API는 Gmail UI에서 사용되는 고급 검색 구문 대부분을 지원하지만 몇 가지 차이점이 있습니다.
Gmail UI는 별칭 확장을 실행하여 Google Workspace 계정에서 계정 별칭을 추론할 수 있습니다. 예를 들어 계정이
myprimary@cymbalgroup.com이고 관리자가 해당 계정의 별칭을myalias@cymbalgroup.com로 설정한다고 가정해 보겠습니다.myalias@cymbalgroup.com가 이메일을 보냈는데 'from: myprimary@cymbalgroup.com'을 검색하면myalias@cymbalgroup.com가 보낸 이메일이 Gmail UI의 검색 결과에 표시되지만 API 응답에는 표시되지 않습니다.Gmail UI에서는 사용자가 스레드 전체 검색을 실행할 수 있지만 API에서는 실행할 수 없습니다.