Súgó
Bejelentkezés

Előfizetői szerződés adatainak lekérése

Az előfizetői szerződések adatait használó munkafolyamatokban az Előfizetői szerződés adatainak lekérése művelettel kérheti le az előfizetői szerződésekre vonatkozó információkat az üzletéből.

Ezen az oldalon

Konfiguráció

Mezők

Az Előfizetői szerződés adatainak lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés létrehozásához használatosak:

Az Adatok lekérése műveletekben használt mezők.
MezőLeírás
Adatok rendezéseKötelező. Azok a paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatokat rendezi a rendszer.
Találatok maximális számaKötelező. A kiválasztott keresési lekérdezés által visszaadható találatok maximális száma. Egyszerre legfeljebb 100 adható vissza.
LekérdezésKötelező. Válasszon a gyakori lekérdezések közül, vagy válassza a Speciális lehetőséget saját lekérdezés létrehozásához.

Lekérdezési karakterlánc

Ez egy példa lekérdezés az ACTIVE állapotú előfizetői szerződések lekérésére:

status: ACTIVE

A status változó egy szűrő, amely az Előfizetői szerződések lekérdezésében érhető el, és többször is használható.

Az adatok lekérdezésekor hasznos tudni a következőket:

  • Az elérhető szűrők listája
  • A lekérdezéseknek meghatározott szintaxist kell követniük.
  • A lekérdezési mezők értékei nem mindig vannak dokumentálva. Egyes esetekben az értékek az API-dokumentációban találhatók meg. Másik lehetőségként gyakran megtalálhatja a mezőértékeket az adminisztrációs felület URL-jeiben, amikor szűr. Például bizonyos rendelési lekérdezési értékek megkereséséhez szűrjön rá a Rendelések oldalon az adminisztrációs felületen, majd ellenőrizze az URL-t.
  • A lekérdezéseket az üzletében a Shopify GraphiQL alkalmazással futtathatja vagy tesztelheti.
  • Figyeljen arra, mi történik, ha a lekérdezés meghiúsul. Az API gyakran az összes eredményt visszaadja (ahelyett, hogy egyet sem).

Visszaadott adatok

Minden Adatok lekérése művelet egy 0 és 100 közötti erőforrást tartalmazó listát ad vissza. Felhasználási esettől függően ezeket az adatokat különféle módokon használhatja fel:

  • Ha az egyes listaelemeket egyenként kell kezelnie, például hogy mindegyikhez címkét adjon hozzá, akkor használhatja a For each műveletet.
  • Ha adatokat kell összesítenie, például meg kell számolnia a visszaadott eredmények számát, akkor a Count vagy a Sum műveletet használhatja.
  • Ha a lista kiadására van szüksége, például egy e-mailt kell küldenie az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a rákövetkező műveletekben.

A műveletet követő lépésekben a visszaadott adatok eléréséhez használja a Get subscription contact data nevű változót, amely az előfizetői szerződések listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a rendelések listáját egy Belső e-mail küldése műveletben az alábbiak szerint:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Kiváltók

Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Az Ütemezett időpont kiváltót használó munkafolyamat egy Ön által megadott időpontban indul el, nem pedig egy esemény hatására. Mivel nincs olyan konkrét esemény az üzletében vagy egy alkalmazásból, amely elindítaná a munkafolyamatot, az nem tartalmaz automatikusan adatokat.

API-referencia