البدء باستخدام خدمات مقارنة الأسعار (CSS)

يُعدّ تنفيذ العمليات الأساسية باستخدام واجهة برمجة التطبيقات طريقة جيدة لبدء استخدامها.

المتطلبات الأساسية

قبل البدء، أكمل ما يلي:

  • تأكَّد من أنّ لديك حسابًا صالحًا على CSS Center.
  • تسجيل مطوّر واجهة برمجة تطبيقات
  • تأكَّد من صحة إعدادات الأذونات.
  • تأكَّد من تفعيل CSS API.
  • تأكَّد من تثبيت مكتبات البرامج للبيئة التي تستخدمها.

لمزيد من المعلومات، يُرجى الاطّلاع على البدء السريع.

تفعيل واجهة برمجة التطبيقات CSS API

للتسجيل كمطوّر واستخدام CSS API، يجب ربط حسابك على CSS Center بمشروعك على Google Cloud باستخدام طريقة تسجيل المطوّرين، وذلك باتّباع الخطوات التالية:

ربط CSS Center بمشروعك على Google Cloud: يتم إنشاء الرابط تلقائيًا، لأنّ المتصل يمكنه الوصول إلى مشروع Google Cloud استنادًا إلى رمز الدخول أو مفتاح واجهة برمجة التطبيقات، وهو مستخدم معتمَد لحساب CSS Center.

تسجيل مطوّر واجهات برمجة التطبيقات

إضافة مستخدم مطوّر واجهة برمجة التطبيقات إلى حساب CSS Center: إذا كان المستخدم موجودًا، سيتم منحه نوع الوصول الجديد "مطوّر واجهة برمجة التطبيقات". في حال كان المستخدم جديدًا، سيتلقّى دعوة عبر البريد الإلكتروني من CSS Center.

بعد التسجيل، يمكنك الاطّلاع على حالة التسجيل باستخدام GetDeveloperRegistration أو إلغاء التسجيل باستخدام UnregisterGCP. يمكنك استخدام طلب التسجيل التالي:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

بعد تنفيذ الطلب بنجاح، توقَّع الردّ التالي:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

منتجات CSS

على غرار واجهة برمجة التطبيقات الفرعية Products، تميّز CSS API بين CssProductInput وListCssProduct. أدرِج منتجًا يتضمّن InsertCssProductInput.

بعد أن تعالج أنظمتنا الداخلية المنتج (قد يستغرق ذلك بضع دقائق)، يمكنك استرداده باستخدام ListCssProducts.

حدِّد منتجاتك باستخدام raw_provided_id. ننصحك باستخدام معرّف تستخدمه حاليًا في نظامك. بدلاً من ذلك، تتضمّن الطرق الشائعة لإنشاء رمز QR استخدام أحد العناصر التالية:

  • المعرّفات الفريدة عالميًا (GUID)
  • أرقام التعريف الفريدة العالمية (UUID)
  • سمات المنتج الفريدة المدمجة (على سبيل المثال، العلامة_التجارية_الطراز_اللون_المقاس)

لمزيد من المعلومات، يُرجى الاطّلاع على إدراج منتج أو عرضه في قائمة أو تعديله أو حذفه.

العمليات الأساسية

في ما يلي بعض الطلبات الأساسية التي يمكنك تجربتها.

  1. أدرِج منتجًا تجريبيًا باستخدام InsertCssProductInput. للحصول على مساعدة بشأن السمات التي يجب إرسالها، راجِع الرمز النموذجي هذا.

  2. أدرِج جميع منتجاتك باستخدام ListCssProducts. يُرجى العِلم أنّ هناك تأخيرًا بسيطًا في المعالجة بين إدراج منتج وظهوره في القائمة. إذا لم تظهر لك على الفور، يُرجى إعادة المحاولة بعد بضع ثوانٍ.

  3. تعديل منتج واحد باستخدام UpdateCssProductInput باستخدام cssproductinput.name عليك إرسال السمات المطلوب تعديلها فقط. للاطّلاع على مثال، راجِع نموذج الرمز.

  4. احذف المنتج التجريبي باستخدام DeleteCssProductInpu، مع توفير raw_provided_id.

القيود

قد تستغرق عملية إدراج منتج فردي أو حذفه وقتًا طويلاً. لتحسين الأداء، استخدِم Async لتحسين الأداء. يتيح ذلك إرسال الطلبات إلى واجهة برمجة التطبيقات بشكلٍ متوازٍ.

إدراج حساباتك وتصنيفها

تتيح لك ميزة "إدارة التصنيفات" في CSS API تنظيم حسابات عملاء Merchant Center بطريقة منهجية باستخدام علامات مخصّصة. تساعدك هذه الميزة في تصنيف العملاء بكفاءة (حسب النوع أو الاستراتيجية مثلاً)، ما يتيح تنظيمًا أفضل وعمليات مبسطة. يمكنك استخدام واجهة برمجة التطبيقات لتنفيذ الوظائف التالية على التصنيفات: