సహాయం
లాగిన్

Admin API అభ్యర్థనను పంపండి

Flowలో యాక్షన్‌ల వలె ఇంకా అందుబాటులో లేని మ్యుటేషన్‌లతో సహా మీ స్టోర్‌లో మార్పులు చేయడానికి Admin API అభ్యర్థనను పంపండి యాక్షన్ GraphQL Admin APIలోని చాలా మ్యుటేషన్‌లను ఉపయోగించవచ్చు.

ఈ పేజీలో

ఫీల్డ్‌లు

Admin API అభ్యర్థనను పంపండి యాక్షన్ కింది ఫీల్డ్‌లను కలిగి ఉంటుంది.

Admin API అభ్యర్థనను పంపండి యాక్షన్‌లో ఉపయోగించే ఫీల్డ్‌లు.
ఫీల్డ్వివరణ
మ్యుటేషన్అవసరం. మీరు కాల్ చేయాలనుకుంటున్న Shopify GraphQL అడ్మిన్ మ్యుటేషన్. ఒక మ్యుటేషన్ అనేది చర్య తీసుకునే లేదా డేటాను అప్‌డేట్ చేసే 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 చిట్కాలు

ఇన్‌పుట్‌ను రూపొందించడంలో ఉపయోగపడే json లిక్విడ్ ఫిల్టర్‌కు Flow మద్దతు ఇస్తుంది. కింది ఉదాహరణలన్నీ 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!",
  }
}

అరేలతో (arrays) పని చేయడం

అరే ఉదాహరణ

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 వెర్షన్‌లు రిలీజ్ అయినప్పుడు, మార్చబడిన లేదా విస్మరించబడిన మ్యుటేషన్ లేదా ఫీల్డ్‌ని ఉపయోగిస్తే ఈ చర్య విఫలం కావచ్చు.
  • ఈ చర్య GraphQL క్వెరీలకు మద్దతు ఇవ్వదు, మ్యుటేషన్‌లకు మాత్రమే మద్దతు ఇస్తుంది.
  • విస్మరించబడిన మ్యుటేషన్‌లకు ఈ చర్య మద్దతు ఇవ్వదు.
  • కొన్ని సబ్‌స్క్రిప్షన్, మార్కెటింగ్ యాక్టివిటీ మరియు తగ్గింపు మ్యుటేషన్‌లతో సహా నిర్దిష్ట యాప్‌లకు ప్రత్యేకమైన కొన్ని మ్యుటేషన్‌లకు ఈ చర్య మద్దతు ఇవ్వదు.
  • ఎసిన్క్రోనస్ (asynchronous) మ్యుటేషన్‌లు లేదా Job రకాన్ని తిరిగి ఇచ్చే మ్యుటేషన్‌లకు ఈ చర్య మద్దతు ఇవ్వదు.
  • నోడ్ ఇంటర్‌ఫేస్‌ను అమలు చేయని మ్యుటేషన్‌లకు ఈ చర్య మద్దతు ఇవ్వదు.

టెంప్లేట్‌లు

కొత్త ఆర్డర్‌లకు ఉచిత (100% తగ్గింపుతో) ఐటెమ్‌ను జోడించండి

ఒకవేళ ఐటెమ్ స్టాక్‌లో ఉంటే, ఈ టెంప్లేట్ కొత్త ఆర్డర్‌లకు ఉచిత, తగ్గింపు గల ఐటెమ్‌ను జోడిస్తుంది. ఇది ఇన్వెంటరీని చెక్ చేస్తుంది, 100% తగ్గింపును వర్తింపజేస్తుంది మరియు కస్టమర్‌కు తెలియజేయకుండానే ఆర్డర్‌ను అప్‌డేట్ చేస్తుంది. ఈ ఆటోమేషన్ (1) కస్టమర్ ఆర్డర్‌లో ఉచిత ఐటెమ్‌ను ఆశ్చర్యకరంగా అందించడం ద్వారా కస్టమర్ సంతృప్తిని మెరుగుపరచడానికి, (2) కొత్త లేదా తక్కువగా తెలిసిన ఉత్పత్తులను ఆర్డర్‌లలో ఉచిత శాంపిల్స్‌గా జోడించడం ద్వారా వాటిని ప్రమోట్ చేయడానికి, లేదా (3) ఉచిత ఐటెమ్‌ల చేరిక మరియు తగ్గింపును ఆటోమేట్ చేయడం ద్వారా ప్రమోషన్‌లను క్రమబద్ధీకరించడానికి ఉపయోగపడుతుంది. టెంప్లేట్‌ను వీక్షించండి

కంపెనీ అకౌంట్ అభ్యర్థనల ద్వారా క్రియేట్ చేయబడిన కంపెనీల కోసం ఆర్డర్ చేయడాన్ని అనుమతించండి

కంపెనీ అకౌంట్ అభ్యర్థన ద్వారా కంపెనీ క్రియేట్ చేయబడినప్పుడు ఆర్డర్ చేసే అనుమతిని కేటాయించండి. టెంప్లేట్‌ను వీక్షించండి

వేరియంట్‌లు స్టాక్‌లో లేనప్పుడు లేదా తిరిగి స్టాక్‌లోకి వచ్చినప్పుడు ఉత్పత్తి టెంప్లేట్‌ను మార్చండి

ఉత్పత్తి వేరియంట్‌ల ఇన్వెంటరీ ఆధారంగా ఉత్పత్తి టెంప్లేట్‌ను అప్‌డేట్ చేయండి. స్టాక్‌లో ఉన్నప్పుడు (స్టోర్ ఆటోమేటిక్ టెంప్లేట్), స్టాక్‌లో లేనప్పుడు మరియు ఒకటి లేదా అంతకంటే ఎక్కువ వేరియంట్‌లు స్టాక్‌లో లేనప్పుడు వర్క్‌ఫ్లో మిమ్మల్ని టెంప్లేట్‌ల మధ్య మారడానికి అనుమతిస్తుంది. టెంప్లేట్‌ను వీక్షించండి

ఆర్డర్‌లోని ఏవైనా డిజిటల్ ఐటెమ్‌లను నెరవేర్చండి

డిజిటల్ ఐటెమ్‌ల వలె లేదా SKUల జాబితాతో సరిపోలే భౌతిక డెలివరీ అవసరం లేని ఏవైనా ఐటెమ్‌లను ఇది నెరవేరుస్తుంది. కొత్త ఆర్డర్ కోసం ప్రతి ఫుల్‌ఫిల్‌మెంట్ లొకేషన్ ('ఫుల్‌ఫిల్‌మెంట్ ఆర్డర్') కోసం ఒక్కసారి రన్ అవుతుంది. టెంప్లేట్‌ను వీక్షించండి