> ## Documentation Index > Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Protokoly aktivit > Protokoly aktivit zaznamenávají každou změnu řízenou přes API v TWICE Commerce: co bylo změněno, kterým uživatelem, API klíčem nebo systémem a kdy. ![Globální protokol aktivit v administraci](https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/activity-log-global.webp?fit=max\&auto=format\&n=Ab7tx7ih94KQsi0k\&q=85\&s=205e0a916c6a46dea4ed23d0bec033f8) Protokol aktivit ## Definice **Protokol aktivit** je neměnný záznam každého autentizovaného API požadavku, který se dotkl vašeho účtu. Každý řádek odpovídá jednomu požadavku: jeho aktérovi, endpointu, na který byl proveden, zdroji, který ovlivnil, a odpovědi, která přišla zpět. Protože každá akce v administraci nakonec volá stejné API, jaké používají vaše integrace, Protokol aktivit zachycuje lidskou práci, volání API klíčem i systémové úlohy v jednom proudu. > [!NOTE] > > **Auditní protokoly** jsou dostupné v plánech **Standard** a **Enterprise**. Viz [plány](https://www.twicecommerce.com/docs/cs/twice-commerce-overview) (sekce Ceny). ## Kde se Protokoly aktivit zobrazují | Místo | Co zobrazuje | | :- | :- | | **Protokol aktivit na úrovni účtu** | Každý požadavek napříč celým účtem, dostupný z horní navigace | | **Skladová položka → karta Protokol aktivit** | Požadavky, jejichž `affectedRecords` zahrnují danou skladovou položku | | **SKU → karta Protokol aktivit** | Požadavky omezené na dané SKU | | **Inzerát → karta Protokol aktivit** | Požadavky vůči danému inzerátu (položce katalogu) | | **Zákazník → karta Protokol aktivit** | Požadavky vůči danému zákazníkovi | | **Objednávka → karta Protokol aktivit** | Požadavky vůči dané objednávce | | **Uživatel → karta Protokol aktivit** | Každý požadavek, který daný uživatel provedl kdekoli v účtu | Pět karet na úrovni entity používá stejnou komponentu tabulky jako zobrazení na úrovni účtu, předfiltrovanou na ID entity. Karta **Uživatel** používá stejnou tabulku s opačným rozsahem: filtruje podle aktéra, ne podle ovlivněného záznamu. > [!NOTE] > > **Proč protokol ve tvaru API?** Každá akce v administraci je zároveň voláním API. Logování na hranici požadavku zachytí cokoli, co mění stav, klávesnici, API integraci, naplánovanou úlohu, na jednom místě, bez mezer k překlenutí. ### Karta pro jednotlivého uživatele Otevřete ji z **Nastavení → Uživatelé a role**, vyberte uživatele, poté **Protokol aktivit**. Odpovídá na otázku „co tento člověk udělal“, zatímco karty na úrovni entity odpovídají na otázku „co se stalo s tímto záznamem“. ![Protokol aktivit jednotlivého uživatele se sloupci Časové razítko, Akce, Typ zdroje, ID záznamu, Endpoint a Status, bez sloupce Aktér](https://mintcdn.com/twicecommerce/5OTuuPIJYJGO1PsM/images/activity-log-user-tab.webp?fit=max\&auto=format\&n=5OTuuPIJYJGO1PsM\&q=85\&s=b341e53f2cb159881c0553c1a29ad923) Nastavení > Uživatelé a role > \[uživatel] > Protokol aktivit Zde se dvě věci chovají jinak než na kterémkoli jiném místě: * Sloupec Aktér je skrytý a filtr na aktéra nemůže rozsah rozšířit. Tabulka je pevně nastavená na uživatele, na jehož stránce se nacházíte, takže filtr zadaný do panelu nástrojů se na aktéra neaplikuje. Porovnávejte aktéry místo toho v Protokolu aktivit na úrovni účtu. * **Karta se zobrazuje jen u uživatelů, kteří mají e-mailovou adresu.** Položky se přiřazují podle e-mailu aktéra, takže členství bez zaznamenaného e-mailu nemá s čím se párovat. > [!NOTE] > > Karta je podmíněna oprávněním `account_settings:general:view`, stejným jako Protokol aktivit na úrovni účtu. Přístup na stránku Uživatelé a role vyžaduje `account_settings:users_and_roles:view`, což první oprávnění nezahrnuje: vlastní role s druhým oprávněním, ale bez prvního, otevře uživatele a nevidí kartu Protokol aktivit. > > Karta nepřidává žádné vlastní omezení a její historie sahá stejně daleko jako všude jinde. ## Co se zaznamenává Položka protokolu se zapíše pro každý autentizovaný požadavek, který dorazí na server. Každá položka zaznamenává jak příchozí požadavek, tak odpověď, která přišla zpět. | Sloupec | Zdroj | Popis | | :- | :- | :- | | **Časové razítko** | Server | Přesný čas přijetí požadavku | | **Akce** | HTTP metoda | `GET` -> Zobrazení, `POST` -> Vytvoření, `PUT` / `PATCH` -> Správa, `DELETE` -> Smazání | | **Typ zdroje** | Metadata trasy | Druh zdroje, kterého se požadavek dotýká (Article, Order, Customer atd.) | | **ID záznamu** | Požadavek / odpověď | ID ovlivněného záznamu (odkazuje na jeho detailní stránku, pokud existuje) | | **Aktér** | Autentizační údaj | Uživatel (e-mail), API klíč (popisek) nebo systém (název), který požadavek autentizoval | | **Endpoint** | URL požadavku | API cesta, která byla volána, bez query řetězce | | **Status** | Odpověď | HTTP status kód, barevně odlišený: úspěch vs. chyba | ### Typy aktérů V protokolu se objevují tři typy aktérů: | Aktér | Zobrazuje se jako | Poznámky | | :- | :- | :- | | Uživatel | `jordan@yourstore.com` | Autentizován přes JWT uživatele: lidská akce přes administraci | | API klíč | `API: Mobile app` | Autentizován přes [API klíč](https://www.twicecommerce.com/docs/cs/concepts/integrations/overview.md) (sekce API klíče): popisek je ten, který byl nastaven při vytvoření klíče | | Systém | `System: scheduler:daily-pricing-update` | Interní úloha jednající jménem tenantu | | Nesledováno | `Untracked` | Požadavek dorazil na server bez rozpoznaného přihlašovacího údaje: prošetřete, neignorujte | ### Rozpoznané typy zdrojů Sloupec Typ zdroje zobrazuje pro každý zdroj srozumitelný popisek. Aktuální sada zahrnuje: Article (Skladová položka), Article ledger, Audit log, Auth, Catalog, Change history, Checkout link, Collection, Customer, Event, File, Inventory report, Order, Payment, Payment account, Pricing table, Report, Saved table view, Search, Service location, SKU, Storefront customization, Tag, Tax, Taxonomy, Tenant, Unavailability, Upload URL, User, Variant. Když požadavek ovlivní typ zdroje s detailní stránkou (Article, Catalog, Collection, Customer, Order, SKU), sloupec ID záznamu se vykreslí jako odkaz. ## Filtry a vyhledávání Tabulku lze filtrovat na straně serveru podle: | Pole | Podporované operátory | | :- | :- | | Časové razítko | `is`, `after`, `on or after`, `before`, `on or before` | | Akce | `is`, `is any of` | | Typ zdroje | `equals`, `is any of` | | Aktér | `equals`, `is any of` (odpovídá e-mailu uživatele) | | Endpoint | `contains` (shoda podřetězce) | Filtrování podle ID záznamu není přímý filtr sloupce: karty Protokolu aktivit na úrovni entity to řeší předaplikováním filtru na ovlivněný záznam. > [!NOTE] > > Operátory filtrů, které se zobrazují v UI, odpovídají tomu, co dokáže efektivně zodpovědět backend auditních protokolů: další operátory jsou záměrně skryté, ne tiše ignorované. ## Neměnnost Jakmile je položka zapsána, nelze ji z administrace upravit ani smazat. Protokol aktivit je navržen jako append-only, a právě to z něj dělá nástroj použitelný pro zpětný audit a řešení incidentů. ## Uchovávání Položky Protokolu aktivit jsou uloženy v BigQuery a zpřístupněny přes API. Jak daleko do minulosti protokol sahá, závisí na vašem plánu: | Plán | Uchovávání | | :- | :- | | Standard | 3 měsíce | | Enterprise | 36 měsíců | Pokud vaše smlouva stanoví jiné podmínky, platí smlouva. Pro dlouhodobou archivaci exportujte protokol do CSV z tabulky (export respektuje aktuální sadu filtrů) a soubor uchovejte ve vlastním úložišti. Více informací: [Ceník TWICE](https://www.twicecommerce.com/pricing) ## Omezení počtu požadavků Čtení Protokolu aktivit vyvolá jeden dotaz do BigQuery na stránku. Endpoint je omezen na počet požadavků podle IP, podle tenantu i globálně, aby byly náklady a hluční klienti pod kontrolou. V praxi to znamená: * \~1 požadavek za sekundu trvale na IP, s malým nárazem * \~2 požadavky za sekundu trvale na tenant * Překročení limitu zablokuje volajícího na 5 minut V UI na tom obvykle nezáleží, ale je dobré to vědět, pokud proti endpointu auditních protokolů skriptujete. ## Přístup přes API Stejná data, která zobrazuje UI, jsou dostupná přes API. Stránkování je založené na kurzoru. Kombinujte `resourceTypes`, `affectedRecords`, `methods`, `userEmails`, `urls` a `statusCodes` k omezení dotazu: operátory se mapují 1:1 na filtry UI popsané výše. ## Protokol aktivit vs. Události Protokol aktivit a [Události](https://www.twicecommerce.com/docs/cs/concepts/inventory/events.md) stojí vedle sebe a snadno se pletou: | | Protokol aktivit | Události | | :- | :- | :- | | Co | API požadavky na účet | Milníky objednávky (rezervace, vyzvednutí, vrácení, poznámky) vázané na zásoby | | Kdy | Vždy historicky: zaznamenává, co se stalo | Může být v minulosti nebo naplánováno do budoucnosti | | Zdroj | Protokol požadavků na straně serveru | Životní cyklus zásob a objednávek | | Měnitelné? | Ne | Některé atributy editovatelné, dokud událost nenastane | | Použití | Audit, ladění, přiřazení | Provozní plánování a časové osy | Protokol aktivit použijte, když potřebujete odpovědět na otázku „kdo a kdy tohle změnil“. Události použijte, když potřebujete naplánovat nebo zobrazit „co se s touto skladovou položkou v čase děje“. ## Související články > **[Události](https://www.twicecommerce.com/docs/cs/concepts/inventory/events.md)** > > Časová osa rezervací, vyzvednutí, vrácení a poznámek na straně zásob > **[Integrace](https://www.twicecommerce.com/docs/cs/concepts/integrations/overview.md)** > > API klíče a odběry webhooků: oba se v Protokolu aktivit objevují jako aktéři > **[Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md)** > > Odesílání událostí z TWICE do vašich systémů > **[Uživatelé a role](https://www.twicecommerce.com/docs/cs/settings/users-roles.md)** > > Kdo vidí Protokol aktivit a podle jakých rozsahů může filtrovat This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.