필터와 정렬

​

조건 묶기

{
  "filter": {
    "and": [
      {
        "property": "상태",
        "status": {
          "equals": "진행 중"
        }
      },
      {
        "or": [
          {
            "property": "담당 팀",
            "select": {
              "equals": "운영"
            }
          },
          {
            "property": "담당 팀",
            "select": {
              "is_empty": true
            }
          }
        ]
      }
    ]
  }
}

​

속성 조건

​

글 조건

• 값의 앞뒤 공백을 지우고 비교합니다. 대소문자를 구분하지 않습니다. equals도 같습니다.
• 공백을 지워 비면 그 조건은 모든 행에 맞습니다. equals: ""도 같습니다.

​

선택 조건

• 값은 이름 하나 또는 이름 배열입니다. 배열은 그중 하나에 맞으면 됩니다.
• 이름은 대소문자를 구분합니다. 없는 이름은 400 select option "X" not found for property "P". Available options: ...입니다.
• status는 그룹 이름 To-do · In progress · Complete도 받습니다. 그 그룹의 선택지 모두에 맞습니다.
• 빈 글 하나는 조건이 없는 것과 같습니다.

​

날짜 조건

• 값은 ISO 8601 글이나 today · tomorrow · yesterday · one_week_ago · one_week_from_now · one_month_ago · one_month_from_now입니다.
• 시각이 없는 값은 UTC 그날 0시입니다. equals는 그날 하루, after는 다음 날부터입니다.
• 시각이 있고 오프셋이 없는 값은 UTC로 읽습니다. 범위 값은 시작 날짜로 비교합니다.
• past_week 같은 조건의 값은 빈 객체 {}입니다. this_week는 UTC 일요일부터 7일입니다. past_week와 next_week는 오늘을 포함합니다.

{ "property": "마감일", "date": { "on_or_after": "today" } }

{ "property": "마감일", "date": { "next_week": {} } }

​

사람과 관계 조건

​

시각으로 거르기

{
  "filter": {
    "timestamp": "last_edited_time",
    "last_edited_time": { "on_or_after": "2026-01-15T00:00:00Z" }
  }
}

​

정렬

{
  "sorts": [
    {
      "property": "마감일",
      "direction": "ascending"
    },
    {
      "timestamp": "created_time",
      "direction": "descending"
    }
  ]
}

• direction은 ascending 또는 descending입니다.
• timestamp는 created_time 또는 last_edited_time입니다. 정렬은 분 단위가 아니라 저장된 시각으로 합니다.
• 정렬이 없거나 값이 같으면 만든 시각이 늦은 행부터 반환합니다.
• 빈 값은 오름차순과 내림차순 모두 뒤에 옵니다.
• 글은 대소문자를 구분하지 않고, 같으면 대문자가 먼저입니다.
• select는 선택지 순서로 정렬합니다.

​

성능

​

자주 발생하는 오류