प्रॉडक्ट कलेक्शन

प्रॉडक्ट कलेक्शन की मदद से, प्रॉडक्ट के ग्रुप तय किए जा सकते हैं. इनका इस्तेमाल, खरीदे जाने वाले सामान की इमेज जैसे रिच फ़ॉर्मैट के साथ किया जा सकता है. हर कलेक्शन में ज़्यादा से ज़्यादा 100 प्रॉडक्ट शामिल किए जा सकते हैं. Google Merchant Center या Content API की मदद से, कलेक्शन बनाया जा सकता है.

इस गाइड में, Content API की मदद से प्रॉडक्ट कलेक्शन का इस्तेमाल करने का तरीका बताया गया है. इसमें, खरीदे जाने वाले सामान की इमेज के लिए कलेक्शन बनाने और कलेक्शन की स्थिति देखने के तरीके के उदाहरण भी शामिल हैं.

प्रॉडक्ट कलेक्शन का इस्तेमाल करना

Content API में, प्रॉडक्ट कलेक्शन को मैनेज करने के लिए दो सेवाएं शामिल हैं:

उदाहरण: खरीदे जाने वाले सामान की इमेज के लिए कलेक्शन बनाना

खरीदे जाने वाले सामान की इमेज, अच्छी क्वालिटी की ऐसी इमेज होती हैं जिनमें एक या उससे ज़्यादा प्रॉडक्ट की जानकारी होती है. इन्हें कलेक्शन का इस्तेमाल करके कॉन्फ़िगर किया जाता है. खरीदे जाने वाले सामान की इमेज का इस्तेमाल करने के लिए, आपको सभी कलेक्शन के लिए ज़रूरी फ़ील्ड के अलावा, imageLink और featuredProduct फ़ील्ड के लिए वैल्यू तय करनी होंगी. ज़रूरी फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, Content API के रेफ़रंस से जुड़ा दस्तावेज़ देखें.

खरीदे जाने वाले सामान की इमेज का इस्तेमाल करने के लिए, आपको प्रॉडक्ट का कलेक्शन बनाना होगा. साथ ही, imageLink फ़ील्ड का इस्तेमाल करके, ऐसी इमेज तय करनी होगी जिसमें ज़्यादा से ज़्यादा 10 प्रॉडक्ट शामिल हों. हमारा सुझाव है कि आप स्क्वेयर इमेज (1:1 आसपेक्ट रेशियो वाली इमेज) का इस्तेमाल करें.

आपको featuredProduct फ़ील्ड का इस्तेमाल करके, इमेज में दिखने वाले प्रॉडक्ट भी तय करने होंगे. साथ ही, x और y फ़ील्ड का इस्तेमाल करके, इमेज में प्रॉडक्ट के कोऑर्डिनेट (निर्देशांक) भी तय करने होंगे. ये फ़ील्ड सिर्फ़ उन कलेक्शन के लिए ज़रूरी हैं जिनका इस्तेमाल, खरीदे जाने वाले सामान की इमेज के साथ किया जाता है. x और y की वैल्यू, 0 से 1 के बीच होनी चाहिए. इसमें 0 और 1 भी शामिल हैं.

हर कलेक्शन में ज़्यादा से ज़्यादा 100 प्रॉडक्ट शामिल किए जा सकते हैं. हालांकि, खरीदे जाने वाले सामान की इमेज के लिए, हमारा सुझाव है कि हर इमेज के लिए 10 से ज़्यादा प्रॉडक्ट के कोऑर्डिनेट तय न करें. इससे यह पक्का किया जा सकेगा कि इमेज पर प्रॉडक्ट के कॉल आउट दिखाने के लिए, काफ़ी जगह हो. offerId फ़ील्ड की वैल्यू, featuredProduct ऑब्जेक्ट का हिस्सा होती है. यह वैल्यू, products संसाधन पर मौजूद offerId वैल्यू से मेल खानी चाहिए. यह products संसाधन पर मौजूद id वैल्यू से अलग होती है.

खरीदे जाने वाले सामान की इमेज के लिए, imageLink और featuredProduct फ़ील्ड ज़रूरी हैं. इनके अलावा, वैकल्पिक headline फ़ील्ड का इस्तेमाल करके, कलेक्शन की हेडलाइन भी तय की जा सकती है. हमारा सुझाव है कि आप हेडलाइन शामिल करें, ताकि ग्राहकों को कलेक्शन के बारे में ज़्यादा जानकारी मिल सके.

खरीदे जाने वाले सामान की इमेज के लिए नया कलेक्शन बनाने के लिए, यहां दिए गए यूआरएल और अनुरोध के मुख्य हिस्से का इस्तेमाल करके, collections.insert एंडपॉइंट पर POST अनुरोध करें:

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

उदाहरण: कलेक्शन की स्थिति देखना

यह जानने के लिए कि ऊपर बनाए गए कलेक्शन में कोई समस्या है या नहीं, यहां दिए गए यूआरएल का इस्तेमाल करके, collectionsstatuses.get एंडपॉइंट पर 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"
    }
  ]
}