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

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

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

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

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

  • collections: इसकी मदद से, प्रॉडक्ट के कलेक्शन पाए जा सकते हैं, उनकी सूची बनाई जा सकती है, उन्हें जोड़ा जा सकता है, और मिटाया जा सकता है.

  • collectionstatuses: इससे आपको कलेक्शन का स्टेटस देखने और उसकी सूची दिखाने की सुविधा मिलती है. इससे यह पता चलता है कि कलेक्शन में ऐसी समस्याएं हैं या नहीं जिनकी वजह से किसी डेस्टिनेशन के लिए कलेक्शन अमान्य हो सकता है, जैसे कि शॉपिंग विज्ञापन.

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

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

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

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

हर कलेक्शन में ज़्यादा से ज़्यादा 100 प्रॉडक्ट शामिल किए जा सकते हैं. हालांकि, हमारा सुझाव है कि खरीदे जाने वाले सामान की इमेज के लिए, आप हर इमेज में 10 से ज़्यादा प्रॉडक्ट के लिए कोऑर्डिनेट तय करें. इससे यह पक्का हो पाएगा कि प्रॉडक्ट के कॉलआउट दिखाने के लिए इमेज पर काफ़ी जगह हो. featuredProduct ऑब्जेक्ट का offerId फ़ील्ड, 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"
    }
  ]
}