உதவி
உள்நுழை

சேகரிப்புத் தரவைப் பெறு

சேகரிப்புத் தரவு தேவைப்படும் பணிப்பாய்வுகளில், உங்கள் ஸ்டோரிலிருந்து சேகரிப்புத் தகவலை மீட்டெடுக்க சேகரிப்புத் தரவைப் பெறு (Get collection data) செயலைப் பயன்படுத்தலாம்.

இந்தப் பக்கத்தில்

கட்டமைப்பு

புலங்கள்

சேகரிப்புத் தரவைப் பெறு (Get collection data) செயலானது பின்வரும் புலங்களைக் கொண்டுள்ளது.

தரவைப் பெறு (Get data) செயல்களில் பயன்படுத்தப்படும் புலங்கள்.
புலம்விளக்கம்
தரவை இதன்படி வரிசைப்படுத்துகட்டாயமானது. தேடல் வினவல் மூலம் திரும்பப் பெறப்படும் தரவை வரிசைப்படுத்தும் அளவுருக்கள்.
அதிகபட்ச முடிவுகளின் எண்ணிக்கைகட்டாயமானது. நீங்கள் தேர்ந்தெடுக்கும் தேடல் வினவல் மூலம் திரும்பப் பெறக்கூடிய அதிகபட்ச முடிவுகளின் அளவு. ஒரே நேரத்தில் 100 முடிவுகள் வரை நீங்கள் திரும்பப் பெறலாம்.
வினவல்கட்டாயமானது. பொதுவான வினவல்களிலிருந்து தேர்வுசெய்யவும் அல்லது உங்களுக்கான சொந்த வினவலை உருவாக்க, மேம்பட்டவை (Advanced) என்பதைத் தேர்ந்தெடுக்கவும்.

வினவல் சரம்

கடந்த நாளில் புதுப்பிக்கப்பட்ட சேகரிப்புகளைப் பெறுவதற்கான ஒரு எடுத்துக்காட்டு வினவல் இது:

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

updated_at மாறியானது தொகுப்புகள் வினவலில் கிடைக்கும் வடிப்பானாகும், இதைப் பலமுறை பயன்படுத்தலாம் அல்லது பிற மாறிகளுடன் இணைத்துப் பயன்படுத்தலாம். திட்டமிடப்பட்ட நேரம் (Scheduled time) தூண்டுதலைப் பயன்படுத்திய பணிப்பாய்வுகளில் scheduledAt Liquid மாறி கிடைக்கும். தேதியிலிருந்து நேரத்தைக் கழிக்க date_minus Liquid டேக் உங்களை அனுமதிக்கிறது, இதுவொரு சிறப்பு Flow டேக் ஆகும்.

தரவை வினவும்போது, பின்வருவனவற்றைத் தெரிந்துகொள்வது உதவியாக இருக்கும்:

  • கிடைக்கக்கூடிய சேகரிப்பு வடிப்பான்களின் பட்டியல்
  • வினவல் புல மதிப்புகள் எப்போதும் ஆவணப்படுத்தப்படுவதில்லை. சில சமயங்களில், API ஆவணங்களைச் சரிபார்ப்பதன் மூலம் மதிப்புகளைக் கண்டறியலாம். மாற்றாக, நீங்கள் வடிகட்டும்போது நிர்வாகியில் உள்ள URL-களில் புல மதிப்புகளை அடிக்கடி கண்டறியலாம். உதாரணமாக, சில ஆர்டர் வினவல் மதிப்புகளைக் கண்டறிய, நிர்வாகியில் உள்ள ஆர்டர்கள் பக்கத்தை வடிகட்டி, பிறகு URL-ஐச் சரிபார்க்கவும்.
  • உங்கள் ஸ்டோரில் Shopify GraphiQL செயலியைப் பயன்படுத்தி, ஒரு வினவலை ரன் செய்யலாம் அல்லது சோதிக்கலாம்.
  • உங்கள் வினவல் தோல்வியடைந்தால் என்ன நடக்கும் என்பதைக் கவனத்தில் கொள்ளவும். பெரும்பாலும் API எந்த முடிவையும் வழங்காமல் இருப்பதற்குப் பதிலாக, எல்லா முடிவுகளையும் வழங்கும்.

திரும்பப் பெறப்பட்ட தரவு

எல்லா தரவைப் பெறு (Get data) செயல்களும் 0 முதல் 100 ஆதாரங்கள் வரையிலான பட்டியலை வழங்கும். உங்களின் பயன்பாட்டு வகையைப் பொறுத்து, இந்தத் தரவைப் பல்வேறு வழிகளில் நீங்கள் பயன்படுத்த விரும்பலாம்:

  • ஒவ்வொரு பட்டியல் உருப்படியையும் தனித்தனியாகக் கையாள வேண்டும் (உதாரணமாக, ஒவ்வொன்றுக்கும் ஒரு டேக்கைச் சேர்ப்பது) எனில், நீங்கள் ஃபார் ஈச் (For each) செயலைப் பயன்படுத்தலாம்.
  • தரவை ஒருங்கிணைக்க வேண்டும் (உதாரணமாக எத்தனை முடிவுகள் பெறப்பட்டன என்பதைக் கணக்கிடுவது) எனில், நீங்கள் கணக்கீடு (Count) அல்லது கூடுதல் (Sum) செயல்களைப் பயன்படுத்தலாம்.
  • பட்டியலை வெளியிட வேண்டும் (உதாரணமாக எல்லா உருப்படிகளையும் சேர்த்து மின்னஞ்சல் அனுப்புவது) எனில், அடுத்தடுத்த செயல்களில் திரும்பப் பெறப்பட்ட தரவை நேரடியாகப் பயன்படுத்தலாம்.

இந்தச் செயலைப் பின்தொடரும் படிகளில் திரும்பப் பெறப்பட்ட தரவை அணுக, சேகரிப்புத் தரவைப் பெறு (Get collection data) எனப் பெயரிடப்பட்ட மாறியைப் பயன்படுத்தவும், இது சேகரிப்புகளின் பட்டியலாகும். நிபந்தனைகள், செயல்கள் இரண்டிலும் இந்த மாறியைப் பயன்படுத்தலாம். உதாரணமாக, இது போன்ற உள் மின்னஞ்சலை அனுப்பு (Send internal email) செயலில் சேகரிப்புகளின் பட்டியலை அனுப்பலாம்:

{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

தூண்டுதல்கள்

நீங்கள் இந்தச் செயலை Scheduled time தூண்டுதல் உட்பட எந்தவொரு பணிப்பாய்விலும் பயன்படுத்தலாம். Scheduled time தூண்டுதலைப் பயன்படுத்தும் பணிப்பாய்வில், பணிப்பாய்வானது ஒரு நிகழ்வின் முடிவாக இல்லாமல், நீங்கள் குறிப்பிட்ட நேரத்தில் தொடங்கும். உங்கள் ஸ்டோரிலோ செயலியிலோ பணிப்பாய்வைத் தொடங்கும் குறிப்பிட்ட நிகழ்வு எதுவும் இல்லாததால், தரவு எதுவும் தானாகவே சேர்க்கப்படாது.

API குறிப்பு