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

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

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

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

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

  • collections: इससे आपको प्रॉडक्ट के संग्रह पाने, उन्हें सूची में जोड़ने, उन्हें डालने, और उन्हें मिटाने की सुविधा मिलती है.

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

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

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

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

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

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

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

खरीदे जाने वाले सामान की इमेज का नया कलेक्शन बनाने के लिए, 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"
}

उदाहरण: कलेक्शन का स्टेटस देखना

यह पता लगाने के लिए कि आपने ऊपर जो संग्रह बनाया है उसमें ऐसी समस्याएं हैं या नहीं जिनकी वजह से विज्ञापन पेश करने से संग्रह को अमान्य करने दें, तो एक 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"
    }
  ]
}