messages.list 및 threads.list 메서드를 사용하여 파일을 검색하거나 필터링할 수 있습니다.
이러한 메서드는 Gmail 웹 인터페이스와 동일한 고급검색 구문을 대부분 지원하는 q 매개변수를 허용합니다. Gmail UI와 Gmail API의 검색 및 필터 차이점 목록은 검색 필터 차이점: Gmail UI와 Gmail API 비교를 참조하세요.
이 고급 구문을 사용하면 검색어를 통해 발신자, 날짜, 라벨과 같은 속성별로 메시지를 필터링하여 몇 가지 가능성을 지정할 수 있습니다. 예를 들어 다음 쿼리는 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는 Google Workspace 계정에서 계정 별칭을 추론할 수 있도록 별칭 확장을 수행합니다. 예를 들어
myprimary@mycompany.net계정이 있고 관리자가myalias@mycompany.net계정의 별칭을 설정한다고 가정해 보겠습니다.myalias@mycompany.net이 이메일을 보냈는데 'from: myprimary@mycompany.net)'를 검색하면myalias@mycompany.net에서 보낸 이메일이 Gmail UI 검색 결과로 표시되지만 API 응답에는 표시되지 않습니다.Gmail UI에서는 사용자가 스레드 전체 검색을 할 수 있지만 API는 그렇게 할 수 없습니다.