Poniższe typy są używane przez backfill_items, ingest_items i fetch_job_status.

---

BulkImportFailureReason

Enum zwracany w polu failure_reason, gdy zadanie kończy się stanem REJECTED lub FAILED.

Wartość enuma	Opis
ACCOUNT_CAPACITY_EXCEEDED	Przekroczono limit pojemności konta (obejmuje kontrolę godzinowego limitu tworzenia i aktualizowania elementów podczas importu).
AUTHORIZATION_FAILED	Uwierzytelnianie lub autoryzacja wywołującego nie powiodły się.
BOARD_CAPACITY_EXCEEDED	Tablica osiągnęła maksymalny limit elementów.
FILE_TOO_LARGE	Przesłany plik przekroczył limit 150 MB.
INTERNAL_ERROR	Wystąpił nieoczekiwany błąd serwera.
INVALID_UPLOAD	Parsowanie lub walidacja pliku CSV nie powiodły się (np. z powodu nieprawidłowego nagłówka, niewłaściwego separatora kolumn, błędnie sformatowanych wierszy lub nieprawidłowych wierszy hierarchii wielopoziomowych podelementów).
PERMISSION_DENIED	Wywołujący nie ma wymaganych uprawnień do wykonania tej operacji.

---

BulkImportState

Enum zwracany w polu status, opisujący bieżący stan zadania.

Wartość enuma	Opis
COMPLETED	Przetwarzanie zakończone. Sprawdź pole counts, aby zobaczyć częściowe niepowodzenia.
FAILED	Zadanie nie powiodło się podczas przetwarzania. Sprawdź pola failure_reason i failure_message.
PROCESSING	Trwa przetwarzanie wierszy.
REJECTED	Zadanie zostało odrzucone przed zakończeniem przetwarzania.
UPLOAD_PENDING	Oczekiwanie na przesłanie pliku CSV pod adres upload_url lub przesyłanie pliku jest w toku.

---

ItemsJobItemCounts

Liczniki wierszy dla poszczególnych etapów, zwracane w polu ItemsJobStatus.counts.

Pole	Typ	Opis
created	Int	Liczba elementów utworzonych w monday.com. W przypadku importu hierarchii wielopoziomowych podelementów obejmuje utworzone elementy nadrzędne i podrzędne.
failed	Int	Liczba prawidłowych wierszy (które przeszły walidację), których przetwarzanie nie powiodło się.
invalid	Int	Liczba wierszy, które nie przeszły walidacji. W przypadku importu hierarchii MLS mogą to być wiersze bez wypełnionej kolumny poziomu, z wypełnionymi kilkoma kolumnami poziomu lub z błędami hierarchii.
skipped	Int	Liczba pominiętych wierszy (np. w wyniku użycia on_match: { behaviour: SKIP } przy zwykłym imporcie elementów). Importy hierarchii MLS służą wyłącznie do tworzenia i nie należy w nich używać SKIP.
submitted	Int	Łączna liczba wierszy przesłanych w pliku.
updated	Int	Liczba zaktualizowanych istniejących elementów (np. w wyniku użycia on_match: { behaviour: UPSERT } przy zwykłym imporcie elementów). Importy hierarchii MLS służą wyłącznie do tworzenia i nie należy w nich używać UPSERT.

---

ItemsJobStatus

Typ zwracany przez fetch_job_status za pośrednictwem unii JobStatus. Pełna lista pól znajduje się w dokumentacji API Ingest items; poniżej znajdziesz krótkie podsumowanie.

Pole	Typ	Opis
status	BulkImportState	Bieżący stan zadania.
counts	ItemsJobItemCounts	Liczniki wierszy dla poszczególnych etapów.
progress_percentage	Int	Przybliżony procent ukończenia (0–100).
failure_reason	BulkImportFailureReason	Przyczyna niepowodzenia w formacie czytelnym dla systemu.
failure_message	String	Szczegóły niepowodzenia w formacie czytelnym dla użytkownika. Wartość null dla INTERNAL_ERROR.
fully_imported	Boolean	Wartość true tylko wtedy, gdy zadanie ma stan COMPLETED i counts.failed = 0.
report_created	Boolean	Informacja, czy istnieje raport do pobrania.
report_url	String	Adres raportu z ograniczonym czasem dostępu (wygasa po 10 minutach).

---

JobStatus

Unia zwracana przez fetch_job_status. Obecnie zbiorcze importy CSV zwracają typ ItemsJobStatus. Unia jest zgodna z przyszłymi wersjami - w kolejnych wersjach mogą zostać dodane inne rodzaje zadań.

union JobStatus = ItemsJobStatus

---

OnMatchInput

Obiekt wejściowy akceptowany wyłącznie przez ingest_items. Nie jest obsługiwany przez backfill_items.

OnMatchInput dotyczy zwykłych importów elementów. W przypadku importu hierarchii MLS pomiń on_match. Importy MLS zawsze tworzą nowe elementy hierarchii i nie dopasowują, nie pomijają ani nie aktualizują elementów.

Dopasowanie jest sprawdzane w obrębie całej tablicy. Argument group_id funkcji ingest_items określa, gdzie zostaną dodane nowe elementy. Nie ogranicza zakresu dopasowywania podczas aktualizacji ani pomijania.

Pole	Typ	Opis
behaviour	OnMatchBehaviour!	Strategia dopasowania: UPSERT aktualizuje dopasowany element, a SKIP pomija wiersz.
match_column_id	String!	Identyfikator kolumny używanej do wykrywania dopasowań.

Informacje o obsługiwanych typach kolumn do dopasowywania znajdziesz w dokumentacji API Ingest items.

OnMatchBehaviour

Enum używany w OnMatchInput.behaviour.

Wartość enuma	Opis
SKIP	Pomija import wiersza, jeśli istnieje dopasowany element.
UPSERT	Aktualizuje istniejący dopasowany element. Jeśli go nie ma, tworzy nowy element.

---

UploadJobInit

Obiekt odpowiedzi zwracany przez backfill_items i ingest_items.

Pole	Typ	Opis
job_id	ID	Identyfikator używany przez fetch_job_status.
upload_url	String	Wstępnie podpisany adres URL do przesłania pliku CSV metodą PUT. Wygasa po 10 minutach. Podczas przesyłania pliku pod ten adres nie wysyłaj nagłówka żądania x-amz-checksum-crc32.