مجموعه های محصولات

مجموعه‌های محصولات به شما امکان می‌دهند گروه‌هایی از محصولات را برای استفاده با قالب‌های غنی، مانند تصاویر قابل خرید، تعریف کنید. هر مجموعه می تواند تا 100 محصول را شامل شود. می‌توانید یک مجموعه با Google Merchant Center یا Content API ایجاد کنید.

این راهنما نحوه استفاده از مجموعه‌های محصول از طریق Content API را نشان می‌دهد، از جمله مثال‌هایی برای نحوه ایجاد یک مجموعه برای Shoppable Images و نحوه بررسی وضعیت یک مجموعه.

از مجموعه محصولات استفاده کنید

Content API شامل دو سرویس برای مدیریت مجموعه محصولات است:

  • collections : به شما امکان می دهد مجموعه های محصول را دریافت، فهرست، درج و حذف کنید.

  • collectionstatuses : به شما امکان می‌دهد وضعیت مجموعه‌ها را دریافت و فهرست کنید تا ببینید آیا مجموعه‌ای دارای مشکلاتی است که ممکن است باعث نامعتبر بودن مجموعه برای یک مقصد شود، مانند تبلیغات خرید .

مثال: مجموعه ای برای تصاویر قابل خرید ایجاد کنید

تصاویر قابل خرید، تصاویر با کیفیتی هستند که یک یا چند محصول حاشیه نویسی شده را نشان می دهند و با استفاده از مجموعه ها پیکربندی می شوند. برای استفاده از Shoppable Images، باید مقادیری را برای فیلدهای imageLink و featuredProduct به اضافه فیلدهای مورد نیاز برای همه مجموعه‌ها مشخص کنید. برای اطلاعات بیشتر در مورد فیلدهای الزامی، به مستندات مرجع Content API مراجعه کنید.

برای استفاده از Shoppable Images، باید مجموعه ای از محصولات ایجاد کنید و از فیلد imageLink برای تعیین تصویری که حداکثر ده محصول را شامل می شود، استفاده کنید. توصیه می کنیم از تصاویر مربعی (با نسبت تصویر 1:1) استفاده کنید.

همچنین باید محصولات نمایش داده شده در تصویر را با استفاده از فیلد featuredProduct از جمله مختصات محصولات موجود در تصویر با استفاده از فیلدهای x و y مشخص کنید. این فیلدها فقط برای مجموعه‌هایی که با تصاویر قابل خرید استفاده می‌شوند لازم است. مقادیر x و y باید بین 0 و 1 باشد.

هر مجموعه حداکثر می تواند شامل 100 محصول باشد. با این حال، برای Shoppable Images، توصیه می‌کنیم مختصاتی را برای حداکثر 10 محصول در هر تصویر مشخص کنید تا مطمئن شوید که فضای کافی روی تصویر برای نمایش پیام‌های محصول وجود دارد. فیلد offerId که بخشی از شی featuredProduct است باید با مقدار offerId در منبع products مطابقت داشته باشد که با مقدار id موجود در منبع products متفاوت است.

علاوه بر فیلدهای imageLink و featuredProduct که برای تصاویر قابل خرید لازم است، می توانید با استفاده از فیلد headline اختیاری، عنوان مجموعه را نیز مشخص کنید. توصیه می کنیم یک عنوان برای ارائه جزئیات بیشتر در مورد مجموعه به مشتریان ارائه دهید.

برای ایجاد یک مجموعه جدید برای Shoppable Images، با استفاده از URL و بدنه درخواست زیر، یک درخواست POST به نقطه پایانی collections.insert کنید:

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"
}

مثال: وضعیت یک مجموعه را بررسی کنید

برای کشف اینکه آیا مجموعه ای که در بالا ایجاد کردید دارای مشکلاتی است که مجموعه را از ارائه تبلیغات بی اعتبار می کند، با استفاده از URL زیر، یک درخواست GET به نقطه پایانی collectionsstatuses.get ارسال کنید و 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"
    }
  ]
}