Shopify Flow மற்றும் GraphQL Admin API

Shopify நிர்வாகியை விரிவுபடுத்தும் மற்றும் மேம்படுத்தும் தானியக்கமாக்கல்கள் மற்றும் ஒருங்கிணைப்புகளை உருவாக்க Flow, Shopify GraphQL Admin API-ஐப் பயன்படுத்துகிறது. பணிப்பாய்வுகளில் உள்ள நிபந்தனைகள் மற்றும் மாறிகளை மதிப்பிடவும், உங்கள் Shopify ஸ்டோரில் செயல்களை மேற்கொள்ளவும் Flow, API இன் 2026-01 பதிப்பைப் பயன்படுத்துகிறது. API-ஐ அழைப்பதன் மூலம் Flow ஸ்டோர் தரவை அணுகுவதால், API-இல் கிடைக்கும் கிட்டத்தட்ட அனைத்துப் புலங்களுக்கும் Flow-இலிருந்து நீங்கள் அணுகலைப் பெறுவீர்கள்.

Shopify ஒவ்வொரு 3 மாதங்களுக்கும் புதிய API பதிப்புகளை வெளியிடுவதால், புலங்கள் மாற்றப்படும்போது அல்லது வழக்கற்றுப் போகும்போது சில பணிப்பாய்வுகளைப் புதுப்பிக்க வேண்டியிருக்கலாம்.

பணிப்பாய்வுகளில் GraphQL Admin APIஐப் பயன்படுத்துதல்

Flow இல் உள்ள பெரும்பாலான செயல்கள் உங்கள் Shopify ஸ்டோரில் மாற்றங்களைச் செய்ய GraphQL Admin APIஐப் பயன்படுத்துகின்றன. எடுத்துக்காட்டாக, ஆர்டர் டேக்குகளைச் சேர் என்ற செயல் tagsAdd என்ற மியூடேஷனைப் பயன்படுத்துகிறது. Admin API கோரிக்கையை அனுப்பு என்ற செயல், Flow இல் இன்னும் செயல்களாகக் கிடைக்காதவை உட்பட பெரும்பாலான மியூடேஷன்களைப் பயன்படுத்தலாம்.

பணிப்பாய்வுகளை உருவாக்கும்போது, GraphQL Admin API தொடரியலின் அடிப்படையிலான புலப் பெயர்கள் மற்றும் விளக்கங்களை நீங்கள் அடிக்கடி சந்திப்பீர்கள். எடுத்துக்காட்டாக, ஒரு பணிப்பாய்வில் ஒரு மாறுபாட்டின் மொத்த விற்கக்கூடிய அளவைத் தீர்மானிக்க, variants_item.inventoryQuantity மாறியைப் பயன்படுத்துவீர்கள். மற்றொரு எடுத்துக்காட்டாக, உங்கள் மின்னஞ்சல் செய்திமடலுக்கு ஒரு வாடிக்கையாளர் எங்கு குழுசேர்ந்தார் என்பதைத் தீர்மானிக்க, நீங்கள் emailSubscriptionMethod மாறியைப் பயன்படுத்துவீர்கள்.

Flow செயலியைப் பயன்படுத்திப் பணிப்பாய்வுகளை உருவாக்க நீங்கள் APIஐ முழுமையாகத் தெரிந்துவைத்திருக்க வேண்டியதில்லை, ஆனால் மாறிப் பெயர்கள் மற்றும் அவற்றின் வரையறைகளைப் பற்றிச் சிறிது புரிந்துகொள்வது உங்களுக்குத் தேவையான குறிப்பிட்ட பணிப்பாய்வு தர்க்கத்தை உருவாக்க உதவும். எடுத்துக்காட்டாக, வாடிக்கையாளரின் displayName மற்றும் firstName ஆகியவற்றுக்கு இடையேயான வித்தியாசத்தைத் தெரிந்துகொள்வது, நீங்கள் எதற்காகப் பயன்படுத்துகிறீர்கள் என்பதைப் பொறுத்துச் சரியான தரவை அணுக உங்கள் பணிப்பாய்வுக்கு உதவும். நீங்கள் பணிப்பாய்வை உருவாக்கும்போதே ஒவ்வொரு மாறிக்குமான வரையறைகள் கொடுக்கப்பட்டிருக்கும், மேலும் ஏதேனும் மாறி அல்லது வரையறை குறித்து மேலும் அறிய என்பதைக் கிளிக் செய்யலாம்.

ஸ்டோர் தரவு மற்றும் GraphQL Admin API

பணிப்பாய்வுகள், நிபந்தனைகள் மற்றும் செயல்களில் உங்கள் ஸ்டோரின் தரவைப் பயன்படுத்துகின்றன. Flow ஆனது GraphQL Admin APIஐப் பயன்படுத்தி ஸ்டோர் தரவை அணுகுகிறது, அதாவது API இல் உள்ள ஏறக்குறைய அனைத்துப் புலங்களுக்கும் உங்களுக்கு அணுகல் கிடைக்கும். ஒரு செயலுக்கு, ஒரு தூண்டுதல் மூலமாகவோ தரவைப் பெறுதல் செயலின் மூலமாகவோ தேவையான தரவு வழங்கப்படவில்லை என்றால், பணிப்பாய்வு இயங்காது மற்றும் ஒரு பிழைச் செய்தி காட்டப்படும்.

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

API மூலம் எது வெளியிடப்பட்டு Flow இல் பயன்படுத்தப்படுகிறது என்பதைப் புரிந்துகொள்ளவும், உங்கள் பணிப்பாய்வு நீங்கள் எதிர்பார்க்கும் தரவை வெளியிடுகிறதா என்பதை உறுதிப்படுத்தவும், நீங்கள் தரவை முன்னோட்டம் பார்க்க அல்லது API ஆவணங்களை மதிப்பாய்வு செய்ய வேண்டியிருக்கலாம்.

புலத்தின் அளபுருக்கள் (Arguments) மற்றும் GraphQL Admin API

சில GraphQL Admin API புலங்களுக்கு அளபுருக்கள் (arguments) தேவைப்படுகின்றன, இவை எந்தத் தரவு வழங்கப்படுகிறது என்பதைச் சுருக்கித் தரும் கூடுதல் அளவுருக்களாகும். எடுத்துக்காட்டாக, product.inCollection புலத்திற்கு எந்தச் சேகரிப்பைச் சரிபார்க்க வேண்டும் என்பதை அறிய, சேகரிப்பு id அளபுரு தேவை. அது இல்லாமல், இந்தப்புலத்தால் ஒரு முடிவை வழங்க முடியாது.

Flow இல், தேவையான அளபுருவின் மதிப்பை வழங்குவதன் மூலம் இந்தப் புலங்களிலிருந்து நீங்கள் மாறிகளை உருவாக்கலாம், அவற்றை அதன் பிறகு பணிப்பாய்வில் பயன்படுத்தலாம். அடுத்தடுத்த படிகளில் குறிப்பிடுவதை எளிதாக்கும் வகையில், மாறிக்கு ஒரு தனிப்பயன் பெயரையும் நீங்கள் ஒதுக்கலாம், எடுத்துக்காட்டாக, product.inCollection(id: "gid://shopify/Collection/123456") என்பதற்கு product.inSummerBestsellers எனப் பெயரிடலாம்.

அளபுருக்கள் கொண்ட புலங்களில் இருந்து மாறிகளை உருவாக்குவது குறித்து மேலும் அறிக.

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

API பதிப்பாக்கம்

Shopify ஒவ்வொரு 3 மாதங்களுக்கும் புதிய API பதிப்புகளை வெளியிடுகிறது மற்றும் Flow கூடிய விரைவில் புதிய பதிப்புகளைப் பயன்படுத்துகிறது, ஆனால் இது சமீபத்திய பதிப்பை விடப் பின் தங்கியிருக்கலாம். சாத்தியமான இடங்களில், பதிப்புகளுக்கு இடையிலான மாற்றங்கள் தானாகவே தீர்க்கப்படும், ஆனால் பின்வரும் சூழ்நிலைகள் ஏதேனும் உட்பட சில மாற்றங்கள் நேரடியாக இருக்காது:

• புலங்கள் அகற்றப்பட்டு, அவற்றுக்குப் பதிலாக எதுவும் வழங்கப்படாதபோது, அது நிபந்தனைகள் அல்லது Liquid மதிப்பிடப்படும் விதத்தைப் பாதிக்கலாம்.
• புலங்களில் Null மதிப்பை ஏற்கமுடிந்தால், அது நிபந்தனைகள் அல்லது Liquid மதிப்பிடப்படும் விதத்தைப் பாதிக்கலாம்.
• Enum மதிப்புகள் மாறும்போது அல்லது புதிய union அல்லது இடைமுக வகைகள் சேர்க்கப்படும்போது, அது Liquid அல்லது குறியீட்டைப் பாதிக்கலாம்.
• மியூடேஷன் அளபுருக்கள் மாறும்போது, அது Admin API கோரிக்கையை அனுப்பு என்ற செயல்களின் உள்ளமைவைப் பாதிக்கலாம்.

சில பணிப்பாய்வுகளை மனித முயற்சியால் புதுப்பிக்க வேண்டியிருக்கலாம். இந்தச் சந்தர்ப்பங்களில், பணிப்பாய்வுகள் புதுப்பிப்பு தேவை அல்லது ஆதரிக்கப்படாத API என்ற பிழையைக் காட்டலாம், மேலும் பணிப்பாய்வு எடிட்டரில் தேவையான மாற்றங்களைச் செய்ய உங்களைப் பொருத்தமான API ஆவணங்களுக்கு வழிநடத்தலாம். இந்தப் புதுப்பிப்புகள் முடிந்து சேமிக்கப்பட்டதும், Flow இல் கிடைக்கும் சமீபத்திய API பதிப்பைப் பயன்படுத்த, பணிப்பாய்வு தானாகவே புதுப்பிக்கப்படும்.

API பதிப்பு இணக்கத்தன்மைப் பிழைகள் கொண்ட ஒரு பணிப்பாய்வில் அவசர மாற்றங்களைச் செய்ய, நீங்கள் சிக்கல்களைத் தற்காலிகமாகப் புறக்கணிக்கத் தேர்வுசெய்யலாம். இந்தச் சிக்கல்கள் சரிசெய்யப்படாவிட்டால், பழைய API பதிப்பை Shopify ஆதரிக்காதபோது பணிப்பாய்வு இயங்குவதை நிறுத்தலாம் அல்லது பிழைகளை ஏற்படுத்தலாம்.