Azione Ottieni i dati dei prodotti

Nei flussi di lavoro che utilizzano i dati dei prodotti puoi utilizzare l'azione Get product data (Ottieni i dati dei prodotti) per recuperare queste informazioni dal tuo negozio.

Su questa pagina

Configurazione

Campi

L'azione Get product data (Ottieni i dati dei prodotti) contiene i seguenti campi, utilizzati per creare la query:

Campi utilizzati nelle azioni Get data (Ottieni dati).
Campo	Descrizione
Sort data by (Ordina dati per)	Obbligatorio. I parametri secondo i quali vengono ordinati i dati restituiti dalla query di ricerca.
Maximum number of results (Numero massimo di risultati)	Obbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Possono esserne restituiti fino a 100 alla volta.
Query	Obbligatorio. Scegli tra le query più comuni o seleziona Advanced (Avanzato) per crearne di nuove.

Stringa di query

Questa è una query di esempio per ottenere i prodotti aggiornati nell'ultimo giorno:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variabile updated_at è un filtro disponibile nella query dei prodotti e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che hanno utilizzato il trigger Scheduled time (Orario programmato). Il tag Liquid date_minus è un tag Flow speciale che ti consente di sottrarre del tempo da una data.

Quando si eseguono query sui dati, è utile conoscere quanto segue:

Elenco dei filtri dei prodotti disponibili - Le query devono seguire una determinata sintassi.
I nomi dei campi di query per tutte le query sono disponibili nella documentazione per sviluppatori relativa all'oggetto QueryRoot.
I valori dei campi di query non sono sempre documentati. In alcuni casi, si possono trovare consultando i documenti API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi filtri. Ad esempio, per trovare alcuni valori di query degli ordini, filtra la pagina Ordini nel pannello di controllo e verifica l'URL.
Puoi eseguire o provare una query nel tuo negozio utilizzando l'app GraphiQL di Shopify.
Presta attenzione a cosa succede se la query non va a buon fine. Spesso l'API restituisce tutti i risultati (anziché nessuno).

Dati restituiti

Tutte le azioni Get data (Ottieni dati) restituiscono un elenco contenente da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti utilizzare questi dati in diversi modi:

Se devi gestire singolarmente ogni voce di elenco, ad esempio per aggiungere un tag per ogni voce, puoi utilizzare l'azione For each (Per ogni).
Se devi aggregare i dati, ad esempio contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Count (Conta) o Sum (Somma).
Se hai bisogno di generare l'elenco, ad esempio per inviare un'email con tutte le voci, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Get product data (Ottieni i dati dei prodotti), che è un elenco di prodotti. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco dei prodotti in un'azione Send internal email (Invia email interna) in questo modo:

{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, compreso il trigger Scheduled time (Orario programmato). Un flusso di lavoro che utilizza il trigger Scheduled time (Orario programmato) inizia nel momento da te specificato, anziché a seguito di un evento. Poiché nel tuo negozio o in un'app non c'è un evento specifico che avvii il flusso di lavoro, non ci sono dati inclusi automaticamente.

Dettagli API

Modelli

Aggiunta di prodotti con un tag a una collezione in futuro

In un orario futuro, ottieni tutti i prodotti con un determinato tag e li aggiungi a una collezione. Visualizza modello

Eliminazione dei prodotti inattivi

Elimina i prodotti senza scorte che non sono stati aggiornati per un anno. Visualizza modello

Pubblica prodotti con un determinato tag in futuro

In una data futura, ottieni prodotti con un determinato tag e pubblicali. Utilizza il trigger Scheduled time (Orario programmato) e l'azione Get product data (Ottieni i dati dei prodotti). Visualizza modello

Rimozione del tag di prodotto "nuovo" 90 giorni dopo la creazione del prodotto

Ogni giorno, raccoglie fino a 100 prodotti creati più di 90 giorni fa e che hanno ancora il tag "nuovo". Quindi il flusso di lavoro rimuove questi tag per ogni prodotto. Visualizza modello

Programma la rimozione dei prodotti dal negozio online nella data e ora specificata

In una singola data nel futuro, rimuovi i prodotti dal negozio online in base al tag, ID o SKU. Utilizza il trigger Scheduled time (Orario programmato), l'azione Get product data (Ottieni i dati dei prodotti) e il loop For Each. Visualizza modello

Invio di un riepilogo giornaliero via email con i prodotti esauriti

Ogni giorno ottiene tutti i prodotti che hanno 0 scorte e invia un riepilogo via email. Utilizza il trigger Get product data (Ottieni dati dei prodotti) e Scheduled time (Orario programmato). Visualizza modello

Invio di una notifica email quando una variante viene aggiunta con una SKU duplicata

Quando viene aggiunta una nuova variante, controlla se qualche altra variante utilizza la stessa SKU. In quel caso, invia un'email interna con link al prodotto e alla variante interessati. Visualizza modello

Monitoraggio delle varianti di prodotto in offerta utilizzando un metafield del prodotto

Imposta un metafield su un prodotto se almeno una delle sue varianti è in offerta. Questa opzione può risultare utile per monitorare i prodotti in offerta in un determinato momento. Visualizza modello