Shopify Flow અને GraphQL Admin API

Shopify ઍડમિનને વિસ્તારવા અને બહેતર બનાવવા માટે ઑટોમેશન્સ અને ઇન્ટિગ્રેશન્સ બનાવવા માટે Flow Shopify GraphQL Admin API નો ઉપયોગ કરે છે. Flow વર્કફ્લોમાં શરતો અને વેરિયેબલ્સનું મૂલ્યાંકન કરવા તેમજ તમારા Shopify સ્ટોરમાં ઍક્શન્સ લેવા માટે API ના 2026-01 વર્ઝનનો ઉપયોગ કરે છે. Flow API ને કૉલ કરીને સ્ટોરના ડેટાને ઍક્સેસ કરતું હોવાથી, તમારી પાસે Flow માંથી API માં ઉપલબ્ધ લગભગ તમામ ફીલ્ડ્સનું ઍક્સેસ હોય છે.

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 માં લગભગ તમામ ફીલ્ડનો ઍક્સેસ છે. જો કોઈ ઍક્શન પાસે ટ્રિગર અથવા ડેટા મેળવો (Get data) ઍક્શન દ્વારા પ્રદાન કરવામાં આવેલ જરૂરી ડેટા ન હોય, તો વર્કફ્લો રન થતો નથી અને એક ભૂલનો મેસેજ પ્રદર્શિત થાય છે.

ઉદાહરણ તરીકે, વર્કફ્લો ગ્રાહક બનાવવામાં આવ્યો છે (Customer created) ટ્રિગરથી શરૂ થાય છે અને વર્કફ્લોમાં ગ્રાહક ડેટા ઇમ્પોર્ટ કરે છે. જો તે ટ્રિગર પછી ઑર્ડર ટૅગ ઉમેરો ઍક્શન આવે છે, જેમાં ગ્રાહક ડેટાને બદલે ઑર્ડર ડેટાની જરૂર હોય છે, તો વર્કફ્લોમાં મિસિંગ ડેટાની ભૂલ આવશે.

API દ્વારા શું આઉટપુટ આપવામાં આવે છે અને Flow માં શાનો ઉપયોગ થાય છે તે સમજવા માટે, અને તમારો વર્કફ્લો તમે અપેક્ષા રાખો છો તેવો જ ડેટા આઉટપુટ કરે છે તેની ખાતરી કરવા માટે તમારે ડેટાનું પૂર્વાવલોકન કરવાની અથવા API દસ્તાવેજીકરણ નો રિવ્યૂ કરવાની જરૂર પડી શકે છે.

ફીલ્ડ આર્ગ્યુમેન્ટ અને GraphQL Admin API

કેટલાક GraphQL Admin API ફીલ્ડમાં આર્ગ્યુમેન્ટની જરૂર પડે છે, આ એવા વધારાના પૅરામીટર છે જે કયો ડેટા પરત કરવામાં આવ્યો છે તેને મર્યાદિત કરે છે. ઉદાહરણ તરીકે, product.inCollection ફીલ્ડને કયું કલેક્શન ચેક કરવાનું છે તે જાણવા માટે કલેક્શન id આર્ગ્યુમેન્ટની જરૂર પડે છે. તેના વગર, ફીલ્ડ પરિણામ પરત કરી શકતું નથી.

Flow માં, તમે જરૂરી આર્ગ્યુમેન્ટ મૂલ્ય પ્રદાન કરીને આ ફીલ્ડમાંથી વેરિએબલ બનાવી શકો છો, જેનો પછીથી વર્કફ્લોમાં ઉપયોગ કરી શકાય છે. તમે આગળનાં પગલાંઓમાં સંદર્ભ લેવાનું સરળ બનાવવા માટે વેરિએબલને કસ્ટમ નામ પણ અસાઇન કરી શકો છો, ઉદાહરણ તરીકે, product.inCollection(id: "gid://shopify/Collection/123456") ને product.inSummerBestsellers તરીકે નામ આપવું.

આર્ગ્યુમેન્ટવાળા ફીલ્ડમાંથી વેરિએબલ બનાવવા વિશે વધુ જાણો.

મેટાફીલ્ડ્સમાંથી વેરિએબલ બનાવવા માટે Flow માં વધારાની માહિતીની જરૂર પડે છે કારણ કે તમે દરેક મેટાફીલ્ડની નેમસ્પેસ અને કી જાતે વ્યાખ્યાયિત કરો છો, તેથી આર્ગ્યુમેન્ટ હંમેશાં તમારા સ્ટોર માટે અજોડ હોય છે. Flow માં મેટાફીલ્ડ્સ વિશે વધુ જાણો.

API વર્ઝનિંગ

Shopify દર 3 મહિને નવાં API વર્ઝન રિલીઝ કરે છે અને Flow શક્ય તેટલી વહેલી તકે નવાં વર્ઝન અપનાવે છે, પરંતુ કદાચ લેટેસ્ટ વર્ઝન કરતાં પાછળ રહી શકે છે. જ્યારે પણ શક્ય હોય, ત્યારે વર્ઝન વચ્ચેના ફેરફારો ઑટોમૅટિક રીતે ઉકેલવામાં આવે છે, પરંતુ કેટલાક ફેરફારો કદાચ સીધા જ ન પણ હોય, જેમાં નીચેની કોઈપણ પરિસ્થિતિઓ શામેલ છે:

• જ્યારે ફીલ્ડ હટાવવામાં આવે છે પરંતુ તેના બદલે કંઈ આપવામાં આવતું નથી, ત્યારે તે સંભવિતપણે શરતો અથવા Liquid નું મૂલ્યાંકન કેવી રીતે કરવામાં આવે છે તેને અસર કરી શકે છે.
• જ્યારે ફીલ્ડ નલેબલ (nullable) બની જાય છે, ત્યારે સંભવિતપણે શરતો અથવા Liquid નું મૂલ્યાંકન કેવી રીતે કરવામાં આવે છે તેને અસર કરી શકે છે.
• જ્યારે enum મૂલ્યો બદલાય છે અથવા નવા યુનિયન કે ઇન્ટરફેસના પ્રકારો ઉમેરવામાં આવે છે, ત્યારે તે સંભવિતપણે Liquid અથવા કોડને અસર કરી શકે છે.
• જ્યારે મ્યુટેશન આર્ગ્યુમેન્ટ બદલાય છે, ત્યારે તે સંભવિતપણે Admin API વિનંતી મોકલો (Send Admin API request) ઍક્શનના કન્ફિગરેશનને અસર કરી શકે છે.

કેટલાક વર્કફ્લોને મૅન્યુઅલી અપડેટ કરવાની જરૂર પડી શકે છે. આવા કિસ્સામાં, વર્કફ્લો કદાચ અપડેટ જરૂરી છે (Update required) અથવા અસમર્થિત API (Unsupported API) ની ભૂલ પ્રદર્શિત કરી શકે છે અને વર્કફ્લો ઍડિટરમાં જરૂરી ફેરફાર કરવા માટે તમને સંબંધિત API દસ્તાવેજીકરણ માટે માર્ગદર્શન આપે છે. જ્યારે આ અપડેટ પૂર્ણ થઈ જાય છે અને સેવ કરવામાં આવે છે, ત્યારે વર્કફ્લો Flow માં ઉપલબ્ધ લેટેસ્ટ API વર્ઝનનો ઉપયોગ કરવા માટે ઑટોમૅટિક રીતે અપડેટ થાય છે.

તમે API વર્ઝનની સુસંગતતાને લગતી ભૂલો ધરાવતા વર્કફ્લોમાં તાત્કાલિક ફેરફાર કરવા માટે હંગામી ધોરણે સમસ્યાઓને અવગણવાનું પસંદ કરી શકો છો. જો આ સમસ્યાઓનું નિવારણ કરવામાં આવતું નથી, તો જ્યારે Shopify દ્વારા જૂના API વર્ઝનનું સમર્થન કરવાનું બંધ કરવામાં આવશે ત્યારે વર્કફ્લો રન થવાનું બંધ થઈ શકે છે અથવા તેમાં ભૂલ આવી શકે છે.