예약된 일반 검색 연산자
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에는 Google Cloud Search 내에서 사용할 수 있는 예약된 검색 연산자와 일반적인 검색 연산자가 나열되어 있습니다. 예약된 연산자는 Google Cloud Search 전용으로 사용되며 스키마에서 사용할 수 없습니다. 일반 연산자는 Gmail과 같은 다른 Google Workspace 앱에서 공통적으로 사용되지만 스키마에서 사용할 수 있습니다.
일반적인 연산자를 사용할 때는 주의해야 합니다. 다른 앱에서 이러한 연산자를 사용하는 데 익숙한 사용자는 Cloud Search의 다른 구현에 혼동을 느낄 수 있습니다.
예약된 연산자
스키마에서는 다음 연산자를 사용할 수 없습니다.
| 연산자 |
정의 |
source |
특정 제품 또는 데이터 소스에서 콘텐츠 찾기 |
site |
특정 사이트에서 콘텐츠를 찾습니다. |
inurl |
특정 URL에서 콘텐츠를 찾습니다. |
contenttype |
특정 유형(문서, 스프레드시트, 프레젠테이션, 이미지, 폴더, 첨부파일)의 콘텐츠를 찾습니다. |
mimetype |
원본 MIME 유형을 기반으로 콘텐츠를 찾습니다. |
type |
특정 유형(문서, 스프레드시트, 프레젠테이션, 이미지, 폴더, 첨부파일)의 콘텐츠를 찾습니다. |
owner |
소유하거나 나와 공유된 콘텐츠를 찾습니다. 서드 파티 저장소에서 제공되는 콘텐츠의 경우 유효한 값은 owner:me뿐입니다. Google Workspace 콘텐츠의 경우 owner:identity를 사용할 수도 있습니다. 여기서 identity는 소유자의 이름, 사용자 이름 또는 이메일 주소일 수 있습니다. |
from |
콘텐츠를 보내거나 만든 특정 사용자의 콘텐츠를 찾습니다. 이 연산자는 owner의 별칭으로 사용됩니다. |
before |
특정 날짜(YYYY/MM/DD 형식) 전에 수정된 콘텐츠를 찾습니다. |
after |
특정 날짜(YYYY/MM/DD 형식) 또는 그 이후에 수정된 콘텐츠를 찾습니다. |
createddatetimestampbefore |
특정 날짜(YYYY/MM/DD 형식) 전에 생성된 콘텐츠를 찾습니다. |
createddatetimestampafter |
특정 날짜(YYYY/MM/DD 형식) 또는 그 이후에 생성된 콘텐츠를 찾습니다. |
itemsize |
특정 크기(바이트 단위로 지정)의 콘텐츠를 찾습니다. |
itemsizelessthan |
특정 크기(바이트 단위로 지정)보다 작은 콘텐츠를 찾습니다. |
itemsizegreaterthan |
특정 크기(바이트 단위로 지정)보다 크거나 같은 콘텐츠를 찾습니다. |
in |
이 연산자의 사용 여부는 아직 결정되지 않았습니다. |
is |
이 연산자의 사용 여부는 아직 결정되지 않았습니다. |
has |
이 연산자의 사용 여부는 아직 결정되지 않았습니다. |
to |
이 연산자의 사용 여부는 아직 결정되지 않았습니다. |
표의 마지막 네 개의 연산자는 예약되어 있지만 아직 구체적인 정의가 없습니다.
사용자가 특정 연산자를 사용하는 방법에 관한 자세한 내용은 검색 범위 좁히기를 참고하세요.
일반적인 연산자
스키마에서 다음 연산자를 선언할 수 있습니다. 사용자의 혼동을 최소화하려면 다음 표의 정의와 사용이 일치하도록 이러한 연산자를 선언하세요.
| 연산자 |
사용 주체 |
정의 |
size |
Gmail |
지정된 크기(바이트 단위)보다 큰 항목을 찾습니다. |
larger |
Gmail |
지정된 크기(바이트 단위)보다 큰 항목을 찾습니다. size와 동의어입니다. |
smaller |
Gmail |
지정된 크기(바이트 단위)보다 작은 항목을 찾습니다. |
older_than |
Gmail |
특정 날짜보다 오래된 항목을 찾습니다. |
newer_than |
Gmail |
특정 날짜보다 최신 항목을 찾습니다. |
subject |
Gmail |
특정 제목 또는 제목이 있는 항목을 찾습니다. |
label |
Gmail |
특정 라벨이 있는 항목을 찾습니다. |
list |
Gmail |
특정 메일링 리스트의 항목을 찾습니다. |
cc |
Gmail |
cc 필드에서 특정 수신자가 있는 항목을 찾습니다. |
bcc |
Gmail |
bcc 필드에서 특정 수신자가 있는 항목 찾기 |
deliveredto |
Gmail |
특정 이메일 주소로 전송된 항목을 찾습니다. |
category |
Gmail |
특정 카테고리의 항목을 찾습니다. |
title |
드라이브 |
지정된 제목의 항목과 일치합니다. |
app |
드라이브 |
특정 앱으로만 열 수 있는 항목을 검색합니다. |
mailthreadid |
Gmail |
지정된 스레드 ID와 일치하는 항목을 반환합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Reserved and common search operators\n\nThis document lists the *reserved* and common search operators available within\nGoogle Cloud Search. *Reserved* operators have Google Cloud Search-specific\nuse and cannot be used in your schema. *Common* operators are common to\nother Google Workspace apps, such as Gmail, but can be used in your schema.\nBe cautious when using common operators, because users who are familiar with\ntheir use in other apps might be confused by a different implementation in\nCloud Search.\n\nReserved operators\n------------------\n\nYou cannot use any of the following operators in your schema:\n\n| Operator | Definition |\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `source` | Find content from a particular product or data source |\n| `site` | Find content from a particular site. |\n| `inurl` | Find content from a particular url. |\n| `contenttype` | Find particular types of content, such as documents, spreadsheets, presentations, images, folders, and attachments. |\n| `mimetype` | Finds content based on the original mimetype. |\n| `type` | Find particular types of content, such as documents, spreadsheets, presentations, images, folders, and attachments. |\n| `owner` | Find content you own or that's been shared with you. For content originating from third party repositories, the only valid value is `owner:me`. For Google Workspace content, you can also use owner:*identity* where *identity* can be the owner's name, username, or email address. |\n| `from` | Find content from a specific person who sent or created the content. This operator is used as an alias for `owner`. |\n| `before` | Find content modified before a certain date, using the format YYYY/MM/DD. |\n| `after` | Find content modified on or after a certain date, using the format YYYY/MM/DD. |\n| `createddatetimestampbefore` | Find content created before a certain date, using the format YYYY/MM/DD. |\n| `createddatetimestampafter` | Find content created on or after a certain date, using the format YYYY/MM/DD. |\n| `itemsize` | Find content with a particular size specified in bytes. |\n| `itemsizelessthan` | Find content less than a particular size specified in bytes. |\n| `itemsizegreaterthan` | Find content greater than or equal to a particular size specified in bytes. |\n| `in` | The use of this operator has not been determined. |\n| `is` | The use of this operator has not been determined. |\n| `has` | The use of this operator has not been determined. |\n| `to` | The use of this operator has not been determined. |\n\nThe last four operators in the table are reserved, but do not yet have a\nspecific definition.\n\nFor information on how users use a specific operator, refer to\n[Narrow your search](https://support.google.com/cloudsearch/answer/6172299).\n\nCommon operators\n----------------\n\nYou may declare the following operators in your schema. To minimize user\nconfusion, declare these operators so their usage is consistent with the\ndefinition in the following table.\n\n| Operator | Used by | Definition |\n|----------------|---------|-------------------------------------------------------------------------|\n| `size` | Gmail | Find items larger than the given size in bytes. |\n| `larger` | Gmail | Find items larger than the given size in bytes. Synonymous with `size`. |\n| `smaller` | Gmail | Find items smaller than a given size in bytes. |\n| `older_than` | Gmail | Find items older than a given date. |\n| `newer_than` | Gmail | Find items newer than a given date. |\n| `subject` | Gmail | Find items with a specific subject or title. |\n| `label` | Gmail | Find items with a given label. |\n| `list` | Gmail | Find items from a given mailing list. |\n| `cc` | Gmail | Find items with the given recipient in the `cc` field. |\n| `bcc` | Gmail | Find items with the given recipient in the `bcc` field |\n| `deliveredto` | Gmail | Find items delivered to the given email address. |\n| `category` | Gmail | Find items with a given category. |\n| `title` | Drive | Matches item with a given title. |\n| `app` | Drive | Search for items that can only be opened by a specific app. |\n| `mailthreadid` | Gmail | Matches items with the given thread ID. |"]]
