Pobieranie zasobów (Platform MCP)
Użyj tego narzędzia, aby pobrać metadane plików (zasobów) przesłanych do monday.com. Podaj jeden lub więcej identyfikatorów zasobów, a narzędzie zwróci informacje o każdym pliku: jego nazwę, rozszerzenie, rozmiar, publiczny adres URL z ograniczonym czasem ważności, który umożliwia pobranie lub wyświetlenie pliku, adres URL miniatury (w przypadku obrazów), datę przesłania oraz nazwę użytkownika, który przesłał plik.
Identyfikatory zasobów pojawiają się w odpowiedziach API, gdy pliki są dołączane do elementów, aktualizacji lub dokumentów. Możesz je też znaleźć, sprawdzając wartości kolumn elementów, które korzystają z kolumn plików, za pomocą get_full_board_data albo wywołując update_doc z blokiem image, który odwołuje się do asset_id.
Publiczny adres URL zwracany dla każdego zasobu jest ważny przez 1 godzinę. Nie zapisuj go ani nie udostępniaj do długotrwałego użytku - pobierz dane zasobu ponownie, aby otrzymać nowy adres URL.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| ids | array |
Tak | Tablica identyfikatorów zasobów do pobrania. Musi zawierać co najmniej jeden identyfikator. Identyfikatory zasobów są ciągami cyfr (np. ["12345678"]). |
Przykład
Pobierz metadane dwóch zasobów:
{
"ids": ["12345678", "87654321"]
}
Dla każdego prawidłowego identyfikatora zasobu narzędzie zwraca:
name- oryginalną nazwę pliku (np."screenshot.png")file_extension- typ pliku (np."png","pdf")file_size- rozmiar w bajtachpublic_url- adres URL z ograniczonym czasem ważności (ważny przez 1 godzinę), umożliwiający bezpośredni dostęp do plikuthumbnail_url- adres URL obrazu podglądu (w przypadku zasobów będących obrazami)created_at- znacznik czasu przesłaniauploaded_by- nazwa i identyfikator użytkownika, który przesłał plik
Jeśli identyfikator nie zostanie znaleziony, narzędzie zwróci komunikat informujący, że nie znaleziono zasobów o tym identyfikatorze. Sprawdź, czy identyfikator jest prawidłowy i czy należy do zasobu na Twoim koncie.
Odpowiednik programistyczny
Aby uzyskać ten sam wynik, użyj GraphQL API:
query {
assets(ids: [12345678, 87654321]) {
id
name
file_extension
file_size
public_url
created_at
uploaded_by {
id
name
}
}
}
Pełną dokumentację znajdziesz w sekcji Assets.