إدارة تصنيفات CSS

يمكن أن تعرض خدمات مقارنة الأسعار (CSS) إعلانات Shopping على Google نيابةً عن التجّار في البلدان التي يتوفّر فيها برنامج CSS. تتيح Content API لنطاقات CSS ومجموعات CSS تنظيم حساباتها المرتبطة باستخدام التصنيفات. يمكن لنطاقات CSS إدراج حسابات Merchant Center المرتبطة بالنطاق وتصنيفها وفلترتها. يمكن لمجموعات CSS تصنيف نطاقات CSS التابعة للمجموعة وإدراجها. تقدّم خدمات Content API هذه بدائل برمجية لبعض الميزات المتوفّرة في Comparison Shopping Service Center.

لمزيد من المعلومات عن خدمات مقارنة الأسعار، يُرجى الاطّلاع على مقالة خدمات مقارنة الأسعار. للحصول على معلومات حول استخدام التصنيفات في CSS Center، يُرجى الاطّلاع على مقالة استخدام تصنيفات الحساب في Comparison Shopping Service Center.

أنواع حسابات CSS

تستخدِم خدمات CSS ثلاثة أنواع من الحسابات، وهي:

  • مجموعات CSS هي حسابات المستوى الأعلى التي يمكن أن تحتوي على نطاق CSS واحد أو أكثر.
  • نطاقات CSS هي حسابات خاصة بخدمات مقارنة الأسعار نفسها، وهي تعرض إعلانات Shopping نيابةً عن التجّار. يمكن أن ينتمي كل نطاق CSS إلى مجموعة CSS واحدة فقط.
  • حسابات Merchant Center هي حسابات التجّار التي تعرض نطاقات CSS من خلالها إعلانات Shopping. يمكن ربط خدمات CSS بأنواع مختلفة من حسابات Merchant Center، بما في ذلك الحسابات المتعدّدة العملاء وحسابات التجار الفردية. يمكن ربط كل حساب على Merchant Center بنطاق واحد فقط من نطاقات CSS. لمزيد من المعلومات حول أنواع حسابات Merchant Center المختلفة، يُرجى الاطّلاع على أنواع الحسابات في Comparison Shopping Service Center.

أنواع التصنيفات في CSS

تستخدم خدمات مقارنة الأسعار نوعَين من التصنيفات:

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

لمزيد من المعلومات حول أنواع التصنيفات، بما في ذلك التصنيفات التلقائية المتاحة، راجِع مقالة استخدام تصنيفات الحساب في Comparison Shopping Service Center.

وظائف ونقاط نهاية Content API لخدمات CSS

توفّر Content API نقاط النهاية التالية لخدمات CSS:

  • ‫accounts.labels: تتيح لك إنشاء واسترداد وتعديل التصنيفات لتطبيقها على نطاق CSS وحسابات Merchant Center. للاطّلاع على مثال، يُرجى الانتقال إلى إنشاء تصنيف.
  • accounts.updatelabels: تتيح لك تطبيق تصنيفات على حساب واحد على Merchant Center. للاطّلاع على مثال، راجِع مقالة تطبيق تصنيف على حساب Merchant Center.
  • accounts.list: تتيح لك استرداد جميع حسابات Merchant Center المرتبطة بنطاق CSS، بما في ذلك التصنيفات المطبّقة على كل حساب. يمكنك أيضًا الفلترة حسب التصنيف id لاسترداد مجموعة فرعية من الحسابات المرتبطة. للاطّلاع على مثال، راجِع مقالة استخدام التصنيفات لفلترة حسابات Merchant Center.
  • accounts.get: تتيح لك استرداد التصنيفات المطبّقة على حساب واحد على Merchant Center.
  • ‫csses: تتيح لك هذه السمة عرض وإدارة عمليات الربط بين التصنيفات ونطاقات CSS. للاطّلاع على مثال، راجِع تطبيق تصنيف على نطاق CSS.

عند طلب نقاط نهاية accounts كنطاق CSS، يجب الانتباه إلى المتطلبات التالية:

  • يجب أن تقدّم نطاقات CSS cssId بدلاً من merchantId.
  • يجب أن توفّر نطاقات CSS مَعلمة طلب بحث view=CSS.
  • يجب أن توفّر نطاقات CSS رقم تعريف حساب Merchant Center المرتبط بها كـ accountId.

مثال: إنشاء تصنيف

يمكنك استخدام الطريقة accounts.labels.create لإنشاء تصنيف جديد. يمكن تطبيق التصنيفات على نطاقات CSS وحسابات Merchant Center. ومع ذلك، فإنّ تصنيفات أنواع الحسابات المختلفة منفصلة ولا يمكن استخدامها بشكل تبادلي. لإنشاء تصنيف على مستوى النطاق يمكن تطبيقه على حسابات Merchant Center المرتبطة بالنطاق، استخدِم رقم تعريف نطاق CSS كـ accountId عند إنشاء التصنيف. لإنشاء تصنيف على مستوى المجموعة يمكن تطبيقه على نطاقات CSS تابعة للمجموعة، استخدِم معرّف مجموعة CSS كـ accountId عند إنشاء التصنيف.

يوضّح المثال التالي كيفية إنشاء تصنيف على مستوى النطاق للحسابات الرئيسية، والذي يمكن تطبيقه بعد ذلك على حسابات Merchant Center المرتبطة بالنطاق. لإنشاء التصنيف، أرسِل طلب POST باستخدام عنوان URL ونص الطلب التاليَين:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

مثال: تطبيق تصنيف على حساب Merchant Center

يمكنك استخدام الطريقة accounts.updatelabels لتعيين تصنيفات لحساب على Merchant Center مرتبط بنطاق CSS. يوضّح المثال التالي كيفية تطبيق التصنيف key-accounts الذي تم إنشاؤه في المثال السابق على أحد أهم حساباتك على Merchant Center.

لتطبيق التصنيف، أرسِل طلب POST باستخدام عنوان URL ونص الطلب التاليَين:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

مثال: استخدام التصنيفات لفلترة حسابات Merchant Center

بعد إنشاء تصنيفات وتطبيقها على حسابات Merchant Center المرتبطة بنطاق CSS، يمكنك استخدام طريقة accounts.list وتمرير مَعلمة طلب البحث الخاصة بالتصنيف في طلبك لعرض الحسابات التي تحمل هذا التصنيف فقط. يوضّح المثال التالي كيفية فلترة حسابات Merchant Center المرتبطة بنطاق CSS، وذلك باستخدام id (123) لتصنيف key-accounts الذي تم إنشاؤه في مثال إنشاء تصنيف. لاسترداد الحسابات، أرسِل طلب GET باستخدام عنوان URL التالي:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

لا يلزم توفير نص الطلب.

مثال: تطبيق تصنيف على نطاق CSS

يمكنك أيضًا استخدام الطريقة csses.updatelabels لتعيين تصنيفات لنطاق CSS تابع لمجموعة CSS. يوضّح المثال التالي كيفية تطبيق تصنيف على مستوى المجموعة key-domains تم إنشاؤه باستخدام طريقة accounts.labels.create على أحد أهم حسابات نطاق CSS. يُرجى العِلم أنّ تصنيفات نطاقات CSS وحسابات Merchant Center منفصلة. يجب إنشاء التصنيفات على مستوى المجموعة باستخدام معرّف مجموعة CSS كـ accountId.

لتطبيق التصنيف، أرسِل طلب POST باستخدام عنوان URL ونص الطلب التاليَين:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}