Shopify bulk operations kräver nu uttrycklig åtkomst innan berörda appar kan använda dem. Om din butik är beroende av schemalagda katalogexporter eller stora produktuppdateringar bör du kontrollera detta före nästa körning. I sitt meddelande den 6 november presenterar Shopify separata åtkomstkontroller för bulk queries och bulk mutations. Här går vi igenom hur du identifierar berörda integrationer, ställer rätt frågor till utvecklaren och återupptar avbrutna körningar utan att skapa nya problem.
Vad har ändrats för Shopify bulk operations?
I Shopifys meddelande om bulkoperationer i partnerappar framgår att appar måste ha åtkomst aktiverad i Partner Dashboard innan de kan starta bulk queries eller bulk mutations via GraphQL Admin API.
Åtkomsten styrs separat. En app som ska exportera data behöver åtkomst till bulk queries. En app som ska göra massuppdateringar behöver åtkomst till bulk mutations. Att aktivera den ena innebär inte att båda aktiveras.
- Bulk queries: åtkomst krävs för att köra bulkOperationRunQuery.
- Bulk mutations: åtkomst krävs för att köra bulkOperationRunMutation.
- Saknad åtkomst: en begäran om att starta en bulkoperation returnerar ett fel om nekad åtkomst.
- API-versioner: kravet gäller alla versioner av GraphQL Admin API.
Meddelandet omfattar publika appar och anpassade appar som har byggts av partner och använder bulkoperationer. Be appleverantören bekräfta om just din app berörs, i stället för att utgå från att alla integrationer som beskrivs som ”anpassade” omfattas av samma krav.
Att byta till en äldre API-version löser inte problemet. Meddelandet omfattar uttryckligen alla versioner. Börja därför med att kontrollera appens åtkomstinställningar.
Därför bör du prioritera detta bland nyheterna i Fall ’26
I Shopifys utvecklaröversikt för Fall ’26 beskrivs hur katalog, varukorg och kassa öppnas för agenter och appar, tillsammans med verktyg för att bygga och säkra integrationer. Den utvecklingen gör appbehörigheter till en konkret driftfråga för handlare, även när inställningarna finns utanför butikens Shopify-admin.
Vår bedömning: den mest brådskande åtgärden efter en uppdatering är ofta den som syns minst. En ny köpupplevelse kan vänta medan du utvärderar den. Ett behörighetskrav som påverkar nattens export kan vara mer akut.
Den här uppdateringen bör prioriteras eftersom den avgör om ett berört jobb över huvud taget kan starta. Du behöver inte designa om butiken. Däremot behöver den som ansvarar för integrationen kontrollera en specifik inställning och visa att hela arbetsflödet fortfarande fungerar.
Vilka arbetsflöden i butiken bör du granska?
En bulkoperation är ett API-arbetsflöde som hanterar stora datamängder asynkront. I praktiken kan en app skicka in ett jobb och hämta resultatet senare, i stället för att hålla en vanlig förfrågan öppen under hela bearbetningen.
Det betyder inte att varje stor import eller export använder Shopifys API-anrop för bulkoperationer. Ett verktyg kan använda vanliga API-anrop eller någon annan metod som stöds. Storleken på kalkylbladet säger inte vilken metod som används.
Börja med integrationer som överför stora mängder butiksdata. Fråga den som ansvarar för ert produktinformationssystem hur katalogändringar publiceras. Fråga den som sköter rapporteringsflödet hur data hämtas. Ta även med migreringsverktyg och interna skript som sällan körs: ett verktyg som inte används regelbundet kan dölja ett åtkomstproblem tills någon behöver det akut.
Dokumentera verksamhetsnyttan och den tekniskt ansvariga för varje arbetsflöde. Ange också vilken app som används, om den använder bulk queries eller bulk mutations och när nästa körning är planerad. En kort inventering är mer användbar än en allmän uppmaning till alla att ”kolla Shopify”.
Så kontrollerar du åtkomsten till Shopify bulk operations
Ge den appansvariga en tydlig fråga
De flesta handlare ska inte behöva felsöka GraphQL-anrop. Däremot behöver de ett tydligt svar från personen eller leverantören som ansvarar för dem.
Anropar vår integration bulkOperationRunQuery eller bulkOperationRunMutation? Bekräfta att rätt åtkomst är aktiverad för produktionsappen i Partner Dashboard. Kontrollera sedan att ett representativt jobb slutförs och att resultatet når rätt destination.
Den sista delen är viktig. Ett lyckat API-anrop är inte samma sak som att nästa system i kedjan har uppdaterats. En export kan starta korrekt samtidigt som processen som hämtar eller importerar resultatet misslyckas.
Kontakta leverantören om det gäller en publik app. För en partnerutvecklad anpassad app kontaktar du utvecklaren. Utgå inte från att butikspersonalen kan ändra en inställning i Partner Dashboard via butikens Shopify-admin.
Kontrollera läs- och ändringsbehörigheterna var för sig
En integration kan läsa katalogen utan problem men misslyckas när den försöker skriva ändringar. Shopify hanterar åtkomst till bulk queries och bulk mutations separat, så ett lyckat exporttest bevisar inte att en import fungerar.
Anpassa åtkomsten efter appens faktiska funktioner. Vi rekommenderar inte att aktivera bulk mutations för en app som bara används för rapportering enbart för att möjligheten finns. Behörigheter ska vara ett medvetet konfigurationsbeslut, inte något man slår på slentrianmässigt.
Bekräfta också att utvecklaren har kontrollerat produktionsappen. Resultat från en utvecklingsinstallation är användbara under testning, men säger inget säkert om appen som används i din livebutik.
Kontrollera att resultatet fungerar i verksamheten
För en query ska du bekräfta att operationen slutförs och att förväntade data når den plats där teamet använder dem. Jämför resultatet med vad exporten skulle omfatta. En tom fil ska inte räknas som ett lyckat resultat bara för att filen finns.
För en mutation bör du använda en kontrollerad ändring som passar arbetsflödet och går att återställa. Kontrollera de berörda posterna efteråt och granska eventuella rapporterade fel. Spara tillräckligt med underlag för att kunna skilja ett behörighetsfel från ett problem med inskickade data.
Kör inte om ett misslyckat jobb utan att kontrollera vad som hänt
Enligt Shopify returnerar en begäran om att starta en bulkoperation ett fel om nekad åtkomst när behörigheten saknas. Det visar att den aktuella operationen inte kunde starta. Däremot säger det inget om vad resten av integrationen gjorde före det anropet.
Ett synkroniseringsflöde kan ha förberett filer eller ändrat poster via andra anrop innan det försökte starta bulksteget. Ta reda på var flödet stannade innan du startar om hela körningen.
Vi rekommenderar följande ordning för återställning:
- Spara felinformationen. Behåll felsvaret, appens identitet och jobbets tidsstämpel så att utvecklaren kan identifiera steget som misslyckades.
- Stoppa upprepade misslyckade försök. Pausa det berörda schemat eller kön om nya försök fortsätter att ge samma åtkomstfel.
- Rätta till åtkomsten och testa. Låt den appansvariga aktivera rätt behörighet och verifiera en kontrollerad operation.
- Stäm av innan du kör om. Kontrollera vad som redan har slutförts och vilka källdata som gäller nu. Återuppta sedan bara det arbete som fortfarande behövs.
Var särskilt försiktig med köade uppdateringar. Om källdata har ändrats sedan felet inträffade kan en omkörning med gamla data skriva över ett senare beslut. Rätt åtgärd kan vara en ny export från källsystemet i stället för att försöka köra originalfilen igen.
Här blir även idempotens viktigt. Ett idempotent arbetsflöde kan upprepa samma avsedda ändring utan att skapa ytterligare oönskade effekter. Fråga utvecklaren hur integrationen förhindrar dubbelarbete vid återställning. Utgå inte från att ”försök igen” automatiskt betyder att det är säkert.
Behöver du en ny app eller en ombyggd integration?
Den första frågan bör normalt vara om den befintliga appen har rätt åtkomst. Meddelandet beskriver ett åtkomstkrav, inte ett generellt krav på att byta ut integrationer.
Vi skulle vara skeptiska till ett förslag om att bygga om ett fungerande dataflöde innan inställningarna har kontrollerats. Samtidigt bör en leverantör som säger ”vi har aktiverat det” kunna bekräfta att ditt arbetsflöde fungerar, inte bara att en inställning har ändrats.
Behåll det befintliga verktyget om den ansvariga kan förklara hur det använder bulkoperationer och visa att körningarna fungerar igen. Överväg en mer ingående granskning om ingen ansvarar för integrationen, om loggarna inte gör det möjligt att identifiera fel eller om misslyckade jobb försvinner utan någon varning.
Att ersätta bulkoperationer med vanliga anrop enbart för att undvika åtkomstkontrollen är inte vår grundrekommendation. Det förändrar hur integrationen körs och kan medföra andra problem med prestanda eller API-begränsningar. Lös behörighetsfrågan först. Bygg om först när det finns separata verksamhetsskäl för det.
Gör åtkomstkontrollen till en del av appöverlämningen
Den långsiktiga lärdomen handlar om ansvar. Handlare vet ofta vilken app som hanterar katalogdata, men inte vem som styr inställningarna på utvecklarsidan.
Lägg till en kort beskrivning av åtkomsten i integrationsdokumentationen. Ange ansvarig organisation, produktionsapp och vilka bulkbehörigheter som behövs. Ta även med kontaktvägen för eskalering och en beskrivning av testet som visar att arbetsflödet fungerar.
Se över dokumentationen när en app byter ansvarig eller får en ny funktion. En rapporteringsintegration som senare börjar skriva produktändringar behöver granskas på nytt, även om det ursprungliga exportflödet fortfarande fungerar som vanligt.
Prioritera just nu de berörda jobben utifrån konsekvenserna för verksamheten och tidpunkten för nästa körning. Säkra det flöde teamet behöver härnäst och gå sedan vidare med resten. Målet är att verifiera fortsatt drift, inte att skynda fram en ombyggnad.
Det viktigaste att ta med sig
- Shopify kräver separat åtkomst till bulk queries och bulk mutations i berörda partnerappar.
- Kravet gäller alla versioner av GraphQL Admin API. Det går inte att kringgå genom att byta till en äldre version.
- Be den appansvariga verifiera åtkomsten i produktion och kontrollera hela arbetsflödet.
- Innan du kör om misslyckade jobb ska du stämma av vad som redan är klart och kontrollera att köade data fortfarande är aktuella.
Källor
- Partnerappar måste aktivera bulkoperationer före användning
- Framtidens shopping: Fall '26 Edition ... – Shopify
Vill du ha hjälp med detta?
Vi på ZAGO är Shopify Premier Partner och arbetar dagligen med prestanda, konverteringsoptimering och butiksbyggen som lönar sig. Boka en kostnadsfri genomgång av din butik så visar vi vilka tre förbättringar vi skulle genomföra först.
Vanliga frågor
Varför ger Shopify bulk operations ett fel om nekad åtkomst?
Enligt Shopifys meddelande den 6 november måste berörda partnerappar ha åtkomst till bulkoperationer aktiverad i Partner Dashboard. Saknas åtkomsten returnerar en begäran om att starta en bulkoperation ett fel om nekad åtkomst. Be den appansvariga kontrollera rätt behörighet och granska det faktiska felmeddelandet.
Är behörigheterna för bulk queries och bulk mutations separata?
Ja. Åtkomst till bulk queries krävs för bulkOperationRunQuery, medan åtkomst till bulk mutations krävs för bulkOperationRunMutation. En lyckad export bevisar inte att appen har rätt åtkomst för massuppdateringar.
Går det att undvika åtkomstkravet för bulkoperationer med en äldre Shopify API-version?
Nej. Enligt Shopify gäller kravet alla versioner av GraphQL Admin API. Den appansvariga bör korrigera åtkomstinställningarna i stället för att byta till en äldre API-version.
Bör jag starta om en misslyckad bulkimport i Shopify direkt efter att åtkomsten har aktiverats?
Ta först reda på var arbetsflödet stannade och om andra steg hann slutföras. Kontrollera att köade data fortfarande är aktuella, testa sedan den korrigerade åtkomsten och återuppta bara det arbete som behövs.
