დახმარება
შესვლა

სტატიის მონაცემების მიღება

სამუშაო პროცესებში, რომლებიც მოითხოვს ბლოგის სტატიის მონაცემებს, შეგიძლია გამოიყენო სტატიის მონაცემების მიღების ქმედება შენი Shopify-ს მაღაზიიდან სტატიის ინფორმაციის დასაბრუნებლად.

ამ გვერდზე

კონფიგურაცია

ველები

სტატიის მონაცემების მიღების ქმედება შეიცავს შემდეგ ველებს:

„მონაცემების მიღების“ ქმედებებში გამოყენებული ველები.
ველიაღწერა
მონაცემების დახარისხებააუცილებელია. პარამეტრები, რომელთა მიხედვითაც ხარისხდება საძიებო მოთხოვნის მიერ დაბრუნებული მონაცემები.
შედეგების მაქსიმალური რაოდენობააუცილებელია. შედეგების მაქსიმალური რაოდენობა, რომლის დაბრუნებაც შენ მიერ არჩეულ საძიებო მოთხოვნას შეუძლია. შეგიძლია ერთდროულად დააბრუნო 100-მდე შედეგი.
მოთხოვნააუცილებელია. აირჩიე გავრცელებული მოთხოვნებიდან, ან აირჩიე Advanced შენი საკუთარის შესაქმნელად.

მოთხოვნის სტრიქონი

ეს არის ბოლო დღეს გამოქვეყნებული სტატიების მისაღებად მოთხოვნის მაგალითი:

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

published_at ცვლადი არის სტატიების მოთხოვნაში ხელმისაწვდომი ფილტრი და მისი გამოყენება შესაძლებელია რამდენჯერმე, ან სხვა ცვლადებთან კომბინაციაში. scheduledAt Liquid ცვლადი ხელმისაწვდომია სამუშაო პროცესებში, რომლებიც იყენებენ დაგეგმილი დროის ტრიგერს. date_minus Liquid თეგი არის სპეციალური Flow თეგი, რომელიც გაძლევს თარიღისთვის დროის გამოკლების საშუალებას.

მონაცემების მოთხოვნისას სასარგებლოა იცოდე, რომ:

  • სტატიის ხელმისაწვდომი ფილტრების სია

  • მოთხოვნები უნდა მიჰყვებოდეს კონკრეტულ სინტაქსს

  • მოთხოვნის ველის მნიშვნელობები ყოველთვის არ არის დოკუმენტირებული. ზოგ შემთხვევაში მნიშვნელობების პოვნა შესაძლებელია API-ს დოკუმენტაციის შემოწმებით. ალტერნატიულად, ხშირად შეგიძლია იპოვო ველის მნიშვნელობები URL-ებში ადმინ პანელში გაფილტვრისას. მაგალითად, შეკვეთის მოთხოვნის ზოგიერთი მნიშვნელობის საპოვნელად გაფილტრე „შეკვეთების“ გვერდი ადმინ პანელში და შემდეგ შეამოწმე URL.

  • შენს მაღაზიაში შეგიძლია გაუშვა ან დატესტო მოთხოვნა Shopify GraphiQL აპის გამოყენებით.

  • გაითვალისწინე, რა ხდება მოთხოვნის წარუმატებლობის შემთხვევაში. ხშირად API დააბრუნებს ყველა შედეგს (ნაცვლად არცერთისა).

დაბრუნებული მონაცემები

მონაცემების მიღების ყველა ქმედება აბრუნებს 0-დან 100-მდე რესურსის სიას. შენი კონკრეტული შემთხვევის მიხედვით, შეიძლება დაგჭირდეს ამ მონაცემების სხვადასხვანაირად გამოყენება:

  • თუ გჭირდება სიის თითოეული ერთეულის ინდივიდუალურად დამუშავება, მაგალითად თითოეულისთვის თეგის დამატება, შეგიძლია გამოიყენო ქმედება For each.
  • თუ გჭირდება მონაცემების აგრეგირება, მაგალითად იმის დათვლა, თუ რამდენი შედეგი დაბრუნდა, შეგიძლია გამოიყენო ქმედებები Count ან Sum.
  • თუ გჭირდება სიის გამოტანა, მაგალითად ელფოსტის გაგზავნა ყველა ერთეულით, შეგიძლია გამოიყენო დაბრუნებული მონაცემები პირდაპირ შემდგომ ქმედებებში.

ამ ქმედების მომდევნო ნაბიჯებში დაბრუნებულ მონაცემებზე წვდომისთვის გამოიყენე ცვლადი სახელწოდებით სტატიის მონაცემების მიღება, რომელიც წარმოადგენს სტატიების სიას. შეგიძლია გამოიყენო ეს ცვლადი როგორც პირობებში, ასევე ქმედებებში. მაგალითად, შეგიძლია გააგზავნო სტატიების სია ქმედებაში შიდა ელფოსტის გაგზავნა (Send internal email), ასეთნაირად:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

ტრიგერები

შეგიძლია გამოიყენო ეს ქმედება ნებისმიერ სამუშაო პროცესში, მათ შორის დაგეგმილი დროის ტრიგერში. სამუშაო პროცესში, რომელიც იყენებს დაგეგმილი დროის ტრიგერს, სამუშაო პროცესი იწყება შენ მიერ მითითებულ დროს და არა რაიმე მოვლენის შედეგად. ვინაიდან არ არსებობს შენს მაღაზიაში ან აპში კონკრეტული მოვლენა, რომელიც იწყებს სამუშაო პროცესს, მონაცემები ავტომატურად არ დაერთვება.

API ცნობარი

ამ ქმედებაში გამოყენებული API-ს შესახებ დამატებითი ინფორმაციისთვის იხილე სტატიების მოთხოვნა.