مجموعات المنتجات

نودّ إطلاعك على الإصدار التجريبي من Merchant API. إنه الإصدار الجديد من Content API for Shopping والمستقبل.

للحصول على معلومات حول كيفية تحسين عملية الدمج باستخدام Merchant API وكيفية المساعدة في تطويرها المستقبل، راجع الإعلان الإصدار التجريبي من Merchant API

مجموعات المنتجات تتيح لك وتحدد مجموعات من المنتجات لاستخدامها مع تنسيقات غنية، مثل صور للتسوّق: على كل يمكن أن تشمل ما يصل إلى 100 منتج. يمكنك إنشاء مجموعة باستخدام Google Merchant Center أو Content API

يوضّح هذا الدليل كيفية استخدام مجموعات المنتجات من خلال Content API. بما في ذلك أمثلة حول كيفية إنشاء مجموعة للصور للتسوّق للتحقق من حالة مجموعة.

ملاحظة: إنّ "الصور للتسوّق" هي حاليًا شكل الإعلان الوحيد المتوافق المجموعات. ومع ذلك، قد تتم إضافة تنسيقات إضافية لتتمكّن من إعادة استخدامها مجموعاتك في أشكال إعلانات مختلفة

استخدام مجموعات المنتجات

تتضمّن Content API خدمتَين لإدارة مجموعات المنتجات:

• collections: يسمح لك هذا الخيار بإنشاء مجموعات المنتجات وعرضها وإدراجها وحذفها.

• collectionstatuses: تتيح لك الحصول على حالة المجموعات وإدراجها في اكتشاف ما إذا كانت المجموعة تتضمّن أي مشاكل قد تؤدي إلى أن تكون غير صالحة لوجهة معيّنة، مثل إعلانات Shopping:

مثال: إنشاء مجموعة صور للتسوّق

تتميز الصور للتسوّق بنسبة عالية صور عالية الجودة تعرض منتجًا واحدًا أو أكثر يتضمّن تعليقات توضيحية، ويتم إعدادها باستخدام المجموعات. لاستخدام صور للتسوّق، يجب تحديد قيم imageLink وfeaturedProduct، بالإضافة إلى الحقول المطلوبة جميع المجموعات. لمزيد من المعلومات حول الحقول المطلوبة، راجِع المستندات المرجعية حول Content API:

لاستخدام صور للتسوّق، يجب إنشاء مجموعة من المنتجات واستخدام imageLink لتحديد صورة تحتوي على ما يصل إلى عشرة منتجات. أر ننصحك باستخدام صور مربّعة (بنسبة عرض إلى ارتفاع تبلغ 1:1).

نقطة رئيسية: يقبل الحقل imageLink للمجموعات بتقديم مصفوفة من رابط الصورة. القيم. ومع ذلك، يتم استخدام القيمة الأولى فقط في الصفيفة للتسوّق تنسيق الصور.

يجب أيضًا تحديد المنتجات المعروضة في الصورة باستخدام حقل featuredProduct، بما في ذلك إحداثيات المنتجات في الصورة باستخدام الحقلين x وy. هذه الحقول مطلوبة فقط للمجموعات مع صور للتسوّق يجب أن تتراوح قيمتا x وy بين 0 و1، شاملة.

ويمكن أن تتضمّن كل مجموعة 100 منتج كحدّ أقصى. ومع ذلك، بالنسبة إلى صور للتسوّق، ننصحك بتحديد إحداثيات لا تزيد عن 10 صور منتج لكل صورة لضمان توفُّر مساحة كافية في الصورة لعرض وسائل شرح المنتجات. تشير رسالة الأشكال البيانية offerId يجب أن يتطابق الحقل الذي يُعد جزءًا من كائن featuredProduct مع offerId في المورد products، والتي تختلف عن قيمة id في المرجع products

بالإضافة إلى الحقلَين imageLink وfeaturedProduct، يكونان مطلوبَين. بالنسبة إلى "الصور للتسوّق"، يمكنك أيضًا تحديد عنوان مجموعة باستخدام حقل headline الاختياري. نوصي بتضمين عنوان لتقديمه العملاء مع تقديم تفاصيل إضافية حول المجموعة.

نقطة رئيسية: يقبل الحقل "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"
}

تحذير: في حال وجود مجموعة تحمل id نفسها، سيتم تقديم طلب إلى تستبدل collections.insert المورد بالكامل.

مثال: التحقّق من حالة مجموعة

لاكتشاف ما إذا كانت المجموعة التي أنشأتها أعلاه بها مشاكل من شأنها إلغاء صلاحية المجموعة من عرض الإعلانات، يمكنك تقديم طلب 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"
    }
  ]
}