Admin API கோரிக்கையை அனுப்பு

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

புலங்கள்

Admin API கோரிக்கையை அனுப்பு செயல், பின்வரும் புலங்களைக் கொண்டுள்ளது.

'Admin API கோரிக்கையை அனுப்பு' செயலில் பயன்படுத்தப்படும் புலங்கள்.

புலம்	விளக்கம்
மியூடேஷன்	கட்டாயம். நீங்கள் அழைக்க விரும்பும் Shopify GraphQL Admin மியூடேஷன். மியூடேஷன் என்பது ஒரு செயலை மேற்கொள்ளும் அல்லது தரவைப் புதுப்பிக்கும் API ஆகும்.
மியூடேஷன் உள்ளீடுகள்	கட்டாயம். உங்கள் மியூடேஷன் கோரிக்கையின் ஒரு பகுதியாக நீங்கள் அனுப்ப வேண்டிய தரவு (JSON இல்). ஒவ்வொரு மியூடேஷனுக்கும் வெவ்வேறு தரவுத் தொகுப்பு தேவைப்படுகிறது, இது ஒவ்வொரு மியூடேஷனுக்கும் வழங்கப்பட்டுள்ள இணைப்பில் ஆவணப்படுத்தப்பட்டுள்ளது. தேவையான JSON-ஐ உருவாக்க, நீங்கள் Liquid அல்லது Run code செயலைப் பயன்படுத்தலாம்.

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

மியூடேஷன் உள்ளீடுகளை உருவாக்கத் தேவையான தரவைப் பணிப்பாய்வு வழங்கும் வரை, எந்தவொரு தூண்டுதலுடனும் எந்தப் பணிப்பாய்விலும் Send Admin API request செயலைப் பயன்படுத்தலாம்.

எடுத்துக்காட்டுகள்

எடுத்துக்காட்டு 1: தயாரிப்புக்கு பயன்படுத்தப்படும் வார்ப்புருவைப் புதுப்பித்தல்

இந்த எடுத்துக்காட்டில், ஒரு தயாரிப்புக்கு பயன்படுத்தப்படும் வார்ப்புருவைப் புதுப்பிக்க productUpdate மியூடேஷனை அழைக்க Send Admin API request செயலைப் பயன்படுத்துவோம்.

id புலம் கட்டாயமாகும், இது சரியான தயாரிப்பு GID ஆக இருக்க வேண்டும். இங்கே, இதை {{product.id}} Liquid மாறியைக் கொண்டு அமைக்கிறோம். தயாரிப்புப் பொருளை வழங்கும் தூண்டுதல் உங்கள் பணிப்பாய்வில் உள்ளது என்பதை இது கருதுகிறது.

templateSuffix என்பது தயாரிப்பிற்கு நீங்கள் பயன்படுத்த விரும்பும் வார்ப்புருவின் பெயராகும். எடுத்துக்காட்டாக, நீங்கள் pre-order வார்ப்புருவைப் பயன்படுத்த விரும்பினால், templateSuffix ஐ pre-order என அமைக்க வேண்டும்.

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

எடுத்துக்காட்டு 2: வாடிக்கையாளரின் வரி விலக்கு நிலையைப் புதுப்பித்தல்

இந்த எடுத்துக்காட்டில், வாடிக்கையாளரின் வரி விலக்கு நிலையைப் புதுப்பிக்க customerUpdate மியூடேஷனை அழைக்க Send Admin API request செயலைப் பயன்படுத்துவோம்.

id புலம் கட்டாயமாகும், இது சரியான வாடிக்கையாளர் GID ஆக இருக்க வேண்டும். இங்கே, இதை {{order.customer.id}} Liquid மாறியைக் கொண்டு அமைக்கிறோம். ஆர்டர் பொருளை வழங்கும் தூண்டுதல் உங்கள் பணிப்பாய்வில் உள்ளது என்பதை இது கருதுகிறது.

taxExempt புலம் என்பது வாடிக்கையாளருக்கு வரி விலக்கு உள்ளதா என்பதைக் குறிக்கும் ஒரு பூலியன் மதிப்பாகும். இந்த எடுத்துக்காட்டில், இதை true என அமைக்கிறோம்.

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

எடுத்துக்காட்டு 3: வாடிக்கையாளரின் வட்டாரத்தைப் புதுப்பித்தல்

இந்த எடுத்துக்காட்டில், வாடிக்கையாளரின் வட்டாரத்தைப் புதுப்பிக்க customerUpdate மியூடேஷனை அழைக்க Send Admin API request செயலைப் பயன்படுத்துவோம்.

id புலம் கட்டாயமாகும், இது சரியான வாடிக்கையாளர் GID ஆக இருக்க வேண்டும். இங்கே, இதை {{customer.id}} Liquid மாறியைக் கொண்டு அமைக்கிறோம். வாடிக்கையாளர் பொருளை வழங்கும் தூண்டுதல் உங்கள் பணிப்பாய்வில் உள்ளது என்பதை இது கருதுகிறது.

locale புலம் என்பது வாடிக்கையாளரின் வட்டாரத்தைக் குறிக்கும் ஒரு சரமாகும். இந்த எடுத்துக்காட்டில், இதை en என அமைக்கிறோம்.

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

Liquid உதவிக்குறிப்புகள்

உள்ளீட்டை உருவாக்குவதில் பயனுள்ளதாக இருக்கக்கூடிய json Liquid வடிப்பானை 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!",
  }
}

வரிசைகளுடன் செயல்படுதல்

வரிசைக்கான எடுத்துக்காட்டு

json வடிப்பான் Liquid வரிசையை JSON வரிசையாக மாற்றுகிறது. பின்வரும் எடுத்துக்காட்டு Liquid வரிசையுடன் வழங்கப்படும் போது 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 loop எடுத்துக்காட்டு

பின்வரும் எடுத்துக்காட்டு, காற்புள்ளிகளால் பிரிக்கப்பட்ட வரிசையின் கூறுகளை வெளியிடுவதற்கு ஒரு லூப்பைப் பயன்படுத்துகிறது:

{% 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 எடுத்துக்காட்டு

பொருள்களின் வரிசையிலிருந்து ஒரு குறிப்பிட்ட பண்பின் வரிசையைப் பெற map வடிப்பானைப் பயன்படுத்தலாம். பின்வரும் எடுத்துக்காட்டில், வாடிக்கையாளர் முகவரிகளின் வரிசையிலிருந்து city பண்புகளின் வரிசை பிரித்தெடுக்கப்படுகிறது:

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

இது பணிப்பாய்வு ரன் ஆன பிறகு பின்வரும் JSON-ஐ முடிவாகத் தருகிறது:

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

வரம்புகள்

Send Admin API request செயல் பின்வரும் வரம்புகளைக் கொண்டுள்ளது:

• Flow பயன்படுத்தும் Admin API பதிப்பிலிருந்து Mutations மற்றும் Mutation inputs ஆகியவற்றின் பட்டியலை இந்தச் செயல் காட்டும்.
• புதிய API பதிப்புகள் வெளியிடப்படும்போது, மாற்றப்பட்ட அல்லது வழக்கொழிந்த ஒரு மியூடேஷன் அல்லது புலத்தை இந்தச் செயல் பயன்படுத்தினால், அது தோல்வியடையலாம்.
• இந்தச் செயல் GraphQL வினவல்களை ஆதரிக்காது, மியூடேஷன்களை மட்டுமே ஆதரிக்கும்.
• வழக்கொழிந்த மியூடேஷன்களை இந்தச் செயல் ஆதரிக்காது.
• சில சந்தா, சந்தைப்படுத்தல் நடவடிக்கை மற்றும் தள்ளுபடி மியூடேஷன்கள் உட்பட சில குறிப்பிட்ட செயலிகளுக்கு உரித்தான மியூடேஷன்களை இந்தச் செயல் ஆதரிக்காது.
• இந்தச் செயல் ஒத்திசைவற்ற மியூடேஷன்களையோ Job வகையை வழங்கும் மியூடேஷன்களையோ ஆதரிக்காது.
• முனை இடைமுகத்தைச் செயல்படுத்தாத மியூடேஷன்களை இந்தச் செயல் ஆதரிக்காது.

வார்ப்புருக்கள்

புதிய ஆர்டர்களுக்கு இலவச (100% தள்ளுபடி செய்யப்பட்ட) உருப்படியைச் சேர்த்தல்

இந்த வார்ப்புரு, உருப்படி கையிருப்பில் இருந்தால், புதிய ஆர்டர்களில் தள்ளுபடி செய்யப்பட்ட இலவச உருப்படியைச் சேர்க்கிறது. இது சரக்கு இருப்பைச் சரிபார்த்து, 100% தள்ளுபடியைப் பயன்படுத்துகிறது, வாடிக்கையாளருக்குத் தெரிவிக்காமல் ஆர்டரைப் புதுப்பிக்கிறது. (1) வாடிக்கையாளரின் ஆர்டரில் எதிர்பாராத இலவச உருப்படியைச் சேர்த்து அவர்களின் மனநிறைவை அதிகரிக்க, (2) புதிய அல்லது அதிகம் அறியப்படாத தயாரிப்புகளை ஆர்டர்களில் இலவச மாதிரிகளாகச் சேர்த்து அவற்றை விளம்பரப்படுத்த அல்லது (3) இலவச உருப்படிகளைச் சேர்ப்பது மற்றும் தள்ளுபடி செய்வதைத் தானியக்கமாக்குவதன் மூலம் விளம்பரங்களைச் சீரமைக்க, இந்தத் தானியக்கமாக்கல் பயனுள்ளதாக இருக்கும். வார்ப்புருவைக் காண்க

நிறுவனக் கணக்குக் கோரிக்கைகள் மூலம் உருவாக்கப்பட்ட நிறுவனங்களுக்கு ஆர்டர் செய்ய அனுமதித்தல்

நிறுவனக் கணக்குக் கோரிக்கையால் ஒரு நிறுவனம் உருவாக்கப்படும்போது, ஆர்டர் செய்யும் அனுமதியை ஒதுக்குங்கள். வார்ப்புருவைக் காண்க

மாறுபாடுகள் கையிருப்பில் இல்லாதபோது அல்லது மீண்டும் கையிருப்புக்கு வரும்போது தயாரிப்பு வார்ப்புருவை மாற்றுதல்

தயாரிப்பின் மாறுபாடுகளுக்கான சரக்கு இருப்பின் அடிப்படையில் தயாரிப்பு வார்ப்புருவைப் புதுப்பிக்கலாம். கையிருப்பில் உள்ளவற்றுக்கும் (ஸ்டோரின் இயல்புநிலை வார்ப்புரு), கையிருப்பில் இல்லாதவற்றுக்கும், ஒன்று அல்லது அதற்கு மேற்பட்ட மாறுபாடுகள் கையிருப்பில் இல்லாதபோது ஆகியவற்றுக்கான வார்ப்புருக்களுக்கு இடையில் மாறுவதற்கு இந்தப் பணிப்பாய்வு உங்களை அனுமதிக்கிறது. வார்ப்புருவைக் காண்க

ஆர்டரில் உள்ள ஏதேனும் டிஜிட்டல் உருப்படிகளை நிறைவேற்றுதல்

டிஜிட்டல் உருப்படிகள் போன்ற நேரடி டெலிவரி தேவையில்லாத அல்லது SKU-களின் பட்டியலுடன் பொருந்தக்கூடிய எந்தவொரு உருப்படியையும் நிறைவேற்றுகிறது. புதிய ஆர்டருக்கான ஒவ்வொரு நிறைவேற்றும் இடத்திற்கும் ('நிறைவேற்ற ஆர்டர்') இது ஒருமுறை ரன் ஆகும். வார்ப்புருவைக் காண்க