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

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

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

ध्यान दें: फ़िलहाल, खरीदे जाने वाले सामान की इमेज वाला विज्ञापन फ़ॉर्मैट ही ऐसा है जो कलेक्शन के साथ काम करता है. हालांकि, अन्य फ़ॉर्मैट भी जोड़े जा सकते हैं, ताकि अलग-अलग विज्ञापन फ़ॉर्मैट में अपनी कलेक्शन का फिर से इस्तेमाल किया जा सके.

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

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

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

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

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

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

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

अहम जानकारी: कलेक्शन के लिए imageLink फ़ील्ड, इमेज के लिंक की वैल्यू की एक ऐरे स्वीकार करता है. हालांकि, खरीदे जाने वाले सामान की इमेज के फ़ॉर्मैट के लिए, ऐरे में मौजूद सिर्फ़ पहली वैल्यू का इस्तेमाल किया जाता है.

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

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

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

अहम जानकारी: कलेक्शन के लिए headline फ़ील्ड, हेडलाइन की वैल्यू के कलेक्शन को स्वीकार करता है. हालांकि, खरीदे जाने वाले सामान की इमेज के फ़ॉर्मैट के लिए, ऐरे में मौजूद सिर्फ़ पहली वैल्यू का इस्तेमाल किया जाता है.

खरीदे जाने वाले सामान की इमेज के लिए नया कलेक्शन बनाने के लिए, यहां दिए गए यूआरएल और अनुरोध के मुख्य हिस्से का इस्तेमाल करके, POST एंडपॉइंट को 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"
}

चेतावनी: अगर एक ही id वाला कोई कलेक्शन मौजूद है, तो collections.insert के लिए अनुरोध करने पर, संसाधन पूरी तरह से बदल जाएगा.

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

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