Shopify Flow'ssa käytettävien API-tietojen esikatselu

Useimmat työnkulut käyttävät kauppasi tietoja, jotta niitä voi käyttää ehdoissa ja toiminnoissa. Shopify Flow käyttää kaupan tietoja kutsumalla GraphQL Admin APIa ja antaa sinulle pääsyn lähes kaikki APIn kenttiin.

Kun rakennat työnkulkua, näet usein kenttien nimiä ja kuvauksia, jotka perustuvat APIin, mutta sinun pitää ehkä tietää näiden tietojen arvot. Saatat esimerkiksi haluta tietää sovellusnimen tilaukselle, joka on luotu tilausluonnoksesta. Lisäksi saatat haluta varmistaa, että työnkulku tuottaa odottamasi tiedot tai että ne ovat odottamassasi muodossa.

Sinulla on Shopify Flow'ssa useita vaihtoehtoja tietojen arvojen tarkastelemiseen.

Tällä sivulla

Kentän etsiminen Shopify Adminissa

Useimmiten löydät tiedot Shopify Administa etsimällä. Esimerkiksi product.title on listattu tuotesivulla.

Esimerkkitietojen hankinta

Kun luot työnkulun, voit saada esimerkkitietoja suoraan Flow-editoriin. Koska Flow'n tiedot tulevat tapahtumista, tarkkojen esimerkkitietojen saamiseksi sinun on aloitettava valitsemalla sopiva tapahtuma:

Avaa Flow'n editorissa toiminto, jossa haluat käyttää tietoja, ja klikkaa Lisää muuttuja. Vaihtoehtoisesti voit klikata ehdossa Lisää kriteerejä.
Klikkaa Määritä esimerkkitiedot.
Flow näyttää aiemmat tapahtumat työnkulun käynnistimen perusteella. Nouda tapahtumia viimeaikaisista ajoista valitsemalla Päivitä tapahtumat tai klikkaa Aloita live-tapahtumien kuuntelu ja käynnistä sitten tapahtuma manuaalisesti Administa tai oikeasta sovelluksesta (jos käynnistin on sovelluspohjainen).
Tapahtuman jälkeen Flow näyttää tapahtuman tiedot. Valitse tapahtuma, josta haluat hankkia esimerkkitietoja. Klikkaa Käytä tätä käynnistintapahtumaa.
Kun nyt selaat tapahtumia, kunkin muuttujan pitäisi näyttää esimerkkitietoja.

Rajoitukset:

Listamuotoisten tietojen tilarajoitteiden vuoksi Flow näyttää vain listan ensimmäisen kohdan tiedot.
Flow tallentaa kullekin työnkululle enintään viisi tapahtumaa kerrallaan.
Flow ei voi noutaa tapahtumia joidenkin käynnistinten viimeaikaisista ajoista – esim. Asetettu aika, Metaobjektimerkintä luotu, Segmenttiin liittyi asiakasSegmentistä poistui asiakas.

Kentän käyttäminen live-työnkulussa

Voit turvallisesti käyttää työnkulun kenttiä Kirjaa tulos -toiminnolla. Kun suoritat työnkulun, Kirjaa tulos -toiminto tulostaa kaikkien muuttujien ja tekstien tuotoksen Suoritushistoria-sivulle. Voit myös käyttää ilmoitustoimintoja, kuten Lähetä sisäinen sähköposti.

Kirjaa tulos -toiminnon vaiheet:

Valitse käynnistin, joka voidaan käynnistää manuaalisesti.
Lisää työnkulkuun Kirjaa tulos -toiminto ja liitä se käynnistimeen.
Klikkaa Kirjaa tulos -konfiguraatiossa Lisää muuttuja lisätäksesi tarkastettavat muuttujat Tulos-osioon.
Kun olet tehnyt tämän, klikkaa Ota työnkulku käyttöön.
Käynnistä työnkulku joko suorittamalla se manuaalisesti tai aiheuttamalla käynnistimen laukaisun. Jos esimerkiksi käytät Tilaus luotu -käynnistintä, luo testitilaus.
Kun työnkulku on suoritettu, tarkista muuttujat toimintalokista.

Tietojen katsominen JSON-resurssisivulta

Useimmat Shopify Adminin resurssisivut, kuten Tilaus-, Tuote- tai Asiakas-sivut, mahdollistavat sivuun liittyvien tietojen tarkastelemisen. Näillä tiedoilla ei ole täsmälleen samoja nimiä ja muotoja kuin, mitä Shopify Flow käyttää, mutta arvot vastaavat GraphQL Admin API:ssa olevia arvoja. Voit tarkastella tietoja lisäämällä päätteen .json URL-osoitteeseen.

Siirry esimerkiksi tilaukseen menemällä Shopify Adminissa Tilaukset-sivulle ja klikkaamalla tilausta. Vaihda selaimesi osoitepalkissa olevan sivun osoite osoitteesta

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

Seuraavaksi:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

GraphiQL:n tai kolmannen osapuolen API-työkalun käyttäminen

Voit tehdä API-kyselyjä suoraan käyttämällä kolmannen osapuolen API-työkalua, kuten Postmania, tai ilmaista Shopifyn tarjoamaa GraphiQL-työkalua. Tämä vaihtoehto antaa tarkimmat tulokset, mutta se edellyttää jonkin verran perehtyneisyyttä GraphQL-kyselyjen luomiseen.

Shopify tarjoaa GraphiQL:lle sekä verkkopohjaisen GraphiQL Explorer -sovelluksen geneerisillä tiedoilla että GraphiQL-sovelluksen. GraphiQL:n avulla voit luoda GraphQL-kyselyn, joka vastaa tarkasti Shopify Flow'n kenttien nimiä. Jos käytät tätä sovellusta, myös arvot vastaavat täsmälleen kauppasi arvoja.

Tällä työkalulla voit määrittää tarkalleen, mitä tietoja Shopify Flow käyttää, todellisten kauppatietojesi avulla. Voit esimerkiksi luoda seuraavan kyselyn:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

Seuraavissa tuloksissa muuttuja order / app / name näyttää sovelluksen nimen tilaukselle. Tässä tapauksessa tilaus luotiin tilausluonnossovelluksesta, joten arvo on Draft Orders. Kanavatiedot ovat käytettävissä vain Point of Sale -sovellukselle.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }