Shopify Flow e GraphQL Admin API

Flow utilizza la Shopify GraphQL Admin API per creare automazioni e integrazioni che estendono e migliorano il pannello di controllo Shopify. Flow utilizza la versione 2026-01 dell'API per valutare condizioni e variabili nei flussi di lavoro, nonché per eseguire azioni nel tuo negozio Shopify. Poiché Flow accede ai dati del negozio tramite chiamate all'API, da Flow puoi accedere a quasi tutti i campi disponibili nell'API.

Poiché Shopify rilascia nuove versioni dell'API ogni 3 mesi, alcuni flussi di lavoro potrebbero dover essere aggiornati quando i campi vengono modificati o diventano obsoleti.

Utilizzo della GraphQL Admin API nei flussi di lavoro

La maggior parte delle azioni in Flow utilizza la GraphQL Admin API per apportare modifiche al tuo negozio Shopify. Ad esempio, l'azione Aggiungi tag ordine utilizza la mutazione tagsAdd. L'azione Invia richiesta all'Admin API può utilizzare la maggior parte delle mutazioni, incluse quelle non ancora disponibili come azioni in Flow.

Quando crei flussi di lavoro, incontrerai spesso nomi di campo e descrizioni basati sulla sintassi della GraphQL Admin API. Ad esempio, per determinare la quantità totale vendibile di una variante in un flusso di lavoro, userai la variabile variants_item.inventoryQuantity. Invece, per determinare la sede in cui un cliente si è iscritto alla tua newsletter via email, userai la variabile emailSubscriptionMethod.

Non è necessario avere familiarità con l'API per creare flussi di lavoro con l'app Flow, ma una certa comprensione dei nomi delle variabili e delle loro definizioni può aiutarti a creare la logica specifica del flusso di lavoro che desideri. Ad esempio, conoscere la differenza tra il displayName e il firstName di un cliente può aiutare il flusso di lavoro ad accedere ai dati corretti a seconda dell'uso che se ne vuole fare. Le definizioni sono incluse in ogni variabile mentre crei il flusso di lavoro e puoi cliccare su per saperne di più su qualsiasi variabile o definizione.

Dati del negozio e GraphQL Admin API

I flussi di lavoro utilizzano i dati del negozio in condizioni e azioni. Flow accede ai dati del negozio utilizzando la GraphQL Admin API, il che significa che hai accesso a quasi tutti i campi dell'API. Se un'azione non dispone dei dati necessari forniti dal trigger o da un'azione Ottieni dati, il flusso di lavoro non viene eseguito e viene visualizzato un messaggio di errore.

Ad esempio, un flusso di lavoro inizia con un trigger Cliente creato e importa i dati del cliente nel flusso di lavoro. Se a tale trigger segue un'azione Aggiungi tag ordine, che richiede i dati dell'ordine e non quelli del cliente, il flusso di lavoro genererà un errore di dati mancanti.

Potrebbe essere necessario visualizzare l'anteprima dei dati o consultare la documentazione dell'API per capire quali dati vengono restituiti dall'API e utilizzati in Flow e per assicurarti che il flusso di lavoro restituisca i dati che ti aspetti.

Argomenti del campo e GraphQL Admin API

Alcuni campi di GraphQL Admin API richiedono argomenti, parametri aggiuntivi che restringono i dati restituiti. Ad esempio, il campo product.inCollection necessita di un argomento id della collezione per sapere quale collezione verificare. Senza di esso, il campo non può restituire un risultato.

In Flow, puoi creare variabili da questi campi fornendo il valore dell’argomento richiesto, che potrà poi essere utilizzato nel flusso di lavoro. Puoi anche assegnare un nome personalizzato alla variabile per semplificarne il richiamo nei passaggi successivi, ad esempio rinominando product.inCollection(id: "gid://shopify/Collection/123456") in product.inSummerBestsellers.

Scopri di più sulla creazione di variabili da campi con argomenti.

La creazione di variabili dai metafield richiede informazioni aggiuntive in Flow perché sei tu a definire lo spazio dei nomi e la chiave di ogni metafield, per cui gli argomenti sono sempre univoci per il tuo negozio. Scopri di più sui metafield in Flow.

Versioni dell’API

Shopify rilascia nuove versioni dell'API ogni 3 mesi e Flow adotta le nuove versioni il prima possibile, ma potrebbe essere in ritardo rispetto alla versione più recente. Ove possibile, le modifiche tra le versioni vengono risolte automaticamente, ma alcune modifiche potrebbero non essere immediate, incluse le seguenti situazioni:

• Quando i campi vengono rimossi ma non viene fornita alcuna sostituzione, con un potenziale impatto sul modo in cui vengono valutate le condizioni o Liquid.
• Quando i campi diventano nullable, con un potenziale impatto sul modo in cui vengono valutate le condizioni o Liquid.
• Quando i valori enum cambiano o vengono aggiunti nuovi tipi di unione o interfaccia, con un potenziale impatto su Liquid o sul codice.
• Quando cambiano gli argomenti della mutazione, con un potenziale impatto sulla configurazione delle azioni Invia richiesta all'Admin API.

Alcuni flussi di lavoro potrebbero dover essere aggiornati manualmente. In questi casi, i flussi di lavoro potrebbero mostrare un errore Aggiornamento richiesto o API non supportata e guidarti alla documentazione dell'API pertinente per apportare le modifiche necessarie nell'editor del flusso di lavoro. Una volta completati e salvati questi aggiornamenti, il flusso di lavoro si aggiorna automaticamente per utilizzare l'ultima versione dell'API disponibile in Flow.

Puoi scegliere di ignorare temporaneamente i problemi per apportare modifiche urgenti a un flusso di lavoro con errori di compatibilità della versione dell'API. Se questi problemi non vengono risolti, il flusso di lavoro potrebbe smettere di essere eseguito o causare errori quando la versione precedente dell'API non sarà più supportata da Shopify.