Shopify-masseoperationer kræver nu, at adgangen er aktiveret særskilt, før berørte apps kan køre dem. Hvis din webshop er afhængig af en planlagt katalogeksport eller en større produktopdatering, bør du kontrollere adgangen inden næste kørsel. Shopifys meddelelse fra den 6. november indfører separate adgangsindstillinger for bulk queries og bulk mutations. Her gennemgår vi, hvordan du finder de berørte integrationer, stiller din udvikler de rigtige spørgsmål og genoptager afbrudte opgaver uden at skabe nye problemer.
Hvad er ændret for Shopify-masseoperationer?
Ifølge Shopifys meddelelse om masseoperationer i partnerapps skal apps have adgang aktiveret i Partner Dashboard, før de kan starte bulk queries eller bulk mutations via GraphQL Admin API.
Adgangsindstillingerne er adskilte. En app, der skal eksportere data, kræver adgang til bulk queries. En app, der skal udføre masseopdateringer, kræver adgang til bulk mutations. Aktivering af den ene giver ikke automatisk adgang til den anden.
- Bulk queries: Der kræves adgang for at køre bulkOperationRunQuery.
- Bulk mutations: Der kræves adgang for at køre bulkOperationRunMutation.
- Manglende adgang: En anmodning om at starte en masseoperation returnerer en fejl om nægtet adgang.
- API-versioner: Kravet gælder alle versioner af GraphQL Admin API.
Meddelelsen omfatter offentlige apps og specialudviklede apps bygget af partnere, som kører masseoperationer. Som webshopejer bør du bede din appleverandør bekræfte, om netop din app er omfattet, frem for at antage, at alle integrationer, der kaldes “specialudviklede”, har de samme krav.
Det hjælper ikke at skifte til en ældre API-version. Meddelelsen omfatter udtrykkeligt alle versioner. Løsningen begynder med appens adgangsindstillinger.
Derfor bør du prioritere ændringen blandt Fall ’26-nyhederne
Shopifys Fall ’26-oversigt for udviklere beskriver, hvordan platformen åbner sit katalog, sin indkøbskurv og sin checkout for agenter og apps sammen med værktøjer til at bygge og sikre integrationer. Den retning gør apprettigheder til et konkret driftsspørgsmål for webshops, også når indstillingerne ligger uden for deres Shopify-administration.
Vores vurdering: Den mest presserende opgave ved en platformopdatering er ofte den mindst synlige. En ny shoppingoplevelse kan vente, mens du vurderer den. Et adgangskrav, der påvirker nattens eksport, kan måske ikke.
Denne opdatering bør prioriteres, fordi den afgør, om en berørt kørsel overhovedet kan starte. Den kræver ikke et redesign af webshoppen. Den kræver, at den integrationsansvarlige kontrollerer en konkret indstilling og dokumenterer, at hele arbejdsgangen stadig gennemføres.
Hvilke arbejdsgange i webshoppen skal du undersøge?
En masseoperation er en API-arbejdsgang, der behandler store datamængder asynkront. I praksis kan en app sende en opgave afsted og hente resultatet senere i stedet for at holde en almindelig forespørgsel åben under hele behandlingen.
Det betyder ikke, at enhver stor import eller eksport bruger Shopifys endpoints til masseoperationer. Et værktøj kan bruge almindelige API-kald eller en anden understøttet metode. Regnearkets størrelse afslører ikke, hvilken metode der bruges.
Start med integrationer, der flytter store mængder webshopdata. Spørg den ansvarlige for jeres produktinformationssystem, hvordan katalogændringer bliver publiceret. Spørg den, der vedligeholder jeres rapporteringsintegration, hvordan data bliver hentet. Medtag også migreringsværktøjer og interne scripts, der kun kører sjældent: Et værktøj, der ligger ubrugt, kan skjule et adgangsproblem, indtil nogen pludselig har akut brug for det.
Notér forretningsformålet og den teknisk ansvarlige for hver arbejdsgang. Tilføj den tilhørende app, om den bruger bulk queries eller bulk mutations, og tidspunktet for næste planlagte kørsel. En kort oversigt er mere nyttig end en vag besked til alle om at “tjekke Shopify”.
Sådan kontrollerer du adgangen til Shopify-masseoperationer
Giv den appansvarlige en præcis opgave
De fleste webshopejere bør ikke selv skulle fejlfinde GraphQL-kald. Men de har brug for et klart svar fra den person eller leverandør, der er ansvarlig for dem.
Kalder vores integration bulkOperationRunQuery eller bulkOperationRunMutation? Bekræft venligst, at den nødvendige adgang er aktiveret for produktionsappen i Partner Dashboard. Kontrollér derefter, at en repræsentativ kørsel gennemføres, og at resultatet når frem til det tilsigtede system.
Den sidste del er vigtig. Et vellykket API-kald er ikke det samme som et opdateret modtagersystem. En eksport kan starte korrekt, selv om den proces, der downloader eller importerer resultatet, stadig fejler.
Kontakt leverandøren, hvis det er en offentlig app. Kontakt udvikleren, hvis det er en specialudviklet app bygget af en partner. Gå ikke ud fra, at jeres webshopmedarbejdere kan ændre en indstilling i Partner Dashboard fra Shopify-administrationen.
Kontrollér queries og mutations hver for sig
En integration kan godt læse kataloget uden problemer, men fejle, når den forsøger at skrive ændringer. Shopify håndterer adgang til bulk queries og bulk mutations separat, så en vellykket eksporttest beviser ikke, at en import vil fungere.
Tilpas adgangen til appens faktiske funktioner. Vi vil fraråde at aktivere bulk mutations for en app, der kun bruges til rapportering, blot fordi muligheden findes. Behandl adgang som et bevidst valg i konfigurationen, ikke som en formalitet.
Bekræft også, at udvikleren har kontrolleret produktionsappen. Resultater fra en udviklingsinstallation er nyttige under test, men dokumenterer ikke tilstanden for den app, der betjener jeres webshop i drift.
Kontrollér resultatet i praksis
Ved en query skal du kontrollere, at operationen gennemføres, og at de forventede data når frem til det sted, hvor teamet bruger dem. Sammenhold resultatet med det, eksporten skulle omfatte. En tom fil bør ikke tælle som en succes, bare fordi der findes en fil.
Ved en mutation bør I bruge en kontrolleret ændring, der passer til arbejdsgangen og kan rulles tilbage. Kontrollér de berørte dataposter bagefter, og gennemgå eventuelle fejlmeddelelser. Gem tilstrækkelig dokumentation til at kunne skelne en adgangsfejl fra et problem med de indsendte data.
Hvis en kørsel er fejlet, skal du ikke bare starte den igen
Shopify oplyser, at en anmodning om at starte en masseoperation uden adgang returnerer en fejl om nægtet adgang. Det fortæller dig, at den pågældende operation ikke kunne starte. Det fortæller ikke, hvad resten af integrationen gjorde inden dette kald.
En synkroniseringsproces kan have klargjort filer eller ændret dataposter via andre kald, før den forsøgte at starte massetrinnet. Find ud af, hvor processen stoppede, før du genstarter hele arbejdsgangen.
Vi anbefaler følgende fremgangsmåde til genopretning:
- Gem oplysningerne om fejlen. Bevar fejlsvaret, appens identitet og tidspunktet for kørslen, så udvikleren kan finde det trin, der fejlede.
- Stop gentagne fejlforsøg. Sæt den berørte tidsplan eller kø på pause, hvis nye forsøg bliver ved med at returnere samme adgangsfejl.
- Ret adgangen, og test den. Få den appansvarlige til at aktivere den nødvendige adgang og kontrollere en afgrænset operation.
- Afstem, før du genoptager. Kontrollér det allerede udførte arbejde og de aktuelle kildedata, og genoptag kun det arbejde, der stadig er nødvendigt.
Vær særligt opmærksom på opdateringer, der ligger i kø. Hvis kildedata er ændret siden fejlen, kan genafsendelse af gamle data overskrive en nyere ændring. Den rigtige løsning kan være en ny eksport fra kildesystemet frem for et nyt forsøg med den oprindelige fil.
Her er idempotens også vigtig. En idempotent arbejdsgang kan gentage den samme tilsigtede ændring uden at skabe yderligere utilsigtede effekter. Spørg udvikleren, hvordan integrationen forhindrer dobbeltbehandling under genopretning. Antag ikke, at “prøv igen” automatisk er sikkert.
Har du brug for en ny app eller en ombygget integration?
Det første spørgsmål bør som regel være, om den eksisterende app har den nødvendige adgang. Meddelelsen beskriver et adgangskrav, ikke et generelt krav om at udskifte integrationer.
Vi ville være skeptiske over for et forslag om at ombygge en fungerende dataintegration, før konfigurationen er kontrolleret. Omvendt bør en leverandør, der siger “vi har aktiveret adgangen”, også bekræfte, at jeres arbejdsgang fungerer, ikke bare at en indstilling er ændret.
Behold det eksisterende værktøj, hvis den ansvarlige kan forklare, hvordan det bruger masseoperationer, og dokumentere, at driften er genoprettet. Overvej en grundigere gennemgang, hvis ingen har ansvaret for integrationen, logfilerne ikke kan afsløre fejl, eller fejlede opgaver forsvinder uden en advarsel.
Vi anbefaler som udgangspunkt ikke at erstatte masseoperationer med almindelige API-kald alene for at undgå denne adgangskontrol. Det ændrer integrationens kørselsmodel og kan skabe andre udfordringer med ydeevne eller API-grænser. Løs først adgangsproblemet. Lav kun integrationen om, hvis der er en selvstændig forretningsmæssig grund til det.
Gør adgangskontrol til en del af appoverdragelsen
Den vigtigste langsigtede læring handler om ansvar. Webshopejere ved ofte, hvilken app der håndterer katalogdata, men ikke hvem der styrer konfigurationen på udviklersiden.
Tilføj en kort adgangsoversigt til dokumentationen for jeres integrationer. Den bør angive den ansvarlige organisation, produktionsappen og de typer masseoperationer, appen har brug for. Medtag også kontaktpersonen ved driftsproblemer og en beskrivelse af den test, der dokumenterer, at arbejdsgangen fungerer.
Gennemgå oversigten igen, når en app skifter ansvarlig eller får en ny funktion. En rapporteringsintegration, der senere begynder at skrive produktændringer, kræver en ny vurdering, selv om den oprindelige eksport stadig kører normalt.
Prioritér nu de berørte kørsler efter deres betydning for forretningen og næste planlagte kørselstidspunkt. Få først styr på den integration, teamet har brug for næste gang, og gennemgå derefter resten. Målet er dokumenteret driftskontinuitet, ikke en forhastet ombygning.
Det vigtigste at huske
- Shopify kræver separat adgang til bulk queries og bulk mutations i berørte partnerapps.
- Kravet gælder alle versioner af GraphQL Admin API. En nedgradering omgår det ikke.
- Bed den appansvarlige kontrollere adgangen i produktion og teste hele arbejdsgangen.
- Før fejlede kørsler genoptages, skal I afstemme allerede udført arbejde og kontrollere, om data i køen stadig er aktuelle.
Kilder
- Partnerapps skal aktivere masseoperationer før brug
- Shopping ind i fremtiden: Fall '26 Edition ... - Shopify
Skal vi tage os af det?
Vi er Shopify Premier Partner og arbejder hver dag med netop dette: hastighedsoptimering, konverteringsoptimering og udvikling af webshops, der tjener sig hjem. Book en gratis gennemgang af din webshop, så viser vi dig de tre forbedringer, vi ville gennemføre først.
Ofte stillede spørgsmål
Hvorfor returnerer Shopify-masseoperationer en fejl om nægtet adgang?
Shopifys meddelelse fra den 6. november kræver, at berørte partnerapps har adgang til masseoperationer aktiveret i Partner Dashboard. Hvis adgangen mangler, returnerer en anmodning om at starte en masseoperation en fejl om nægtet adgang. Bed den appansvarlige kontrollere den relevante adgangsindstilling og gennemgå den konkrete fejl.
Er adgang til bulk queries og bulk mutations adskilt?
Ja. bulkOperationRunQuery kræver adgang til bulk queries, mens bulkOperationRunMutation kræver adgang til bulk mutations. En vellykket eksport beviser ikke, at masseopdateringer har den nødvendige adgang.
Kan en ældre Shopify API-version omgå adgangskravet til masseoperationer?
Nej. Shopify oplyser, at kravet gælder alle versioner af GraphQL Admin API. Den appansvarlige skal rette adgangsindstillingerne frem for at nedgradere API-versionen.
Bør jeg genstarte en fejlet masseimport i Shopify, så snart adgangen er aktiveret?
Find først ud af, hvor arbejdsgangen stoppede, og om andre trin allerede blev gennemført. Kontrollér, at data i køen stadig er aktuelle. Test derefter den rettede adgang, og genoptag kun det nødvendige arbejde.
