Dokumentacja dla programistów

Dzienniki aktywności tablicy

Aktualizacja 2026-10-30

This API changes starting from version 2027-01. From 2027-01, board activity logs include more entities, are limited to events from the last 90 days, and use cursor pagination. The description below applies to versions before 2027-01. For 2027-01 and later, see Get board activity logs in 2027-01 and later.

Only available in API versions 2027-01 and later

Ta strona opisuje pole activity_logs w obiekcie Board - dostępne wyłącznie jako zagnieżdżone pole w zapytaniu boards.

Informacje o aktywności użytkowników (users { activity_logs }), limitach zapytań, wymaganiu korzystania z wersji API 2026-07 oraz planach dotyczących zapytań obejmujących wiele tablic lub użytkowników znajdziesz w głównym przewodniku po dziennikach aktywności.

Dzienniki aktywności tablicy zawierają wpisy o działaniach wykonanych na tej tablicy. Dzięki nim sprawdzisz, jakie działania wykonano, kiedy do nich doszło i kto je wykonał.

Zapytania

Pobieranie dzienników aktywności tablicy

  • Limit: do 10 000 wpisów
  • Zwraca tablicę zawierającą metadane kolekcji dzienników aktywności z określonej tablicy, posortowanych od najnowszych do najstarszych
  • Można je zagnieżdżać wyłącznie w zapytaniu boards
query {
  boards(
    ids: [1234567890]
  ) {
    activity_logs(
      from: "2021-07-23T00:00:00Z"
      to: "2021-07-26T00:00:00Z"
    ) {
      id
      event
      data
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board_id: [ID!], $from: ISO8601DateTime!, $to: ISO8601DateTime!) { boards (ids: $board_id) { activity_logs (from: $from, to: $to) { id event data }}}`;
const variables = {
  board_id: 1234567890,
  from: "2024-07-23T00:00:00Z",
  to: "2024-07-26T00:00:00Z",
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument Typ Opis
column_ids [String] Konkretne kolumny, dla których mają zostać zwrócone zdarzenia.
from ISO8601DateTime Początkowy znacznik czasu (ISO8601).
group_ids [String] Konkretne grupy, dla których mają zostać zwrócone zdarzenia.
item_ids [ID!] Konkretne elementy, dla których mają zostać zwrócone zdarzenia.
limit Int Liczba zdarzeń z dziennika aktywności do zwrócenia. Domyślnie 25.
page Int Numer strony do zwrócenia. Numeracja zaczyna się od 1.
to ISO8601DateTime Końcowy znacznik czasu (ISO8601).
user_ids [ID!] Konkretni użytkownicy, dla których mają zostać zwrócone zdarzenia.

Pola

Pole Typ Opis Wartości wyliczeniowe
account_id String! Unikalny identyfikator konta, które zainicjowało zdarzenie.
data String! Wartości kolumn elementu.
entity String! Typ obiektu, którego dotyczy zmiana. Użyj tego pola - pole entity_id nie jest dostępne w typie ActivityLogType. board
pulse
event String! Wykonana czynność.
id String! Unikalny identyfikator zdarzenia z dziennika aktywności.
user_id String! Unikalny identyfikator użytkownika, który zainicjował zdarzenie.
created_at String! Czas zdarzenia zapisany jako 17-cyfrowy znacznik czasu Unix. Aby przekonwertować go na czas Unix w milisekundach, podziel 17-cyfrową wartość przez 10 000 i zaokrąglij do najbliższej liczby całkowitej. Aby uzyskać czas Unix w sekundach, podziel wartość przez 10 000 000.