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

გვერდის მონაცემების მიღება

სამუშაო პროცესებში, რომლებიც მოითხოვენ გვერდის მონაცემებს, შეგიძლია გამოიყენო გვერდის მონაცემების მიღების მოქმედება შენი მაღაზიიდან გვერდის ინფორმაციის დასაბრუნებლად. გვერდები არის შენი ონლაინ მაღაზიის ვებგვერდები, რომლებიც შეიცავენ იშვიათად ცვალებად ინფორმაციას, როგორიცაა „ჩვენ შესახებ“ (About Us) ან „კონტაქტი“ (Contact) გვერდები.

ამ გვერდზე

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

ველები

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

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

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

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

published_status:published

published_status ცვლადი არის ფილტრი, რომელიც ხელმისაწვდომია გვერდების მოთხოვნაში და მისი მრავალჯერ გამოყენება ან სხვა ცვლადებთან კომბინირება შესაძლებელია.

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

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

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

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

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

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

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

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

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

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

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

ტრიგერები

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

API ცნობარი

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