> 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/hu/bulk-operation-api/bulk-operation-overview.md). # Tömeges műveletek áttekintése ## Tömeges kampányok A tömeges műveletekhez használt API-kat úgy tervezték, hogy segítsék az olyan felhasználókat, mint az AdOps, a Managed Services és a beszállítók, hogy egyetlen API-hívásban hajtsanak végre nagy léptékű frissítési és létrehozási műveleteket a **kampányokon**, \*\*pénztárcákon \*\*és **csapatokon**. Ez az aszinkron API megközelítés egyszerűsíti a munkafolyamatokat, csökkenti a manuális erőfeszítést és növeli az működési hatékonyságot. Ezek az API-k különösen értékesek a nagy volumenű forgatókönyveknél, mint például az onboarding, a szezonális indulások vagy a jelentősebb kampánymódosítások, ahol az egyedi API-hívások indítása időigényes és hibaveszélyes lenne. ### Fő előnyök * Hatékonyság: Csökkenti az API-hívások számát, és megszünteti a felesleges manuális lépéseket azáltal, hogy több műveletet tesz lehetővé egyetlen kérésben. * Teljesítmény: A tömeges API-k minimalizálják a HTTP oda-vissza út (round-trip) időigényét. A sok egyedi kérés küldése helyett (például 100 különálló hívás) egyetlen tömeges kérés csökkenti a hálózati terhelést és a kérési korlátok (rate limits) elérésének esélyét. * Idempotencia: Biztosítja, hogy a tömeges kérés minden művelete idempotens legyen, megakadályozva a nem kívánt mellékhatásokat az újpróbálkozások során (például a UI-műveletek által kiváltottakat). * Részletes biztonsági és jogosultsági modell: Alkalmazza a megfelelő hozzáférés-vezérlést minden egyes műveletre és entitástípusra a tömeges törzsön belül, biztosítva az összes művelet biztonságos kezelését. * Auditálás és naplózás: Megfelelő naplózást és auditálási nyomvonalat tart fenn a tömeges kérésen belüli összes művelethez, biztosítva a nyomon követhetőséget. * Előnézeti lehetőség: Egyes megvalósítások támogatják a módosítások előnézetét azok alkalmazása előtt, segítve a hibák korai kiszűrését. * Tranzakciós integritás: A tömeges API lehetővé teszi az ügyfelek számára, hogy a műveletek egy csoportját egyetlen API-hívásba kötegeljék, ami biztosíthatja, hogy: * A tömeges kérésben szereplő minden entitás függetlenül kerül érvényesítésre. * Részletes hibaüzenetek érkeznek vissza annak azonosítására, hogy mely entitások hibásodtak meg és miért. * A teljes művelet nem blokkolódik, ha egy entitás meghiúsul. ### A tömeges kampány API-k használata #### 1. Tömeges kérés elküldése Kérést küld több kampány egyidejű létrehozására, szerkesztésére vagy jóváhagyására. * Létrehozáshoz: `/v3/campaigns/bulk/create` * Szerkesztéshez: `/v3/campaigns/bulk/update` * Jóváhagyásokhoz: `/v3/campaigns/bulk/approve` A kérés elküldése után a rendszer ad egy tömeges azonosítót (bulk ID) és egy olyan állapotot, mint a `submitted`. A tényleges feldolgozás a háttérben történik. **Példa (Kampányok tömeges frissítése):** ```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" } ] } ``` Válasz: ```json { "bulkId": "c40f4f98-9b6b-11ee-b9d1-0242ac120002", "status": "BULK_OPERATION_SUBMITTED", "message": "Bulk campaign update request received and is being processed." } ``` #### 2. Állapot ellenőrzése Használja a tömeges azonosítót (bulk ID) a folyamat ellenőrzéséhez itt: `/v3/campaigns/bulk/status/{bulkId}` A következőket fogja látni: * Mely kampányok sikerültek vagy buktak el, az egyes kampányok részleteivel. * Hibaüzenetek (ha vannak). **Példa:** ```http GET /v3/campaigns/bulk/status/c40f4f98-9b6b-11ee-b9d1-0242ac120002 ``` {% hint style="info" %} Megjegyzések: * Az API-k aszinkronok: elküld egy feladatot, és lekérdezi az eredményeket. * A tömeges kérésben szereplő minden entitás függetlenül kerül érvényesítésre; a hibák tételenként kerülnek jelentésre. * A tömeges API-k elérhetők kampányokhoz, pénztárcákhoz és csapatokhoz, mindegyik erőforrásnál hasonló mintákkal. {% endhint %} ### Tömeges műveletek hozzáférési mátrixa | Művelet | Metódus | Ki hozhat létre | Ki tekintheti meg az állapotot | | --------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------- | ------------------------------------------------------------------- | | Kampányok | | | | | [Create campaigns in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Update campaigns in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Update campaign approval state](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | POST | Admin, Primary Retailer | Admin, Primary Retailer | | [Retrieve bulk operation status](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkcampaignstatus-1.md) | GET | — | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | Pénztárca | | | | | [Create wallets in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Update wallets in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Retrieve bulk wallet operation status](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | GET | — | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | Csapat | | | | | [Create teams in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Update teams in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | | [Retrieve bulk team operation status](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | GET | — | Admin, Primary Retailer, Creator (beleértve a következőt: Supplier) | {% hint style="info" %} Csapat tömeges létrehozása és frissítése: Amikor egy beszállító tömegesen próbálja frissíteni a rekordokat, az API kérésenként legfeljebb 50 rekordot engedélyez. Ha a kérés több mint 50 rekordot tartalmaz, az API hibaüzenetet ad vissza, ami jelzi a korlát túllépését. {% 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/hu/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.