> 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/de/bulk-operation-api/bulk-operation-overview.md). # Übersicht über Massenoperationen ## Massen-Kampagnen Die APIs für Massenaktionen wurden entwickelt, um Benutzern wie AdOps, Managed Services und Lieferanten zu helfen, umfangreiche Aktualisierungs- und Erstellungsoperationen für **campaign**, \*\*wallets \*\*und \*\*teams \*\*in einem einzigen API-Aufruf durchzuführen. Dieser asynchrone API-Ansatz optimiert Arbeitsabläufe, reduziert den manuellen Aufwand und erhöht die operative Effizienz. Diese APIs sind besonders wertvoll für Szenarien mit hohem Volumen wie Onboarding, saisonale Launches oder große Kampagnenanpassungen, bei denen einzelne API-Aufrufe zeitaufwendig und fehleranfällig wären. ### Hauptvorteile * Effizienz: Reduziert die Anzahl der API-Aufrufe und eliminiert unnötige manuelle Schritte, indem mehrere Operationen in einer einzigen Anfrage ermöglicht werden. * Performance: Massen-APIs minimieren den HTTP-Roundtrip-Overhead. Anstatt viele einzelne Anfragen zu senden (z. B. 100 separate Aufrufe), reduziert eine einzige Massenanfrage die Netzwerkauslastung und verringert die Wahrscheinlichkeit, an Ratenbegrenzungen (Rate Limits) zu stoßen. * Idempotenz: Stellt sicher, dass jede Operation in der Massenanfrage idempotent ist, was unbeabsichtigte Nebenwirkungen bei Wiederholungsversuchen (wie sie beispielsweise durch UI-Aktionen ausgelöst werden) verhindert. * Granulares Sicherheits- und Autorisierungsmodell: Wendet die korrekten Zugriffskontrollen für jede Operation und jeden Entitätstyp innerhalb der Massen-Nutzlast (Bulk Payload) an und gewährleistet so die sichere Handhabung aller Aktionen. * Auditierung und Protokollierung: Behält ordnungsgemäße Protokollierungs- und Audit-Trails für alle Operationen innerhalb einer Massenanfrage bei und stellt so die Rückverfolgbarkeit sicher. * Vorschaufunktion: Einige Implementierungen unterstützen die Vorschau von Änderungen, bevor diese angewendet werden, was dazu beiträgt, Fehler frühzeitig zu erkennen. * Transaktionale Integrität: Eine Massen-API ermöglicht es Clients, eine Gruppe von Aktionen in einem einzigen API-Aufruf zu bündeln, was Folgendes sicherstellen kann: * Jede Entität in der Massenanfrage wird unabhängig validiert. * Granulare Fehlermeldungen werden zurückgegeben, um zu identifizieren, welche Entitäten fehlgeschlagen sind und warum. * Die gesamte Operation wird nicht blockiert, wenn eine Entität fehlschlägt. ### So verwenden Sie Massen-Kampagnen-APIs #### 1. Senden Sie eine Massenanfrage Sie senden eine Anfrage, um mehrere Kampagnen gleichzeitig zu erstellen, zu bearbeiten oder zu genehmigen. * Zum Erstellen: `/v3/campaigns/bulk/create` * Zum Bearbeiten: `/v3/campaigns/bulk/update` * Für Genehmigungen: `/v3/campaigns/bulk/approve` Sobald Sie die Anfrage senden, gibt Ihnen das System eine Bulk-ID und einen Status wie `submitted`. Die eigentliche Verarbeitung erfolgt im Hintergrund. **Beispiel (Kampagnen in Masse aktualisieren):** ```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" } ] } ``` Antwort: ```json { "bulkId": "c40f4f98-9b6b-11ee-b9d1-0242ac120002", "status": "BULK_OPERATION_SUBMITTED", "message": "Bulk campaign update request received and is being processed." } ``` #### 2. Überprüfen Sie den Status Verwenden Sie die Bulk-ID, um den Fortschritt zu überprüfen unter: `/v3/campaigns/bulk/status/{bulkId}` Sie werden sehen: * Welche Kampagnen erfolgreich waren oder fehlgeschlagen sind, mit Details für jede einzelne. * Fehlermeldungen (falls vorhanden). **Beispiel:** ```http GET /v3/campaigns/bulk/status/c40f4f98-9b6b-11ee-b9d1-0242ac120002 ``` {% hint style="info" %} Hinweise: * Die APIs sind asynchron: Sie reichen einen Auftrag ein und fragen die Ergebnisse ab (Polling). * Jede Entität in der Massenanfrage wird unabhängig validiert; Fehler werden pro Element gemeldet. * Massen-APIs sind für Kampagnen, Wallets und Teams verfügbar, mit ähnlichen Mustern für jede Ressource. {% endhint %} ### Zugriffsmatrix für Massenoperationen | Operation | Method | Wer kann erstellen | Wer kann den Status einsehen | | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------- | ---------------------------------------------------------- | | Campaigns | | | | | [Kampagnen in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Kampagnen in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Genehmigungsstatus der Kampagne aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | POST | Admin, Primary Retailer | Admin, Primary Retailer | | [Status der Sammeloperation abrufen](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkcampaignstatus-1.md) | GET | — | Admin, Primary Retailer, Creator (einschließlich Supplier) | | Wallet | | | | | [Geldbörsen in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Geldbörsen in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Status der Geldbörsen-Sammeloperation abrufen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | GET | — | Admin, Primary Retailer, Creator (einschließlich Supplier) | | Team | | | | | [Teams in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | POST | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Teams in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | PATCH | Admin, Primary Retailer, Supplier, General User | Admin, Primary Retailer, Creator (einschließlich Supplier) | | [Status der Team-Sammeloperation abrufen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | GET | — | Admin, Primary Retailer, Creator (einschließlich Supplier) | {% hint style="info" %} Team in Masse erstellen und aktualisieren: Wenn ein Lieferant versucht, Datensätze in Masse zu aktualisieren, erlaubt die API maximal 50 Datensätze pro Anfrage. Wenn die Anfrage mehr als 50 Datensätze enthält, gibt die API eine Fehlermeldung zurück, die darauf hinweist, dass das Limit überschritten wurde. {% 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/de/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.