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

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

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

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

تستخدم خدمات 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

تستخدم خدمات CSS نوعَين من التصنيفات:

  • التصنيفات اليدوية هي تصنيفات تنشئها نطاقات CSS وتعيّنها لحسابات Merchant Center، وتنشئها مجموعات 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. يوضّح المثال التالي كيفية تطبيق تصنيف الحسابات الرئيسية الذي تم إنشاؤه في المثال السابق على أحد أهم حساباتك على 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) لتصنيف الحسابات الرئيسية الذي تم إنشاؤه في مثال إنشاء تصنيف. لاسترداد الحسابات، أرسِل طلب GET باستخدام عنوان URL التالي:

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

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

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

يمكنك أيضًا استخدام طريقة csses.updatelabels لتعيين تصنيفات لنطاق CSS تابع لمجموعة CSS. يوضّح المثال التالي كيفية تطبيق تصنيف النطاقات الرئيسية على مستوى المجموعة تم إنشاؤه باستخدام طريقة 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’
}