> 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/sv/bulk-operation-api/bulk-operation-overview.md). # Översikt över massåtgärder ## Masskampanjer API:erna för massåtgärder är utformade för att hjälpa användare som AdOps, Managed Services och leverantörer att utföra storskaliga uppdaterings- och skapandeåtgärder för **campaign**, \*\*wallets \*\*och \*\*teams \*\*i ett enda API-anrop. Detta asynkrona API-tillvägagångssätt effektiviserar arbetsflöden, minskar manuellt arbete och förbättrar den operativa effektiviteten. Dessa API:er är särskilt värdefulla för scenarier med höga volymer som onboarding, säsongslanseringar eller större kampanjjusteringar, där det skulle vara tidskrävande och felbenäget att göra enskilda API-anrop. ### Viktiga fördelar * Effektivitet: Minskar antalet API-anrop och tar bort onödiga manuella steg genom att tillåta flera åtgärder i en enda begäran. * Prestanda: Mass-API:er minimerar overhead för HTTP-tur-och-retur-resor. Istället för att skicka många enskilda begäranden (till exempel 100 separata anrop) minskar en enda massbegäran nätverksbelastningen och minskar risken för att nå hastighetsgränser (rate limits). * Idempotens: Säkerställer att varje åtgärd i massbegäran är idempotent, vilket förhindrar oavsiktliga sidoeffekter vid upprepade försök (t.ex. sådana som utlöses av användargränssnittsåtgärder). * Granulär säkerhets- och auktoriseringsmodell: Tillämpar rätt åtkomstkontroller för varje åtgärd och enhetstyp inom massnyttolasten, vilket säkerställer säker hantering av alla åtgärder. * Granskning och loggning: Upprätthåller korrekta loggnings- och granskningsspår för alla åtgärder inom en massbegäran, vilket säkerställer spårbarhet. * Möjlighet till förhandsgranskning: Vissa implementeringar stöder förhandsgranskning av ändringar innan de tillämpas, vilket hjälper till att upptäcka fel i ett tidigt skede. * Transaktionsintegritet: Ett mass-API gör det möjligt för klienter att samla en grupp åtgärder i ett enda API-anrop, vilket kan säkerställa att: * Varje enhet i massbegäran valideras oberoende. * Granulära felmeddelanden returneras för att identifiera vilka enheter som misslyckades och varför. * Hela åtgärden blockeras inte om en enhet misslyckas. ### Hur man använder mass-API:er för kampanjer #### 1. Skicka en massbegäran Du skickar en begäran om att skapa, redigera eller godkänna flera kampanjer samtidigt. * För att skapa: `/v3/campaigns/bulk/create` * För att redigera: `/v3/campaigns/bulk/update` * För godkännanden: `/v3/campaigns/bulk/approve` När du skickar begäran ger systemet dig ett mass-ID och en status som `submitted`. Den faktiska bearbetningen sker i bakgrunden. **Exempel (Uppdatera kampanjer i bulk):** ```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" } ] } ``` Svar: ```json { "bulkId": "c40f4f98-9b6b-11ee-b9d1-0242ac120002", "status": "BULK_OPERATION_SUBMITTED", "message": "Bulk campaign update request received and is being processed." } ``` #### 2. Kontrollera statusen Använd mass-ID:t för att kontrollera förloppet på: `/v3/campaigns/bulk/status/{bulkId}` Du kommer att se: * Vilka kampanjer som lyckades eller misslyckades, med detaljer för varje. * Felmeddelanden (om några). **Exempel:** ```http GET /v3/campaigns/bulk/status/c40f4f98-9b6b-11ee-b9d1-0242ac120002 ``` {% hint style="info" %} Anteckningar: * API:erna är asynkrona: du skickar in ett jobb och söker efter resultat (polling). * Varje enhet i massbegäran valideras oberoende; fel rapporteras per objekt. * Mass-API:er är tillgängliga för kampanjer, plånböcker och team, med liknande mönster för varje resurs. {% endhint %} ### Åtkomstmatris för massåtgärder | Åtgärd | Metod | Vem som kan skapa | Vem som kan visa status | | --------------------------------------------------------------------------------------------------------------------------------------- | ----- | ----------------------------------------------- | ----------------------------------------------------- | | Kampanjer | | | | | [Create campaigns in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Update campaigns in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Update campaign approval state](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | POST | Admin, Primary Retailer | Admin, Primary Retailer | | [Retrieve bulk operation status](/retail-media-interface/partner/sv/bulk-operation-api/bulkcampaignoperations/bulkcampaignstatus-1.md) | GET | — | Admin, Primary Retailer, Creator (inklusive Supplier) | | Wallet | | | | | [Create wallets in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Update wallets in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Retrieve bulk wallet operation status](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | GET | — | Admin, Primary Retailer, Creator (inklusive Supplier) | | Team | | | | | [Create teams in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Update teams in bulk](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (inklusive Supplier) | | [Retrieve bulk team operation status](/retail-media-interface/partner/sv/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | GET | — | Admin, Primary Retailer, Creator (inklusive Supplier) | {% hint style="info" %} Skapa och uppdatera team i bulk: När en leverantör försöker uppdatera poster i bulk tillåter API:et maximalt 50 poster per begäran. Om begäran innehåller mer än 50 poster returnerar API:et ett felmeddelande som indikerar att gränsen har överskridits. {% 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/sv/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.