Użyj tego narzędzia, aby pobrać pełną strukturę tablicy monday.com przed wykonaniem operacji, które wymagają znajomości identyfikatorów kolumn i grup lub konfiguracji tablicy. Odpowiedź zawiera definicje kolumn (identyfikatory, typy, ustawienia i etykiety statusu), nazwy i identyfikatory grup, widoki tablicy wraz z konfiguracją filtrów, informacje o właścicielach oraz strukturę kolumn podelementów.

To narzędzie jest wymaganym krokiem wstępnym przed wywołaniem get_board_items_page, create_item, change_item_column_values lub board_insights dla nieznanej tablicy. Służy też do obsługi filtrów opartych na widokach: jeśli użytkownik odwołuje się do zapisanego widoku po nazwie, najpierw wywołaj to narzędzie, aby pobrać obiekt filtra widoku.

Parametry

Przykład

Pobierz metadane tablicy o identyfikatorze 18392419286:

{
  "boardId": 18392419286
}

Odpowiedź zawierała nazwę tablicy (Single Marketing Project), 8 kolumn (w tym kolumny status, date, people i file wraz z ich identyfikatorami i ustawieniami), 5 grup (Planning, Design, Content, Channels, Done Tasks), 5 zapisanych widoków (Gantt, Kanban, wykres, obciążenie, pliki) oraz strukturę kolumn tablicy podelementów. Ustawienia kolumny statusu zawierały definicje wszystkich etykiet wraz z ich indeksami i kolorami w formacie szesnastkowym.

Odpowiednik programowy

Aby uzyskać ten sam wynik, użyj interfejsu API GraphQL:

query {
  boards(ids: [18392419286]) {
    id
    name
    description
    board_kind
    state
    permissions
    url
    columns {
      id
      title
      type
      settings_str
    }
    groups {
      id
      title
    }
    owners {
      id
      name
    }
    views {
      id
      name
      type
    }
    workspace {
      id
      name
    }
  }
}

Pełną dokumentację znajdziesz w sekcji Tablice.