تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إدارة تصنيفات 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 هي حسابات خدمات 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.
يتم إنشاء التصنيفات التلقائية تلقائيًا وتخصيصها لحسابات Merchant Center من خلال CSS Center. تتوفّر التصنيفات التلقائية لأنواع مختلفة من مقاييس الحسابات، ويمكن أن تساعدك في تحديد الحسابات المهمة ونشاط الحسابات الملحوظ.

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

وظائف Content API ونقاط انتهائها لخدمات مقارنة الأسعار

توفّر 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.

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

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

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

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