Admin API विनंती पाठवा

तुमच्या स्टोअरमध्ये बदल करण्यासाठी Admin API विनंती पाठवा कृती GraphQL Admin API मधील बहुतांश म्युटेशन्स वापरू शकते, ज्यामध्ये Flow मध्ये कृती म्हणून अद्याप उपलब्ध नसलेल्या म्युटेशन्सचा समावेश आहे.

फील्ड्स

Admin API विनंती पाठवा कृतीमध्ये खालील फील्ड्स समाविष्ट असतात.

Admin API विनंती पाठवा कृतीमध्ये वापरलेली फील्ड्स.

फील्ड	वर्णन
म्युटेशन	आवश्यक आहे. तुम्हाला कॉल करायचे असलेले Shopify GraphQL Admin म्युटेशन. म्युटेशन हे एक API आहे, जे कारवाई करते किंवा डेटा अपडेट करते.
म्युटेशन इनपुट्स	आवश्यक आहे. तुमच्या म्युटेशन विनंतीचा भाग म्हणून तुम्हाला जो डेटा (JSON मध्ये) पाठवणे आवश्यक आहे. प्रत्येक म्युटेशनला एका वेगळ्या डेटा सेटची आवश्यकता असते, जो प्रत्येक म्युटेशनसाठी प्रदान केलेल्या लिंकमध्ये दस्तऐवजीकरण केलेला असतो. आवश्यक JSON तयार करण्यासाठी, तुम्ही Liquid किंवा Run code कृती वापरू शकता.

ट्रिगर्स

जोपर्यंत वर्कफ्लो म्युटेशन इनपुट्स तयार करण्यासाठी आवश्यक डेटा प्रदान करत आहे, तोपर्यंत Admin API विनंती पाठवा ही कृती कोणत्याही ट्रिगरसह कोणत्याही वर्कफ्लोमध्ये वापरली जाऊ शकते.

उदाहरणे

उदाहरण 1: उत्पादनासाठी वापरलेले टेम्पलेट अपडेट करा

या उदाहरणामध्ये, उत्पादनासाठी वापरलेले टेम्पलेट अपडेट करण्यासाठी productUpdate म्युटेशनला कॉल करण्यासाठी आम्ही Admin API विनंती पाठवा कृती वापरू.

id फील्ड आवश्यक आहे आणि ते एक वैध उत्पादन GID असले पाहिजे. येथे, आम्ही ते {{product.id}} लिक्विड व्हेरिएबलसह सेट केले आहे. याचा अर्थ असा गृहित धरला जातो की तुमच्या वर्कफ्लोमध्ये एक ट्रिगर आहे जो उत्पादन ऑब्जेक्ट प्रदान करतो.

templateSuffix हे तुम्हाला उत्पादनावर लागू करायच्या असलेल्या टेम्पलेटचे नाव आहे. उदाहरणार्थ, तुम्हाला pre-order (प्री-ऑर्डर) टेम्पलेट लागू करायचे असल्यास, तुम्ही templateSuffix हे pre-order वर सेट कराल.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

उदाहरण 2: ग्राहकाचे कर सूट स्टेटस अपडेट करा

या उदाहरणामध्ये, ग्राहकाचे कर सूट स्टेटस अपडेट करण्यासाठी customerUpdate म्युटेशनला कॉल करण्यासाठी आम्ही Admin API विनंती पाठवा कृती वापरू.

id फील्ड आवश्यक आहे आणि ते एक वैध ग्राहक GID असले पाहिजे. येथे, आम्ही ते {{order.customer.id}} लिक्विड व्हेरिएबलसह सेट केले आहे. याचा अर्थ असा गृहित धरला जातो की तुमच्या वर्कफ्लोमध्ये एक ट्रिगर आहे जो ऑर्डर ऑब्जेक्ट प्रदान करतो.

taxExempt फील्ड हे एक बुलियन आहे जे ग्राहकाला कर सूट आहे की नाही हे दर्शवते. या उदाहरणामध्ये, आम्ही ते true वर सेट केले आहे.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

उदाहरण 3: ग्राहकाचे लोकॅल अपडेट करा

या उदाहरणामध्ये, ग्राहकाचे लोकॅल अपडेट करण्यासाठी customerUpdate म्युटेशनला कॉल करण्यासाठी आम्ही Admin API विनंती पाठवा कृती वापरू.

id फील्ड आवश्यक आहे आणि ते एक वैध ग्राहक GID असले पाहिजे. येथे, आम्ही ते {{customer.id}} लिक्विड व्हेरिएबलसह सेट केले आहे. याचा अर्थ असा गृहित धरला जातो की तुमच्या वर्कफ्लोमध्ये एक ट्रिगर आहे जो ग्राहक ऑब्जेक्ट प्रदान करतो.

locale फील्ड ही एक स्ट्रिंग आहे जी ग्राहकाचे लोकॅल दर्शवते. या उदाहरणामध्ये, आम्ही ते en वर सेट केले आहे.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Liquid टिप्स

Flow एका json लिक्विड फिल्टरला सपोर्ट करतो जो इनपुट तयार करण्यात उपयुक्त ठरू शकतो. खालील सर्व उदाहरणे customerUpdate म्युटेशन वापरतात आणि तुमच्या वर्कफ्लोमध्ये असा एक ट्रिगर आहे जो ग्राहक ऑब्जेक्ट प्रदान करतो असे गृहीत धरतात.

स्ट्रिंग्जसह काम करणे

खालील उदाहरण ग्राहकावरील नोंद अपडेट करते:

{% assign revisedNote = customer.note | append: " Hello from Flow!" %}

{
  "input": {
    "id": "{{ customer.id }}",
    "note": {{ revisedNote | json }},
  }
}

योग्य JSON सुनिश्चित करण्यासाठी json फिल्टर स्ट्रिंगला एस्केप करतो. वर्कफ्लो रन झाल्यानंतर याचा परिणाम खालील JSON मध्ये होतो:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "note": "Had a \"great experience\" with their latest order. Hello from Flow!",
  }
}

अ‍ॅरेजसह काम करणे

अ‍ॅरेचे उदाहरण

json फिल्टर लिक्विड अ‍ॅरेचे एका JSON अ‍ॅरेमध्ये रूपांतर करतो. लिक्विड अ‍ॅरे प्रदान केल्यावर खालील उदाहरण JSON अ‍ॅरे आउटपुट करते:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ tags | json }}
  }
}

वर्कफ्लो रन झाल्यानंतर याचा परिणाम खालील JSON मध्ये होतो:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["tag1","tag2","tag3"]
  }
}

For लूपचे उदाहरण

खालील उदाहरण अ‍ॅरेचे घटक स्वल्पविरामांनी विभक्त करून आउटपुट करण्यासाठी लूप वापरते:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": [
      {% for tag in tags %}
        "{{ tag }}"{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
}

जेव्हा वर्कफ्लो रन होतो तेव्हा याचा परिणाम खालील JSON मध्ये होतो:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": [
        "tag1",
        "tag2",
        "tag3"
    ]
  }
}

मॅपचे उदाहरण

ऑब्जेक्ट्सच्या अ‍ॅरेमधून विशिष्ट प्रॉपर्टीचा अ‍ॅरे मिळवण्यासाठी map फिल्टर वापरला जाऊ शकतो. खालील उदाहरणामध्ये, ग्राहक पत्त्यांच्या अ‍ॅरेमधून city प्रॉपर्टीजचा एक अ‍ॅरे एक्सट्रॅक्ट केला जातो:

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ customer.addresses | map: "city" | json }}
  }
}

वर्कफ्लो रन झाल्यानंतर याचा परिणाम खालील JSON मध्ये होतो:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["Ottawa","Toronto"]
  }
}

मर्यादा

Admin API विनंती पाठवा कृतीला खालील मर्यादा आहेत:

• ही कृती Flow ने वापरलेल्या Admin API आवृत्तीमधील Mutations आणि Mutation inputs ची सूची प्रदर्शित करेल.
• जेव्हा नवीन API आवृत्त्या प्रकाशित केल्या जातात, तेव्हा या कृतीने बदललेले किंवा नाकारलेले (deprecated) म्युटेशन किंवा फील्ड वापरल्यास ती अयशस्वी होऊ शकते.
• ही कृती GraphQL क्वेरीजना सपोर्ट करत नाही, ती केवळ म्युटेशन्सना सपोर्ट करते.
• ही कृती नाकारण्यात आलेल्या (deprecated) म्युटेशन्सना सपोर्ट करत नाही.
• ही कृती विशिष्ट अ‍ॅप्ससाठी असणाऱ्या काही म्युटेशन्सना सपोर्ट करत नाही, ज्यामध्ये काही सबस्क्रिप्शन, मार्केटिंग अ‍ॅक्टिव्हिटी आणि सवलत म्युटेशन्स समाविष्ट आहेत.
• ही कृती असिंक्रोनस म्युटेशन्स किंवा Job प्रकार रिटर्न करणाऱ्या म्युटेशन्सना सपोर्ट करत नाही.
• ही कृती अशा म्युटेशन्सना सपोर्ट करत नाही, जे नोड इंटरफेस कार्यान्वित करत नाहीत.

टेम्पलेट्स

नवीन ऑर्डर्समध्ये मोफत (100% सवलत असलेला) आयटम जोडा

जर आयटम स्टॉकमध्ये असेल, तर हे टेम्पलेट नवीन ऑर्डर्समध्ये एक मोफत, सवलत असलेला आयटम जोडते. ते इन्व्हेंटरी तपासते, 100% सवलत लागू करते आणि ग्राहकाला सूचित न करता ऑर्डर अपडेट करते. हे ऑटोमेशन यासाठी उपयुक्त ठरेल (1) ग्राहकांच्या ऑर्डरमध्ये सरप्राईज मोफत आयटम समाविष्ट करून त्यांचे समाधान वाढवण्यासाठी, (2) ऑर्डर्समध्ये मोफत सॅम्पल्स म्हणून नवीन किंवा कमी-परिचित उत्पादने जोडून त्यांची जाहिरात करण्यासाठी, किंवा (3) मोफत आयटम्स समाविष्ट करणे आणि त्यांना सवलत देणे स्वयंचलित करून प्रमोशन्स सुव्यवस्थित करण्यासाठी. टेम्पलेट पहा

कंपनी खाते विनंत्यांद्वारे तयार केलेल्या कंपन्यांसाठी ऑर्डर करण्याची अनुमती द्या

जेव्हा एखादी कंपनी कंपनी खाते विनंतीद्वारे तयार केली जाते, तेव्हा ऑर्डर करण्याची परवानगी नियुक्त करा. टेम्पलेट पहा

जेव्हा व्हेरिएंट्स स्टॉकमध्ये नसतात किंवा स्टॉकमध्ये परत येतात, तेव्हा उत्पादन टेम्पलेट बदला

उत्पादनाच्या व्हेरिएंट्सच्या इन्व्हेंटरीवर आधारित उत्पादन टेम्पलेट अपडेट करा. वर्कफ्लो तुम्हाला स्टॉकमधील (स्टोअरचे डीफॉल्ट टेम्पलेट), स्टॉकमध्ये नसलेले आणि जेव्हा एक किंवा अधिक व्हेरिएंट्स स्टॉकमध्ये नसतात तेव्हा टेम्पलेट्स दरम्यान स्विच करण्याची अनुमती देतो. टेम्पलेट पहा

ऑर्डरमधील कोणतेही डिजिटल आयटम्स पूर्ण करा

डिजिटल आयटम्स यांसारखे कोणतेही प्रत्यक्ष वितरण आवश्यक नसलेले किंवा SKU च्या सूचीशी जुळणारे कोणतेही आयटम्स पूर्ण करते. नवीन ऑर्डरसाठी प्रत्येक फुलफिलमेंट लोकेशनसाठी (“फुलफिलमेंट ऑर्डर”) एकदा रन होते. टेम्पलेट पहा