Admin-API-aanvraag verzenden

Met de actie Admin-API-aanvraag verzenden verzend je een mutatie naar de Shopify GraphQL Admin-API. Hierdoor kun je bijna elke actie die de API toestaat uitvoeren met behulp van Flow.

Velden

De actie Admin-API-aanvraag verzenden bevat de volgende velden.

Velden die worden gebruikt bij de actie Admin-API-aanvraag verzenden.

Veld	Beschrijving
Mutatie	Vereist. De Shopify GraphQL Admin-mutatie die je wil aanroepen. Een mutatie is een API die actie onderneemt of gegevens bijwerkt.
Mutatie-invoer	Vereist. De gegevens (in JSON) die je verzendt als onderdeel van de mutatieaanvraag. Elke mutatie vereist een andere set gegevens, die wordt gedocumenteerd in de link die voor elke mutatie wordt verstrekt. Je kunt Liquid of een actie Code uitvoeren gebruiken om de nodige JSON te maken.

Triggers

Je kunt de actie Admin-API-aanvraag verzenden in elke workflow, met elke trigger, gebruiken, zolang de workflow de gegevens bevat die nodig zijn om de mutatie-invoer te maken.

Voorbeelden

Voorbeeld 1: De template bijwerken die voor een product wordt gebruikt

In dit voorbeeld gebruiken we de actie Admin-API-aanvraag verzenden om de mutatie productUpdate aan te roepen om de template bij te werken die voor een product wordt gebruikt.

Het veld id is vereist en kan alleen een geldige product-GID zijn. Hier stellen we het in met de Liquid-variabele {{product.id}}. Dit veronderstelt dat de workflow een trigger heeft die een productobject verschaft.

De templateSuffix is de naam van de template die je op het product wil toepassen. Als je bijvoorbeeld de pre-order-template wil toepassen, stel je de templateSuffix in op pre-order.

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

Voorbeeld 2: De belastingvrijstellingsstatus van een klant bijwerken

In dit voorbeeld gebruiken we de actie Admin-API-aanvraag verzenden om de mutatie customerUpdate aan te roepen om de belastingvrijstellingsstatus van een klant bij te werken.

Het veld id is vereist en kan alleen een geldige klant-GID zijn. Hier stellen we het in met de Liquid-variabele {{order.customer.id}}. Dit veronderstelt dat de workflow een trigger heeft die een bestelobject verschaft.

Het veld taxExempt is een boolean die aangeeft of de klant is vrijgesteld van belasting. In dit voorbeeld stellen we deze in op true.

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

Voorbeeld 3: De landinstellingen van een klant bijwerken

In dit voorbeeld gebruiken we de actie Admin-API-aanvraag verzenden om de mutatie customerUpdate aan te roepen om de landinstellingen van een klant bij te werken.

Het veld id is vereist en kan alleen een geldige klant-GID zijn. Hier stellen we het in met de Liquid-variabele {{customer.id}}. Dit veronderstelt dat de workflow een trigger heeft die een klantobject verschaft.

Het veld locale is een tekenreeks die de landinstellingen van de klant vertegenwoordigt. In dit voorbeeld stellen we deze in op en.

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

Beperkingen

De actie Admin-API-aanvraag verzenden heeft de volgende beperkingen:

• De actie retourneert geen gegevens in de Flow-omgeving als gevolg van de mutatie.
• De actie ondersteunt geen GraphQL-query's, alleen mutaties.
• De actie ondersteunt geen asynchrone mutaties of mutaties die een Job-type retourneren.
• De actie ondersteunt geen mutaties die specifiek zijn voor bepaalde apps, waaronder abonnementen en kortingsmutaties.
• Met de actie wordt een lijst weergegeven met Mutations en Mutation inputs van één Shopify API-versie, momenteel 2024-01.
• Wanneer de API-versie wordt bijgewerkt en een 'breaking change' (wijziging die fouten veroorzaakt) bevat, kan deze actie mislukken als je dat veld nodig hebt.