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

مجموعه‌های محصولات به شما امکان می‌دهند گروه‌هایی از محصولات را برای استفاده با قالب‌های غنی، مانند تصاویر قابل خرید، تعریف کنید. هر مجموعه می‌تواند شامل حداکثر ۱۰۰ محصول باشد. می‌توانید یک مجموعه را با مرکز فروشندگان گوگل یا API محتوا ایجاد کنید.

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

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

رابط برنامه‌نویسی کاربردی محتوا (Content API) شامل دو سرویس برای مدیریت مجموعه محصولات است:

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

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

مثال: ایجاد مجموعه‌ای برای تصاویر قابل خرید (Shoppable Images)

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

برای استفاده از تصاویر قابل خرید، باید مجموعه‌ای از محصولات ایجاد کنید و از فیلد imageLink برای تعیین تصویری که حداکثر ده محصول را در خود جای دهد، استفاده کنید. توصیه می‌کنیم از تصاویر مربعی (با نسبت ابعاد ۱:۱) استفاده کنید.

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

هر مجموعه می‌تواند حداکثر شامل ۱۰۰ محصول باشد. با این حال، برای تصاویر قابل خرید (Shoppable Images)، توصیه می‌کنیم مختصات را برای حداکثر ۱۰ محصول در هر تصویر مشخص کنید تا اطمینان حاصل شود که فضای کافی روی تصویر برای نمایش توضیحات محصول وجود دارد. فیلد offerId که بخشی از شیء featuredProduct است باید با مقدار offerId در منبع products مطابقت داشته باشد، که با مقدار id در منبع products متفاوت است.

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

برای ایجاد یک مجموعه جدید برای تصاویر Shoppable، با استفاده از 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"
    }
  ]
}