Send Admin API-anmodning

Handlingen Send Admin API-anmodning sender en mutation til Shopify GraphQL Admin API’en. Hvis du bruger denne, kan du udføre næsten alle handlinger, som API’en tillader, ved hjælp af Flow.

Felter

Handlingen Send Admin API-anmodning indeholder følgende felter.

Felter, der bruges i handlingen “Send Admin API-anmodning”.

Felt	Beskrivelse
Mutation	Påkrævet. Den Shopify GraphQL Admin-mutation, du vil foretage et kald til. En mutation er en API, der udfører handlinger eller opdaterer data.
Mutationsinputs	Påkrævet. De data (i JSON-format), du skal sende som en del af din mutationsanmodning. Hver mutation kræver et forskelligt datasæt, som er dokumenteret i det link, der er angivet for hver mutation. Du kan bruge Liquid eller en “Kør kode”-handling til at oprette det nødvendige JSON-format.

Triggere

Handlingen Send Admin API-anmodning kan bruges i alle workflows og med alle udløsere, så længe workflowet angiver de data, der er nødvendige for at kunne oprette mutationsinputtene.

Eksempler

Eksempel 1: Opdater den skabelon, der bruges til et produkt

I dette eksempel bruger vi handlingen Send Admin API-anmodning til at kalde mutationen productUpdate for at opdatere den skabelon, der bruges til et produkt.

Feltet id er påkrævet og skal være et gyldigt produkt-GID. Her indstiller vi det med Liquid-variablen {{product.id}}. Dette forudsætter, at dit workflow har en udløser, der leverer et produktobjekt.

templateSuffix er navnet på den skabelon, du vil anvende på produktet. Hvis du f.eks. vil anvende skabelonen pre-order, skal du angive templateSuffix til pre-order.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

Eksempel 2: Opdater en kundes status for skattefritagelse

I dette eksempel bruger vi handlingen Send Admin API-anmodning til at kalde mutationen customerUpdate for at opdatere en kundes status for skattefritagelse.

Feltet id er påkrævet og skal være et gyldigt kunde-GID. Her indstiller vi det med Liquid-variablen {{order.customer.id}}. Dette forudsætter, at dit workflow har en udløser, der angiver et ordreobjekt.

Feltet taxExempt er en boolesk værdi, der angiver, om kunden er fritaget for skat. I dette eksempel indstiller vi den til true.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

Eksempel 3: Opdater en kundes landestandard

I dette eksempel bruger vi handlingen Send Admin API-anmodning til at kalde mutationen customerUpdate for at opdatere en kundes landestandard.

Feltet id er påkrævet og skal være et gyldigt kunde-GID. Her indstiller vi det med Liquid-variablen {{customer.id}}. Dette forudsætter, at dit workflow har en udløser, der leverer et kundeobjekt.

Feltet locale er en streng, der repræsenterer kundens landestandard. I dette eksempel indstiller vi den til en.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Begrænsninger

Handlingen Send Admin API-anmodningen har følgende begrænsninger:

• Handlingen returnerer ikke data til Flow-miljøet som følge af mutationen.
• Handlingen understøtter ikke GraphQL-forespørgsler, kun mutationer.
• Handlingen understøtter ikke asynkrone mutationer eller mutationer, der returnerer en Job-type.
• Handlingen understøtter ikke mutationer, der er specifikke for visse apps, som inkluderer abonnements- og rabatmutationer.
• Handlingen viser en liste over Mutations og Mutation inputs fra en enkelt Shopify API-version, som i øjeblikket er 2024-01.
• Når API-versionen er opgraderet og indeholder en ødelæggende ændring, kan det medføre, at denne handling mislykkes, hvis du benytter dig af dette felt.