Dokumentacja dla programistów

Inne typy

Aktualizacja 2026-10-29

Only available in API versions 2027-01 and later

Interfejs API monday.com items_page umożliwia odczytywanie elementów tablicy za pomocą rozbudowanych filtrów.

Każdy z opisanych poniżej typów obiektów reprezentuje konkretny aspekt filtra. Możesz przekazać je jako argumenty, aby zdefiniować zapytanie o elementy z filtrem.

ItemsQuery

Obiekt zawierający zestaw parametrów do filtrowania i sortowania zapytania oraz określania jego zakresu.

Pole Opis Wartości wyliczeniowe Obsługiwane pola
groups [ItemsQueryGroup!] Reguły grup i atrybuty używane do filtrowania zapytań. groups [ItemsQueryGroup!]\ operator ItemsQueryOperator\ rules [ItemsQueryRule!]
ids [ID!] Identyfikatory konkretnych elementów, które mają zostać zwrócone. Maksymalna liczba to 100.
operator ItemsQueryOperator Warunki łączące reguły zapytania. Domyślnie jest to and. and or
order_by [ItemsQueryOrderBy!] Atrybuty, według których sortowane są wyniki. column_id String!\ direction ItemsOrderByDirection
rules [ItemsQueryRule!] Reguły używane do filtrowania zapytań. column_id ID!\ compare_attribute String\ compare_value CompareValue!\ operator ItemsQueryRuleOperator

ItemsQueryGroup

Obiekt zawierający reguły grup.

Pole Opis Wartości wyliczeniowe Obsługiwane pola
groups [ItemsQueryGroup!] Reguły grup i atrybuty używane do filtrowania zapytań. groups [ItemsQueryGroup!]\ operator ItemsQueryOperator\ rules [ItemsQueryRule!]
operator ItemsQueryOperator Warunki łączące reguły zapytania. Domyślnie jest to and. and\ or
rules [ItemsQueryRule!] Reguły używane do filtrowania zapytań. column_id ID!\ compare_attribute String\ compare_value CompareValue!\ operator ItemsQueryRuleOperator

ItemsQueryOrderBy

Obiekt zawierający atrybuty, według których sortowane są wyniki.

Pole Opis Wartości wyliczeniowe
column_id String! Unikalny identyfikator kolumny, według której mają być filtrowane lub sortowane wyniki. Możesz też wpisać "__creation_log__" lub "__last_updated__", aby chronologicznie posortować wyniki według daty ich ostatniej aktualizacji lub utworzenia (od najstarszych do najnowszych).
direction ItemsOrderByDirection Kierunek sortowania elementów. Domyślnie jest to asc. asc\ desc

ItemsQueryRule

Obiekt zawierający reguły używane do filtrowania zapytań.

Pole Opis Wartości wyliczeniowe
column_id ID! Unikalny identyfikator kolumny, według której mają być filtrowane wyniki.
compare_attribute String Atrybut porównania. Obsługiwane atrybuty poszczególnych typów kolumn znajdziesz w dokumentacji typów kolumn. Większość kolumn nie ma atrybutu compare_attribute.
compare_value CompareValue! Wartość kolumny, według której mają być filtrowane wyniki. Zależnie od typu kolumny może to być string lub wartość indeksu. Obsługiwane wartości poszczególnych typów kolumn znajdziesz w dokumentacji typów kolumn.
operator ItemsQueryRuleOperator Warunek porównania wartości. Domyślnie jest to any_of. any_of\ not_any_of\ is_empty\ is_not_empty\ greater_than\ greater_than_or_equals\ lower_than\ lower_than_or_equal\ between\ not_contains_text\ contains_text\ contains_terms\ starts_with\ ends_with\ within_the_next\ within_the_last