الوصول إلى البيانات التفصيلية في مسؤول Shopify باستخدام JSON

تُعد صيغة JSON، وهي اختصار لـ JavaScript Object Notation، تنسيقًا لتخزين البيانات ونقلها، وغالبًا ما تُستخدم عند إرسال البيانات من الخوادم إلى صفحات الويب. في معظم صفحات الموارد ضمن مسؤول Shopify، مثل صفحات الطلبات، أو المنتجات، أو العملاء، يمكنك الوصول إلى بيانات أكثر تفصيلاً باستخدام JSON.

على الرغم من أنه لا يُطلب منك أداء مهام تطوير متقدمة باستخدام JSON، إلا أن القدرة على الوصول إلى ملف JSON لمورد معين في مسؤول Shopify يمكن أن تساعدك في جمع معلومات أكثر تفصيلاً، أو استكشاف الأخطاء وإصلاحها أو التحقيق في المشكلات بنفسك. على سبيل المثال، يمكنك مراجعة ملف JSON لمنتج ما للعثور على معرّف المتغير الخاص به، والذي قد يكون مطلوبًا لبعض مهام ترحيل البيانات أو تخصيصات كود القالب. كمثال آخر، يمكنك الرجوع إلى ملف JSON الخاص بالطلب لتأكيد متغير البيانات الذي ترغب في استخدامه عند إنشاء سير عمل آلي في Shopify Flow.

غالبًا ما يستخدم المطورون صيغة JSON، ولكن حتى المستخدمون الذين لديهم معرفة محدودة بالبرمجة يمكنهم الاستفادة من تعلم كيفية العثور على بعض معلومات JSON الشائعة وتفسيرها في مسؤول Shopify الخاص بهم.

إعادة تنسيق ملف JSON

تُعرض بيانات JSON الأولية كسلسلة طويلة من المتغيرات والأقواس المتداخلة، مما يصعب على المستخدم البشري قراءتها.

لجعل تنسيق JSON أكثر قابلية للقراءة، ضع في اعتبارك أيًا من الخيارات التالية:

• ثبّت إضافة عارض JSON في متصفحك.
• استخدم إمكانية pretty-print التي توفرها معظم متصفحات الويب الحديثة بشكل افتراضي:

الوصول إلى ملفات JSON في مسؤول Shopify

يُعد مسؤول Shopify المركز الأساسي لإدارة جميع جوانب عملك، وهو مصمم لعرض المعلومات الأكثر فائدة وصلة فقط بشكل افتراضي. يتم تخزين المعلومات الإضافية التي تُجمَع كلما تم تنفيذ إجراءات في مسؤول Shopify الخاص بك في ملفات .json لصفحات الموارد المختلفة. لا تُعرَض هذه التفاصيل الإضافية لك بشكل افتراضي لأن هذا الكم من المعلومات سيكون هائلاً وغير مفيد، وسيجعل استخدام مسؤول Shopify الخاص بك أمرًا صعبًا.

بالنسبة لمعظم مهام العمل، يمكنك استخدام أدوات Shopify الحالية للوصول إلى معلومات متجرك وتفسيرها. ومع ذلك، قد يكون من المفيد أحيانًا مراجعة المعلومات المحددة حول موارد معينة، مثل المنتجات أو الطلبات، عند استكشاف الأخطاء وإصلاحها لمعرفة سبب أو وقت حدوث أمر ما.

مثال: الوصول إلى ملف JSON الخاص بطلب

في هذا المثال، ستتمكن من الوصول إلى ملف JSON الخاص بطلب في مسؤول Shopify.

الخطوات:

1. من مسؤول Shopify، انتقل إلى الطلبات.

2. انقر على أي طلب في قائمة الطلبات.

3. في شريط عنوان المتصفح، أضف .json إلى نهاية عنوان URL. سيكون مشابهًا لهذا المثال:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

4. اضغط على Enter لإعادة تحميل الصفحة بتنسيق JSON.
5. اختياري: إذا لم تكن هناك إضافة لعرض ملفات JSON مثبتة في متصفحك، فنشّط إعداد Pretty-print في متصفحك لجعل ملف JSON أسهل في الاستخدام. تعرف على المزيد حول إعادة تنسيق ملف JSON.

ستلاحظ عرض الكثير من المعلومات المتوقعة حول الطلب، مثل "currency" و"line_items" المرتبطة بالطلب، ولكن يتم تضمين الكثير من المعلومات التفصيلية الأخرى أيضًا، مثل "client_details" من جلسة متصفح العميل عندما قدم الطلب. يُعد هذا النوع من المعلومات مفيدًا للتتبع العام للجلسة ولتحليلات منصة التسويق، ولكنه ليس ضروريًا بالنسبة لك لمعالجة الطلب وتلبيته.

عرض حقول محددة في ملف JSON

يمكنك فرض عرض حقول محددة فقط في ملفات JSON، مما يسهل تفسير المعلومات عندما تعرف الخصائص المعينة التي تريد تضمينها. في نهاية أي عنوان URL لملف JSON في شريط عنوان المتصفح، أضف ?fields= ثم قم بتضمين أسماء الخصائص التي تريد عرضها، بأي ترتيب، ومفصولة بفاصلة.

على سبيل المثال، لعرض معرّف الطلب، ومعلومات العميل، والسعر الإجمالي، والعلامات، أضف ?fields=id,customer,total_price,tags إلى نهاية عنوان URL لملف JSON، كما في المثال التالي:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

استخدام موارد JSON الأخرى

يمكنك استخدام موارد JSON التالية لعرض معلومات محددة في مسؤول Shopify:

• عدد المنتجات: أضف /count.json إلى نهاية عنوان URL لقائمة المنتجات لعرض إجمالي عدد المنتجات. يجب أن يكون عنوان URL الكامل كالتالي:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

• المعاملات: أضف /transactions.json إلى نهاية عنوان URL لصفحة طلب لعرض معلومات معاملات الطلب فقط. تعرف على المزيد حول مورد المعاملات.
• عمليات التلبية: أضف /fulfillments.json إلى نهاية عنوان URL لصفحة طلب لعرض معلومات تلبية الطلب فقط. تعرف على المزيد حول مورد عمليات التلبية.
• عمليات الدفع المتروكة: أضف .json إلى نهاية عنوان URL لعملية دفع متروكة لعرض معلومات تفصيلية حولها. تعرف على المزيد حول مورد عمليات الدفع المتروكة.

خصائص JSON الشائعة لاستكشاف الأخطاء وإصلاحها

يدرج الجدول التالي خصائص JSON التي قد ترغب في الرجوع إليها للمساعدة في استكشاف الأخطاء وإصلاحها مع أنواع الموارد المختلفة. على سبيل المثال، إذا كنت ترغب في تأكيد متى تم نشر منتج معين، فيمكنك مراجعة ملف JSON الخاص بالمنتج بحثًا عن الخاصية published_at، والتي تعرض التاريخ والوقت بتنسيق ISO 8601.

لا يتضمن هذا الجدول كل مورد أو خاصية JSON ممكنة مخزنة في مسؤول Shopify، لذا يُرجى الرجوع إلى مستندات مطوري Shopify للحصول على تعريفات لأي مورد أو خاصية غير مضمنة هنا.

"product": {
  "created_at"

"product": {
  "published_at"

"product": {
  "updated_at"

"product": {
  "variants": [
    {
    "created_at"

"product": {
  "variants": [
    {
    "updated_at"

"product": {
  "variants": [
    {
    "inventory_quantity"

"product": {
  "variants": [
    {
    "old_inventory_quantity"

"order": {
   "line_items": [
    {
    "requires_shipping"

"order": {
   "line_items": [
    {
    "taxable"

"order": {
   "line_items": [
    {
    "variant_inventory_management"

"order": {
   "line_items": [
    {
    "fulfillable_quantity"

"order": {
   "line_items": [
    {
    "quantity"

"order": {
   "line_items": [
    {
    "tax_lines"

"customer": {
  "created_at"

"customer": {
  "updated_at"

الحقول الوصفية في JSON

تُعد الحقول الوصفية طريقة مرنة لإرفاق معلومات مخصصة إضافية بأحد موارد Shopify، مثل المنتجات أو المجموعات. تتضمن بعض أمثلة البيانات المُخزَّنة باستخدام الحقول الوصفية مواصفات المنتج أو جداول المقاسات أو المستندات القابلة للتنزيل أو تواريخ الإصدار أو الصور أو أرقام القطع. تعرّف على المزيد حول استخدام الحقول الوصفية.

يمكنك إضافة /metafields.json إلى نهاية عنوان URL لصفحة مورد مدعوم لعرض الحقول الوصفية المرتبطة بهذا المورد. راجع الجدول التالي للاطلاع على بعض الأمثلة للموارد وتنسيقات عناوين URL التي يجب استخدامها لعرض معلومات الحقول الوصفية باستخدام تنسيق JSON.

للاطلاع على قائمة كاملة بالموارد التي يمكن أن تحتوي على حقول وصفية، والأنواع المحددة للخصائص التي يتم تخزينها لكل نوع مورد، راجع مورد الحقول الوصفية بتنسيق JSON في وثائق مطوري Shopify.

الأحداث بتنسيق JSON

يتم إنشاء الأحداث بواسطة بعض موارد Shopify عند اكتمال إجراءات معينة، مثل إنشاء منشور مدونة أو تلبية طلب أو إضافة منتج.

يمكنك إضافة /events.json إلى نهاية عنوان URL لصفحة مورد مدعوم لعرض الأحداث المرتبطة بهذا المورد. راجع الجدول التالي للاطلاع على بعض الأمثلة للموارد وتنسيقات عناوين URL التي يجب استخدامها لعرض معلومات الأحداث باستخدام تنسيق JSON.

للاطلاع على قائمة كاملة بالموارد التي يمكنها إنشاء أحداث، والأحداث المحددة التي يتم إنشاؤها لكل نوع مورد، راجع مورد الأحداث بتنسيق JSON في وثائق مطوري Shopify.