إجراءات Shopify Native - المنتجات
في هذا القسم، سنتحدث عن الإجراءات المتعلقة ب "المنتجات والجمع". NewAge Ai الدعم فيما يلي الإجراءات المتعلقة بالعملاء:
- البحث عن المنتجات
- احصل على معلومات المنتج
- احصل على صور المنتجات
- احصل على نسخ المنتجات
- ابحث عن مجموعات مخصصة
- ابحث عن المجموعات الذكية
- احصل على معلومات المجموعة
- احصل على منتجات التجميع
الآن، دعونا نستعرض هذه الأفعال واحدة تلو الأخرى.
احصل على المنتجات
يستخدم هذا الإجراء لعرض المنتجات المتوفرة على متجر Shopify باستخدام معايير مختلفة مثل معرف المنتج، المسمى، البائع، إلخ
المدخلات
حمولة الاستجابة
{ "المنتجات": [ { "id": 1413101355074، "العنوان": "2 في 1 جهاز ماك بوك ذهبي رايزر & ستاند"، "body_html": "رقم الطراز: حامل جهاز لوحي المادة: معدنيةالميزة: حامل حامل لوحي لآيباد والهاتف والجهاز اللوحي رقم الطراز: لماك بوك برو 13 15 المادة: سبائك الألمنيوم حوامل الألوحة: لماك بوك ريتينا 12 13 15 حامل للجهاز اللوحي: لآيباد ميني 1 2 3 4 "، "بائع": "هابانز"، "product_type": "الإلكترونيات", "المقبض": "حامل 2 في 1 ذهبي ماك بوك، "الأنواع المتنوعة": [ { "id": 12535571218498، "product_id": 1413101355074، "العنوان": "فضي"، "السعر": "47.99", "SKU": "9877410-فضي"، "الموقع": 1, "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "فضي"، "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2022-10-13T02:39:56-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679678018، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409401410، "inventory_quantity": 989، "old_inventory_quantity": 989، "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571218498" }, { "id": 12535571251266، "product_id": 1413101355074، "العنوان": "ذهب"، "السعر": "47.99", "SKU": "9877410-ذهبي", "الموقع": 2, "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "ذهب", "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2022-09-09T13:26:56-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679678018، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409434178، "inventory_quantity": 998, "old_inventory_quantity": 998، "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571251266" }, { "معرف": 12535571284034, "product_id": 1413101355074، "العنوان": "الذهب الوردي", "السعر": "47.99", "SKU": "9877410-ورد-ذهب"، "الموقع": 3، "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "الذهب الوردي", "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2018-09-12T00:53:05-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679710786، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409466946، "inventory_quantity": 999، "old_inventory_quantity": 999, "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571284034" } ], "الخيارات": [ { "id": 1864082522178، "product_id": 1413101355074، "الاسم": "اللون", "الموقع": 1, "القيم": [ "فضة"، "ذهب"، "الذهب الوردي" ] } ], "صور": [ { "id": 3736679645250، "product_id": 1413101355074، "الموقع": 1, "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 800, "SRC": "cdn.shopify.com", "variant_ids": [ ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679645250" }, { "id": 3736679678018, "product_id": 1413101355074، "الموقع": 2, "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 640، "الطول": 640, "src": "cdn.shopify.com", "variant_ids": [ 12535571218498, 12535571251266 ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679678018" }, { "معرف": 3736679710786، "product_id": 1413101355074، "الموقع": 3، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 640، "الطول": 640, "SRC": "cdn.shopify.com", "variant_ids": [ 12535571284034 ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679710786" }, { "معرف": 3736679743554، "product_id": 1413101355074، "الموقع": 4، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 800, "src": "cdn.shopify.com", "variant_ids": [...]، // 0 عناصر "admin_graphql_api_id": "gid://shopify/ProductImage/3736679743554" }, { "معرف": 3736679776322، "product_id": 1413101355074، "الموقع": 5، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 632، "src": "cdn.shopify.com", "variant_ids": [...]، // 0 عناصر "admin_graphql_api_id": "gid://shopify/ProductImage/3736679776322" } ], "صورة": "cdn.shopify.com" } ] }
احصل على معلومات المنتج
يستخدم هذا الإجراء لإظهار معلومات حول منتج معين باستخدام معرف المنتج الخاص به.
المدخلات
حمولة الاستجابة
{ "المنتج": { "id": 1413101355074، "العنوان": "2 في 1 جهاز ماك بوك ذهبي رايزر & ستاند"، "body_html": "رقم الطراز: حامل جهاز لوحي المادة: معدنيةالميزة: حامل حامل لوحي لآيباد والهاتف والجهاز اللوحي رقم الطراز: لماك بوك برو 13 15 المادة: سبائك الألمنيوم حوامل الألوحة: لماك بوك ريتينا 12 13 15 حامل للجهاز اللوحي: لآيباد ميني 1 2 3 4 "، "بائع": "هابانز"، "product_type": "الإلكترونيات", "المقبض": "حامل 2 في 1 ذهبي ماك بوك، "الأنواع المتنوعة": [ { "id": 12535571218498، "product_id": 1413101355074، "العنوان": "فضي"، "السعر": "47.99", "SKU": "9877410-فضي"، "الموقع": 1, "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "فضي"، "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2022-10-13T02:39:56-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679678018، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409401410، "inventory_quantity": 989، "old_inventory_quantity": 989، "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571218498", "صورة": "cdn.shopify.com" }, { "id": 12535571251266، "product_id": 1413101355074، "العنوان": "ذهب"، "السعر": "47.99", "SKU": "9877410-ذهبي", "الموقع": 2, "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "ذهب", "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2022-09-09T13:26:56-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679678018، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409434178، "inventory_quantity": 998, "old_inventory_quantity": 998، "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571251266", "صورة": "cdn.shopify.com" }, { "معرف": 12535571284034, "product_id": 1413101355074، "العنوان": "الذهب الوردي", "السعر": "47.99", "SKU": "9877410-ورد-ذهب"، "الموقع": 3، "inventory_policy": "إنكار"، "compare_at_price": null, "fulfillment_service": "يدوي"، "inventory_management": "شوبيفاي"، "الخيار 1": "الذهب الوردي", "الخيار 2": null, "الخيار 3": معدم، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2018-09-12T00:53:05-04:00", "خاضع للضريبة": خطأ، "الباركود": null, "غرام": 0, "image_id": 3736679710786، "الوزن": 0, "weight_unit": "كغ"، "inventory_item_id": 12660409466946، "inventory_quantity": 999، "old_inventory_quantity": 999, "requires_shipping": صحيح، "admin_graphql_api_id": "gid://shopify/ProductVariant/12535571284034", "صورة": "cdn.shopify.com" } ], "الخيارات": [ { "id": 1864082522178، "product_id": 1413101355074، "الاسم": "اللون", "الموقع": 1, "القيم": [ "فضة"، "ذهب"، "الذهب الوردي" ] } ], "صور": [ { "id": 3736679645250، "product_id": 1413101355074، "الموقع": 1, "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 800, "src": "cdn.shopify.com", "variant_ids": [ ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679645250" }, { "id": 3736679678018, "product_id": 1413101355074، "الموقع": 2, "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 640، "الطول": 640, "src": "cdn.shopify.com", "variant_ids": [ 12535571218498, 12535571251266 ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679678018" }, { "معرف": 3736679710786، "product_id": 1413101355074، "الموقع": 3، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 640، "الطول": 640, "src": "cdn.shopify.com", "variant_ids": [ 12535571284034 ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679710786" }, { "معرف": 3736679743554، "product_id": 1413101355074، "الموقع": 4، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 800, "src": "cdn.shopify.com", "variant_ids": [...]، // 0 عناصر "admin_graphql_api_id": "gid://shopify/ProductImage/3736679743554" }, { "معرف": 3736679776322، "product_id": 1413101355074، "الموقع": 5، "created_at": "2018-06-18T08:20:46-04:00", "updated_at": "2019-10-21T23:39:36-04:00", "alt": null, "العرض": 800، "الطول": 632، "SRC": "cdn.shopify.com", "variant_ids": [ ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736679776322" } ], "الصورة": "cdn.shopify.com" } }
احصل على صور المنتجات
يستخدم هذا الإجراء لجلب صور المنتج ومتغيراته باستخدام معرفات المنتج.
المدخلات
حمولة الاستجابة
{ "صور": [ { "id": 3736679645250، "product_id": 1413101355074، "الموقع": 1, "العرض": 800، "الطول": 800, "SRC": "cdn.shopify.com" }, { "id": 3736679678018, "product_id": 1413101355074، "الموقع": 2, "العرض": 640، "الطول": 640, "SRC": "cdn.shopify.com" }, { "معرف": 3736679710786، "product_id": 1413101355074، "الموقع": 3، "العرض": 640، "الطول": 640, "SRC": "cdn.shopify.com" }, { "معرف": 3736679743554، "product_id": 1413101355074، "الموقع": 4، "العرض": 800، "الطول": 800, "SRC": "cdn.shopify.com" }, { "معرف": 3736679776322، "product_id": 1413101355074، "الموقع": 5، "العرض": 800، "الطول": 632، "SRC": "cdn.shopify.com" } ] }
احصل على متغيرات المنتجات
يستخدم هذا الإجراء لإظهار معلومات حول نسخ منتج باستخدام معرف المنتج الخاص به
المدخلات
حمولة الاستجابة
{ "الأنواع المتنوعة": [ { "id": 12535571218498، "product_id": 1413101355074، "العنوان": "فضي"، "السعر": "47.99", "SKU": "9877410-فضي"، "الموقع": 1, "compare_at_price": null, "الخيار 1": "فضي"، "الخيار 2": null, "الخيار 3": معدم، "الباركود": null, "غرام": 0, "image_id": 3736679678018، "الوزن": 0, "weight_unit": "كغ"، "inventory_quantity": 989 } ] }
ابحث عن مجموعات مخصصة
يستخدم هذا الإجراء للبحث عن مجموعات مخصصة متاحة لمنتجاتك على متجر Shopify.
المدخلات
حمولة الاستجابة
{ "custom_collections": [ { "id": 34403156034، "handle": "الصفحة الرئيسية", "العنوان": "المنتجات الأكثر مبيعا", "body_html": "<p>هذه هي منتجاتنا الأكثر مبيعا.</p> <p>النصائح والحيل ستزود متجركك على Shopify ببيانات رائعة أكثر بكثير!</p>". "sort_order": "الأكثر مبيعا"، "الصورة": { "created_at": "2022-08-17T00:24:01-04:00", "alt": null, "العرض": 900, "الطول": 900، "SRC": "cdn.shopify.com" } } ] }
البحث عن المجموعات الذكية
يستخدم هذا الإجراء لعرض مجموعات ذكية من المنتجات التي لديك في متاجر Shopify الخاصة بك.
المدخلات
حمولة الاستجابة
{ "smart_collections": [ { "معرف": 264802598978، "المقبض": "جمع الحقائب", "العنوان": "مجموعة حقائب الظهر"، "body_html": "خذ حقيبتك وابدأ بالاستمتاع بحياتك في الهواء الطلق!", "sort_order": "الأكثر مبيعا"، "القواعد": [ { "عمود": "علامة", "علاقة": "مساوي"، "الحالة": "حقيبة ظهر" } ], "الصورة": { "created_at": "2022-08-17T00:23:00-04:00", "alt": null, "العرض": 900, "الطول": 900، "SRC": "cdn.shopify.com" } }, { "id": 264802631746, "المقبض": "إلكترونيات"، "العنوان": "الإلكترونيات", "body_html": "يبحث عن الجهاز الرقمي الذي لا يمكنك العيش معه. مزيد من المعلومات هنا.", "sort_order": "الأكثر مبيعا"، "القواعد": [ { "عمود": "علامة", "علاقة": "مساوي"، "الشرط": "الإلكترونيات" } ], "الصورة": { "created_at": "2022-08-17T00:21:47-04:00", "alt": null, "العرض": 900, "الطول": 900، "SRC": "cdn.shopify.com" } } ] }
احصل على معلومات المجموعة
يستخدم هذا الإجراء لإظهار معلومات عن مجموعة باستخدام معرف المجموعة الخاص بها.
المدخلات
حمولة الرد
{ "المجموعة": { "معرف": 264802598978، "المقبض": "جمع الحقائب", "العنوان": "مجموعة حقائب الظهر"، "updated_at": "2023-02-25T07:42:25-05:00", "body_html": "خذ حقيبتك وابدأ بالاستمتاع بحياتك في الهواء الطلق!", "published_at": "2022-07-28T21:07:11-04:00", "sort_order": "الأكثر مبيعا"، "template_suffix": "", "products_count": 7, "منفصل": خطأ، "collection_type": "ذكي", "القواعد": [ { "عمود": "علامة", "علاقة": "مساوي"، "الحالة": "حقيبة ظهر" } ], "published_scope": "الويب", "admin_graphql_api_id": "gid://shopify/Collection/264802598978", "الصورة": { "created_at": "2022-08-17T00:23:00-04:00", "alt": null, "العرض": 900, "الطول": 900، "src": "cdn.shopify.com" } } }
احصل على منتجات التجميع
يستخدم هذا الإجراء لجلب المنتجات المتعلقة بمجموعة معينة باستخدام معرف المجموعة
المدخلات
حمولة الاستجابة
{ "المنتجات": [ { "معرف": 1413104205890، "العنوان": "حقيبة موشيلا", "body_html": "★مساحة تخزين كبيرة" الجيوب: حجرة منفصلة لللابتوب تتسع لابتوب 15.6 بوصة بالإضافة إلى ماكبوك/لابتوب 15 بوصة، 14 بوصة و13 بوصة. حجرة تعبئة واسعة واسعة للضروريات اليومية، وإكسسوارات إلكترونيات تقنية. حجرة أمامية بها العديد من الجيوب، جيوب قلم وخطاف مفتاح، تجعل أغراضك منظمة وأسهل في العثور ★عليها مريحة. متين: تصميم خلفي مريح مع تدفق هواء مع وسادة سميكة لكنها ناعمة متعددة الألواح وتهوي، يمنحك أقصى دعم للظهر. أحزمة الكتف القابلة للتنفس والقابلة للتعديل تخفف من ضغط الكتف. مقبض علوي مبطن برغوة لفترة طويلة للحمل ★اليدوي وظيفي& آمن: حزام الأمتعة يسمح بملاءمة حقيبة الظهر على الأمتعة/الحقيبة، وينزلق فوق أنبوب المقبض العمودي لتسهيل الحمل. مع جيب مضاد للسرقة مخفي في الخلف، يحمي أغراضك الثمينة من اللصوص. مصممة بشكل جيد للسفر الدولي بالطائرات والرحلات ★اليومية تصميم منفذ USB: مع شاحن USB مدمج في الخارج وكابل شحن مدمج في الداخل، توفر لك حقيبة الظهر عبر USB طريقة أكثر راحة لشحن هاتفك أثناء المشي. يرجى ملاحظة أن هذه الحقيبة لا تعمل بنفسها، منفذ الشحن عبر USB يوفر فقط سهولة الوصول لشحن ★المواد المتينة. صلب: مصنوع من قماش بوليستر مقاوم للماء ومتين مع سحابات معدنية. تأكد من استخدام آمن وطويل الأمد يوميا وعطلة نهاية الأسبوع. سيخدمك جيدا كحقيبة عمل مكتبية احترافية، حقيبة شحن USB رفيعة، حقيبة طلاب جامعية كبيرة للطلاب الثانوية للأولاد والبنات والمراهقين والبالغين. "بائع": "هابانز"، "product_type": "حقيبة ظهر"، "المقبض": "موتشيلا-حقيبة ظهر"، "الخيارات": [ { "id": 1864085733442، "product_id": 1413104205890، "الاسم": "اللون", "الموقع": 1 }, { "معرف": 1864085766210، "product_id": 1413104205890، "الاسم": "الحجم", "الموقع": 2 } ], "صور": [ { "id": 3736686919746, "product_id": 1413104205890، "الموقع": 1, "created_at": "2018-06-18T08:22:39-04:00", "updated_at": "2019-10-21T23:39:37-04:00", "alt": null, "العرض": 800، "الطول": 800, "src": "cdn.shopify.com", "variant_ids": [ 12535580164162 ], "admin_graphql_api_id": "gid://shopify/ProductImage/3736686919746" }, { "id": 3736686952514، "product_id": 1413104205890، "الموقع": 2, "created_at": "2018-06-18T08:22:39-04:00", "updated_at": "2019-10-21T23:39:37-04:00", "alt": null, "العرض": 430, "الطول": 430، "src": "cdn.shopify.com", "variant_ids": [...]، // 1 عناصر "admin_graphql_api_id": "gid://shopify/ProductImage/3736686952514" } ], "الصورة": "cdn.shopify.com" } ] }