تتيح لك مجموعات المنتجات تحديد مجموعات من المنتجات لاستخدامها مع التنسيقات الغنية، مثل صور للتسوّق. ويمكن أن تتضمّن كل مجموعة ما يصل إلى 100 منتج. يمكنك إنشاء مجموعة باستخدام Google Merchant Center أو Content API.
يوضّح هذا الدليل كيفية استخدام مجموعات المنتجات من خلال Content API، بما في ذلك أمثلة حول كيفية إنشاء مجموعة لـ "صور للتسوّق" وكيفية التحقّق من حالة المجموعة.
استخدام مجموعات المنتجات
تتضمّن Content API خدمتَين لإدارة مجموعات المنتجات:
collections: تتيح لك الحصول على مجموعات المنتجات وعرضها في قائمة وإدراجها وحذفها.collectionstatuses: تتيح لك الحصول على حالة المجموعات وإدراجها لمعرفة ما إذا كانت هناك أي مشاكل قد تؤدي إلى عدم صلاحية المجموعة لوجهة معيّنة، مثل إعلانات Shopping.
مثال: إنشاء مجموعة لـ "صور للتسوّق"
الصور للتسوّق هي صور عالية الجودة تعرض منتجًا واحدًا أو أكثر يتضمّن تعليقات توضيحية، ويتم إعدادها باستخدام المجموعات. لاستخدام "صور للتسوّق"، يجب تحديد قيم للحقلَين
imageLink وfeaturedProduct، بالإضافة إلى الحقول المطلوبة لجميع المجموعات. لمزيد من المعلومات حول الحقول المطلوبة، يُرجى الاطّلاع على
مستندات مرجع Content API.
لاستخدام "صور للتسوّق"، عليك إنشاء مجموعة من المنتجات واستخدام الحقل imageLink لتحديد صورة تحتوي على ما يصل إلى عشرة منتجات. ننصحك باستخدام صور مربّعة (بنسبة عرض إلى ارتفاع 1:1).
يجب أيضًا تحديد المنتجات المعروضة في الصورة باستخدام الحقل
featuredProduct، بما في ذلك إحداثيات المنتجات في الصورة
باستخدام الحقلَين x وy. هذه الحقول مطلوبة فقط للمجموعات المستخدَمة مع "صور للتسوّق". يجب أن تتراوح قيمتا x وy بين 0 و1،
بما في ذلك هذان الرقمَان.
يمكن أن تتضمّن كل مجموعة 100 منتج كحدّ أقصى. ومع ذلك، بالنسبة إلى "الصور للتسوّق"، ننصحك بتحديد إحداثيات لما لا يزيد عن 10 منتجات لكل صورة لضمان توفّر مساحة كافية في الصورة لعرض وسائل شرح المنتجات. يجب أن يتطابق الحقل
offerId
الذي يشكّل جزءًا من الكائن featuredProduct مع قيمة offerId
في المورد products، وهي قيمة مختلفة عن
قيمة id
في المورد products.
بالإضافة إلى الحقلَين imageLink وfeaturedProduct المطلوبَين لإنشاء صور للتسوّق، يمكنك أيضًا تحديد عنوان مجموعة باستخدام الحقل الاختياري headline. ننصحك بتضمين عنوان لتزويد العملاء بتفاصيل إضافية حول المجموعة.
لإنشاء مجموعة جديدة من "الصور للتسوّق"، أرسِل طلب POST إلى نقطة النهاية collections.insert باستخدام عنوان URL ونص الطلب التاليَين:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections
{
"id": "exampleCollection"
"language": "en",
"productCountry": "UK",
"imageLink": ["www.imageLink.example"],
"featuredProduct": [
{
"offerId": '432',
"x": 0.11,
"y": 0.99
},
{ "offerId": '433',
"x": 0.53,
"y": 0.89
}
],
"link": "www.link.example",
"mobileLink": "www.mobileLink.example",
"headline": "www.link.example",
"customLabel0": "Organize",
"customLabel1": "Your",
"customLabel2": "Bidding/Reporting",
"customLabel3": "With",
"customLabel4": "Me"
}
مثال: التحقّق من حالة مجموعة
لمعرفة ما إذا كانت المجموعة التي أنشأتها أعلاه تتضمّن مشاكل قد تؤدي إلى عدم صلاحيتها لعرض الإعلانات، أرسِل طلب GET إلى نقطة النهاية collectionsstatuses.get باستخدام عنوان URL التالي، وأدرِج id للمجموعة التي تريد استرداد حالتها. ليس عليك تقديم نص الطلب.
https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID
مثال على استجابة حالة المجموعة
{
"id": "exampleCollection",
"creationDate": "2020-09-22T00:26:51Z",
"lastUpdateDate": "2020-09-22T00:26:51Z",
"collectionLevelIssues": [
{
"code": "invalid_url",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Invalid URL [link]",
"detail": "Use a complete URL that starts with http:// or https:// and
links to a valid destination such as an image or a landing page",
"documentation": "https://support.google.com/merchants/answer/7052112"
},
{
"code": "invalid_url",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "imageLink",
"description": "Invalid URL [imageLink]",
"detail": "Use a complete URL that starts with http:// or https:// and
links to a valid destination such as an image or a landing page",
"documentation": "https://support.google.com/merchants/answer/7052112"
}
]
}