> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/sk/bulk-operation-api/bulk-operation-overview.md). # Prehľad hromadných operácií ## Hromadné kampane Rozhrania API pre hromadné akcie (Bulk Action API) sú navrhnuté tak, aby pomohli používateľom, ako sú AdOps, spravované služby a dodávatelia, vykonávať rozsiahle operácie aktualizácie a vytvárania pre **kampane**, **penaženky** a **tímy** v jedinom volaní API. Tento asynchrónny prístup k API zefektívňuje pracovné postupy, znižuje manuálne úsilie a zvyšuje prevádzkovú efektivitu. Tieto API sú obzvlášť cenné pre scenáre s vysokým objemom, ako sú onboarding, sezónne spustenia alebo hlavné úpravy kampaní, kde by vykonávanie jednotlivých volaní API bolo časovo náročné a náchylné na chyby. ### Kľúčové výhody * Efektivita: Znižuje počet volaní API a odstraňuje zbytočné manuálne kroky tým, že umožňuje viacero operácií v jednej požiadavke. * Výkon: Hromadné API minimalizujú réžiu obojsmernej komunikácie HTTP. Namiesto odosielania mnohých jednotlivých požiadaviek (napríklad 100 samostatných volaní) jediná hromadná požiadavka znižuje zaťaženie siete a znižuje pravdepodobnosť dosiahnutia limitov požiadaviek (rate limits). * Idempotencia: Zabezpečuje, že každá operácia v hromadnej požiadavke je idempotentná, čím zabraňuje neúmyselným vedľajším účinkom počas opakovaných pokusov (napríklad tých, ktoré sú vyvolané akciami v používateľskom rozhraní). * Granulárny bezpečnostný a autorizačný model: Uplatňuje správne riadenie prístupu pre každý typ operácie a entity v rámci hromadného dátového obsahu (payloadu), čím zabezpečuje bezpečné spracovanie všetkých akcií. * Audit a zaznamenávanie: Udržiava riadne záznamy a audítorské stopy pre všetky operácie v rámci hromadnej požiadavky, čím zabezpečuje sledovateľnosť. * Možnosť náhľadu: Niektoré implementácie podporujú náhľad zmien pred ich aplikovaním, čo pomáha včas odhaliť chyby. * Transakčná integrita: Hromadné API umožňuje klientom zoskupiť skupinu akcií do jediného volania API, čo môže zabezpečiť, že: * Každá entita v hromadnej požiadavke je nezávisle overená. * Sú vrátené podrobné chybové hlásenia na identifikáciu toho, ktoré entity zlyhali a prečo. * Celá operácia nie je zablokovaná, ak jedna entita zlyhá. ### Ako používať API pre hromadné kampane #### 1. Odoslanie hromadnej požiadavky Odošlete požiadavku na vytvorenie, úpravu alebo schválenie viacerých kampaní naraz. * Pre vytváranie: `/v3/campaigns/bulk/create` * Pre úpravu: `/v3/campaigns/bulk/update` * Pre schvaľovanie: `/v3/campaigns/bulk/approve` Po odoslaní požiadavky vám systém pridelí hromadné ID (bulk ID) a stav ako `submitted`. Samotné spracovanie prebieha na pozadí. **Príklad (Hromadná aktualizácia kampaní):** ```http PATCH /v3/campaigns/bulk/update { "campaigns": [ { "campaign": { "id": "campaign_123", "name": "Updated Summer Sale Campaign", "startTime": "2025-08-01T00:00:00Z", "endTime": "2025-08-31T23:59:59Z", "campaignState": "CAMPAIGN_STATE_ACTIVE", "strategy": { "auction": { "maxBid": "6.5" } } }, "mask": "name,startTime,endTime,campaignState,strategy.auction.maxBid", "campaignType": "CAMPAIGN_TYPE_BANNER" }, { "campaign": { "id": "campaign_456", "name": "Holiday Promotion", "campaignState": "CAMPAIGN_STATE_PAUSED", "strategy": { "auction": { "maxBid": "5.0" } } }, "mask": "name,campaignState,strategy.auction.maxBid", "campaignType": "CAMPAIGN_TYPE_BANNER" } ] } ``` Odpoveď: ```json { "bulkId": "c40f4f98-9b6b-11ee-b9d1-0242ac120002", "status": "BULK_OPERATION_SUBMITTED", "message": "Bulk campaign update request received and is being processed." } ``` #### 2. Kontrola stavu Použite hromadné ID na kontrolu priebehu na: `/v3/campaigns/bulk/status/{bulkId}` Uvidíte: * Ktoré kampane uspeli alebo zlyhali, s podrobnosťami pre každú z nich. * Chybové hlásenia (ak nejaké sú). **Príklad:** ```http GET /v3/campaigns/bulk/status/c40f4f98-9b6b-11ee-b9d1-0242ac120002 ``` {% hint style="info" %} Poznámky: * API sú asynchrónne: odošlete úlohu a zisťujete výsledky (polling). * Každá entita v hromadnej požiadavke sa overuje nezávisle; chyby sa hlásia pre každú položku osobitne. * Hromadné API sú k dispozícii pre kampane, peňaženky a tímy s podobnými vzormi pre každý zdroj. {% endhint %} ### Matica prístupu k hromadným operáciám | Operácia | Metóda | Kto môže vytvoriť | Kto môže zobraziť stav | | --------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------- | --------------------------------------------------- | | Kampane | | | | | [Create campaigns in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Update campaigns in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Update campaign approval state](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | POST | Admin, Primary Retailer | Admin, Primary Retailer | | [Retrieve bulk operation status](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkcampaignstatus-1.md) | GET | — | Admin, Primary Retailer, Creator (vrátane Supplier) | | Peňaženka | | | | | [Create wallets in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Update wallets in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Retrieve bulk wallet operation status](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | GET | — | Admin, Primary Retailer, Creator (vrátane Supplier) | | Tím | | | | | [Create teams in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Update teams in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (vrátane Supplier) | | [Retrieve bulk team operation status](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | GET | — | Admin, Primary Retailer, Creator (vrátane Supplier) | {% hint style="info" %} Hromadné vytvorenie a aktualizácia tímu: Keď sa dodávateľ pokúsi aktualizovať záznamy hromadne, API povoľuje maximálne 50 záznamov na požiadavku. Ak požiadavka obsahuje viac ako 50 záznamov, API vráti chybové hlásenie indikujúce, že limit bol prekročený. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/partner/sk/bulk-operation-api/bulk-operation-overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.