Dzienniki aktywności tablicy
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. |
boardpulse |
| 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. |