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

ლოკაციის მონაცემების მიღება

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

ამ გვერდზე

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

ველები

Get location data მოქმედება შეიცავს შემდეგ ველებს.

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

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

ეს არის მოთხოვნის მაგალითი იმ ლოკაციების მისაღებად, რომლებშიც ჩართულია მაღაზიიდან გატანა:

pickup_in_store:enabled

ცვლადი pickup_in_store წარმოადგენს ფილტრს, რომელიც ხელმისაწვდომია Locations query-ში (ლოკაციების მოთხოვნაში), და მისი გამოყენება შეიძლება რამდენჯერმე ან სხვა ცვლადებთან ერთად.

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

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

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

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

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

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

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

ტრიგერები

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

API ცნობარი

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