يمكن أن تعرض خدمات مقارنة الأسعار (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.
- يتم إنشاء التصنيفات التلقائية وتخصيصها تلقائيًا لحسابات Merchant Center من خلال CSS Center. تتوفّر التصنيفات التلقائية لأنواع مختلفة من مقاييس الحساب، ويمكن أن تساعدك في تحديد الحسابات المهمة والنشاط الكبير في الحساب.
لمزيد من المعلومات عن أنواع التصنيفات، بما في ذلك التصنيفات التلقائية المتوفّرة، يمكنك الاطّلاع على استخدام تصنيفات الحساب في Comparison Shopping Service Center.
وظائف Content API ونقاط النهاية لخدمات مقارنة الأسعار
توفّر 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’
}