Masseoperasjoner i Shopify krever nå eksplisitt tilgang før berørte apper kan kjøre dem. Hvis nettbutikken din er avhengig av en planlagt katalogeksport eller en større produktoppdatering, bør du sjekke dette før neste jobb starter. Shopifys kunngjøring fra 6. november innfører separate tilgangskontroller for bulk queries og bulk mutations. Her viser vi hvordan du finner berørte integrasjoner, stiller utvikleren de riktige spørsmålene og gjenopptar avbrutte jobber uten å skape nye problemer.
Hva er endret for masseoperasjoner i Shopify?
I kunngjøringen om masseoperasjoner i partnerapper opplyser Shopify at apper må ha tilgang aktivert i Partner Dashboard før de kan starte bulk queries eller bulk mutations via GraphQL Admin API.
Tilgangene styres hver for seg. En app som skal eksportere data, trenger tilgang til bulk queries. En app som skal masseoppdatere data, trenger tilgang til bulk mutations. At den ene tilgangen er aktivert, betyr ikke at begge er det.
- Bulk queries: Tilgang kreves for å kjøre bulkOperationRunQuery.
- Bulk mutations: Tilgang kreves for å kjøre bulkOperationRunMutation.
- Manglende tilgang: En forespørsel om å starte en masseoperasjon gir en feilmelding om nektet tilgang.
- API-versjoner: Kravet gjelder alle versjoner av GraphQL Admin API.
Kunngjøringen gjelder offentlige apper og tilpassede apper utviklet av partnere som kjører masseoperasjoner. Nettbutikkeiere bør be appleverandøren bekrefte om kravet gjelder deres app, i stedet for å anta at alle integrasjoner som omtales som «tilpassede», har de samme kravene.
Å bytte til en eldre API-versjon løser ikke problemet. Kunngjøringen omfatter uttrykkelig alle versjoner. Løsningen starter med appens tilgangsinnstillinger.
Hvorfor dette bør prioriteres blant Fall ’26-lanseringene
I Shopifys utvikleroversikt for Fall ’26 beskrives det hvordan katalog, handlekurv og kasse åpnes for agenter og apper, sammen med verktøy for å bygge og sikre integrasjoner. Denne utviklingen gjør apptillatelser til et praktisk driftsansvar for nettbutikker, selv når innstillingene ligger utenfor Shopify-administrasjonen.
Vår vurdering: Den mest kritiske oppgaven etter en lansering er ofte den minst synlige. En ny handleopplevelse kan vente mens du vurderer den. Et tilgangskrav som påvirker kveldens eksport, kan ikke nødvendigvis det.
Denne oppdateringen bør prioriteres fordi den avgjør om en berørt jobb kan starte. Den krever ikke at nettbutikken redesignes. Den krever at den ansvarlige for integrasjonen sjekker en konkret innstilling og bekrefter at arbeidsflyten fortsatt fullføres.
Hvilke arbeidsflyter i nettbutikken bør du undersøke?
En masseoperasjon er en API-basert arbeidsflyt som håndterer store datamengder asynkront. I praksis kan en app sende inn en jobb og hente resultatet senere, i stedet for å holde en vanlig forespørsel åpen gjennom hele oppgaven.
Det betyr ikke at alle store importer eller eksporter bruker Shopifys endepunkter for masseoperasjoner. Et verktøy kan bruke vanlige API-forespørsler eller en annen støttet metode. Størrelsen på regnearket forteller deg ikke hvilken.
Start med integrasjoner som flytter store mengder butikkdata. Spør den ansvarlige for produktinformasjonssystemet hvordan katalogendringer publiseres. Spør den som vedlikeholder dataflyten til rapporteringen, hvordan data hentes ut. Ta også med migreringsverktøy og interne skript som sjelden kjøres: Et verktøy som ikke er i regelmessig bruk, kan skjule et tilgangsproblem helt til noen trenger det akutt.
Noter forretningsformålet og den teknisk ansvarlige for hver arbeidsflyt. Legg til hvilken app som brukes, om den bruker bulk queries eller bulk mutations, og neste planlagte kjøring. En kort oversikt er mer nyttig enn en vag beskjed om at alle må «sjekke Shopify».
Slik sjekker du tilgangen til masseoperasjoner i Shopify
Gi den appansvarlige en presis forespørsel
De fleste nettbutikkeiere skal ikke behøve å feilsøke GraphQL-forespørsler. Men de trenger et tydelig svar fra personen eller leverandøren som er ansvarlig for dem.
Bruker integrasjonen vår bulkOperationRunQuery eller bulkOperationRunMutation? Bekreft at nødvendig tilgang er aktivert for produksjonsappen i Partner Dashboard. Kontroller deretter at en representativ jobb fullføres, og at resultatet når frem til riktig mottakersystem.
Det siste punktet er viktig. En vellykket API-forespørsel er ikke det samme som at systemet som skal motta dataene, er oppdatert. En eksport kan starte som den skal, samtidig som prosessen som laster ned eller importerer resultatet, feiler.
For en offentlig app kontakter du leverandøren. For en tilpasset app utviklet av en partner kontakter du utvikleren. Ikke ta for gitt at butikkmedarbeiderne kan endre en innstilling i Partner Dashboard fra butikkens administrasjonspanel.
Sjekk lesing og oppdatering hver for seg
En integrasjon kan lese katalogen uten problemer, men feile når den forsøker å skrive endringer. Shopify håndterer tilgang til bulk queries og bulk mutations separat. En vellykket eksporttest bekrefter derfor ikke at en import vil fungere.
Tilpass tilgangene til appens faktiske funksjoner. Vi ville unngått å aktivere bulk mutations for en app som bare brukes til rapportering, bare fordi valget finnes. Tilgang bør være et bevisst konfigurasjonsvalg, ikke en avkrysningsøvelse.
Bekreft også at utvikleren har sjekket produksjonsappen. Resultater fra en utviklingsinstallasjon er nyttige under testing, men sier ikke noe sikkert om tilstanden til appen som brukes i den aktive nettbutikken.
Kontroller at jobben gir ønsket resultat
For en bulk query må du bekrefte at operasjonen fullføres, og at de forventede dataene kommer frem dit teamet bruker dem. Sammenlign resultatet med det eksporten skulle omfatte. En tom fil skal ikke regnes som et vellykket resultat bare fordi filen finnes.
For en bulk mutation bør du bruke en kontrollert endring som passer arbeidsflyten og kan reverseres. Kontroller de aktuelle postene etterpå, og undersøk eventuelle rapporterte feil. Ta vare på nok dokumentasjon til å skille en tilgangsfeil fra et problem med dataene som ble sendt inn.
Ikke kjør en mislykket jobb på nytt uten å undersøke først
Shopify opplyser at en forespørsel om å starte en masseoperasjon uten nødvendig tilgang gir en feilmelding om nektet tilgang. Det forteller deg at operasjonen ikke kunne starte. Det forteller deg ikke hva resten av integrasjonen gjorde før denne forespørselen.
En synkroniseringsflyt kan ha klargjort filer eller endret poster gjennom andre forespørsler før den forsøkte å kjøre massesteget. Finn ut hvor den stoppet før du starter hele arbeidsflyten på nytt.
Vi anbefaler denne rekkefølgen for gjenoppretting:
- Ta vare på feildetaljene. Behold feilsvaret, appidentiteten og jobbens tidsstempel, slik at utvikleren kan finne steget som feilet.
- Stopp gjentatte mislykkede forsøk. Sett den berørte tidsplanen eller køen på pause hvis nye forsøk fortsetter å gi samme tilgangsfeil.
- Korriger tilgangen og test den. Be den appansvarlige aktivere nødvendig tilgang og verifisere en kontrollert operasjon.
- Avstem før du kjører på nytt. Kontroller hva som er fullført, og hva kildedataene inneholder nå. Gjenoppta deretter bare arbeidet som fortsatt er nødvendig.
Vær særlig forsiktig med oppdateringer som ligger i kø. Hvis kildedataene har endret seg siden feilen oppstod, kan gamle data overskrive en nyere beslutning når jobben kjøres på nytt. Riktig løsning kan være en ny eksport fra kildesystemet i stedet for å prøve den opprinnelige filen igjen.
Her er også idempotens viktig. En idempotent arbeidsflyt kan gjenta den samme tilsiktede endringen uten å skape flere utilsiktede effekter. Spør utvikleren hvordan integrasjonen hindrer dobbeltarbeid under gjenoppretting. Ikke anta at «prøv på nytt» betyr at det er trygt.
Trenger du en ny app eller en ombygd integrasjon?
Det første spørsmålet bør vanligvis være om den eksisterende appen har nødvendig tilgang. Kunngjøringen beskriver et tilgangskrav, ikke et generelt krav om å bytte ut integrasjoner.
Vi ville vært skeptiske til et forslag om å bygge om en fungerende dataflyt før konfigurasjonen er sjekket. Samtidig bør en leverandør som sier «vi har aktivert det», bekrefte at arbeidsflyten din fungerer, ikke bare at en innstilling er endret.
Behold det eksisterende verktøyet hvis den ansvarlige kan forklare hvordan det bruker masseoperasjoner, og vise at jobben fungerer igjen. Vurder en grundigere gjennomgang hvis ingen har ansvar for integrasjonen, loggene ikke gjør det mulig å identifisere feil, eller mislykkede jobber forsvinner uten varsel.
Vi anbefaler som hovedregel ikke å erstatte masseoperasjoner med vanlige forespørsler bare for å omgå denne tilgangskontrollen. Det endrer hvordan integrasjonen kjøres, og kan skape andre utfordringer med ytelse eller API-grenser. Løs tilgangsproblemet først. Bygg om bare hvis det finnes en egen forretningsmessig begrunnelse for det.
Gjør tilgangssjekken til en del av overleveringen
Den viktigste lærdommen handler om ansvar. Nettbutikkeiere vet ofte hvilken app som håndterer katalogdata, men ikke hvem som styrer konfigurasjonen på utviklersiden.
Legg inn en kort tilgangsoversikt i integrasjonsdokumentasjonen. Den bør angi ansvarlig virksomhet, produksjonsappen og hvilke masseoperasjoner appen trenger tilgang til. Ta med kontaktperson ved problemer og en beskrivelse av testen som bekrefter at arbeidsflyten fungerer.
Gå gjennom oversikten på nytt når en app får ny ansvarlig eller nye funksjoner. En rapporteringsintegrasjon som senere begynner å skrive produktendringer, trenger en ny vurdering, selv om den opprinnelige eksportflyten fortsatt kjører som normalt.
Prioriter nå de berørte jobbene etter konsekvensene for virksomheten og tidspunktet for neste kjøring. Sikre først det teamet trenger neste gang, og gå deretter gjennom resten. Målet er å bekrefte stabil drift, ikke å bygge om i hast.
Viktige punkter
- Shopify krever separat tilgang til bulk queries og bulk mutations i berørte partnerapper.
- Kravet gjelder alle versjoner av GraphQL Admin API. En nedgradering omgår det ikke.
- Be den appansvarlige kontrollere tilgangen i produksjon og teste hele arbeidsflyten.
- Før mislykkede jobber kjøres på nytt, må du avstemme fullført arbeid og sjekke om dataene i køen fortsatt er oppdaterte.
Kilder
- Partnerapper må aktivere masseoperasjoner før bruk
- Fremtidens handel: Fall '26 Edition ... – Shopify
Vil du ha hjelp med dette?
Vi er Shopify Premier Partner og jobber med dette hver dag: ytelse, konverteringsoptimalisering og nettbutikker som lønner seg. Bestill en gratis gjennomgang av nettbutikken, så viser vi deg de tre forbedringene vi ville gjennomført først.
Ofte stilte spørsmål
Hvorfor gir masseoperasjoner i Shopify en feilmelding om nektet tilgang?
Shopifys kunngjøring fra 6. november krever at berørte partnerapper har tilgang til masseoperasjoner aktivert i Partner Dashboard. Uten denne tilgangen vil en forespørsel om å starte en masseoperasjon gi en feilmelding om nektet tilgang. Be den appansvarlige sjekke den aktuelle tilgangen og undersøke den konkrete feilmeldingen.
Er tilgang til bulk queries og bulk mutations separate tillatelser?
Ja. Tilgang til bulk queries kreves for bulkOperationRunQuery, mens tilgang til bulk mutations kreves for bulkOperationRunMutation. En vellykket eksport bekrefter ikke at appen har nødvendig tilgang til masseoppdateringer.
Kan en eldre Shopify API-versjon omgå tilgangskravet for masseoperasjoner?
Nei. Shopify opplyser at kravet gjelder alle versjoner av GraphQL Admin API. Den appansvarlige bør korrigere tilgangsinnstillingene i stedet for å nedgradere API-versjonen.
Bør jeg starte en mislykket masseimport i Shopify på nytt så snart tilgangen er aktivert?
Finn først ut hvor arbeidsflyten stoppet, og om andre steg ble fullført. Sjekk at dataene i køen fortsatt er oppdaterte. Test deretter den korrigerte tilgangen, og gjenoppta bare arbeidet som fortsatt er nødvendig.
