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

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

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

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

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

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

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

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

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

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

وظائف Content API ونقاط النهاية لخدمات مقارنة الأسعار على Shopping (CSSs)

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

• 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.

ملاحظة: يمكن فقط لمستخدمي نطاق CSS وحسابات مجموعة CSS استخدام التصنيفات. ولا يمكن لحسابات Merchant Center نفسها الوصول إلى وظائف التصنيفات.

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

ويمكنك استخدام الطريقة 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.

ملاحظة: يجب استخدام السمة id للتصنيف، وليس الاسم، عند إضافة تصنيف إلى حساب على Merchant Center. يتم تخصيص id تلقائيًا للتصنيف ويتم إرجاعه في الاستجابة عند إنشاء التصنيف. يمكنك أيضًا استرداد التصنيف id من خلال طلب accounts.labels.list.

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

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

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

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

بعد إنشاء التصنيفات وتطبيقها على حسابات Merchant Center المرتبطة بنطاق CSS، يمكنك استخدام الطريقة accounts.list وتمرير مَعلمة طلب البحث label في طلبك لعرض الحسابات التي تحمل ذلك التصنيف فقط. يوضّح المثال التالي كيفية فلترة حسابات 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. يوضّح المثال التالي كيفية تطبيق تصنيف على مستوى المجموعة في نطاقات رئيسية تم إنشاؤه باستخدام الطريقة accounts.labels.create على أحد أهم حساباتك في نطاق CSS. ملاحظة: تكون تصنيفات نطاقات CSS وحسابات Merchant Center مختلفة. يجب إنشاء التصنيفات على مستوى المجموعة باستخدام معرّف مجموعة CSS باعتباره accountId.

ملاحظة: يجب استخدام السمة id للتصنيف، وليس الاسم، عند تطبيق تصنيف على نطاق CSS. يتم تخصيص id تلقائيًا للتصنيف ويتم عرضه في الاستجابة عند إنشاء التصنيف. يمكنك أيضًا استرداد التصنيف id من خلال استدعاء accounts.labels.list.

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

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

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