प्रॉडक्ट संसाधन कॉल

products संसाधन इस्तेमाल करने में ज़्यादा सुविधा मिलती है और ज़्यादा कंट्रोल 60 से ज़्यादा प्रॉडक्ट एट्रिब्यूट हैं.ऐसे कई फ़ील्ड हैं जो ज़रूरी हैं, और Google Shopping पर दिखाने के लिए मंज़ूरी पाने के लिए शामिल होना ज़रूरी है. ऐसे कई वैकल्पिक फ़ील्ड हैं जो फ़ील्ड में होने वाले बदलावों स्थितियां, जैसे कि जगह, प्रॉडक्ट का टाइप, प्रॉडक्ट के वैरिएंट, और प्रॉडक्ट बंडल. 60+ वैकल्पिक पैरामीटर के बारे में ज़्यादा जानकारी के लिए, जिन्हें प्रॉडक्ट के लिए कॉन्फ़िगर किया गया है, तो ज़्यादा जानकारी के लिए, प्रॉडक्ट डेटा देखें खास जानकारी.

products संसाधन की मदद से, insert, get, update, और delete को एक-एक किया जा सकता है एक बार में एक प्रॉडक्ट सबमिट करें और Merchant Center के डेटाबेस में मौजूद सभी प्रॉडक्ट के लिए list.

कॉन्टेंट बनाने productstatuses संसाधन का इस्तेमाल, किसी विज्ञापन को मंज़ूरी या अस्वीकार किए जाने की स्थिति देखने के लिए किया जा सकता है किसी डेस्टिनेशन के लिए प्रॉडक्ट. प्रॉडक्ट की स्थिति देखें इस बारे में ज़्यादा जानकारी के लिए, हमारी गाइड पढ़ें. प्रॉडक्ट में डेटा क्वालिटी की समस्याएं हो सकती हैं और वे क्या हो सकती हैं.

एपीआई के अपने उदाहरणों में, हम तीन प्रॉडक्ट का इस्तेमाल करते हैं: दो Google टी-शर्ट और Google कैप. हम नीचे दी गई टेबल में दिखाए गए प्रॉडक्ट डेटा के कम से कम सेट का इस्तेमाल करते हैं, ताकि किसी आइटम को शामिल करने, पाने, अपडेट करने, सूची में जोड़ने, और मिटाने के लिए, products संसाधन कॉल करें अलग-अलग प्रॉडक्ट और उनके बैच के बारे में बताया जाता है.

हमारा सुझाव है कि शिपिंग और टैक्स की जानकारी को कॉन्फ़िगर करें खाते पर लेवल के बजाय एक प्रॉडक्ट लेवल पर.

एक से ज़्यादा सेलर वाले उप-खातों के लिए मार्केटप्लेस, सभी प्रॉडक्ट के लिए ज़रूरी है external_seller_id फ़ील्ड को शामिल करना चाहिए. यहां जाएं: ज़्यादा जानकारी के लिए, प्रॉडक्ट आईडी.

आईडी online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId 1111111111 2222222222 3333333333
title ब्लैक Google टी Google टी ग्रीन Google ट्विल कैप
ब्यौरा ब्लैक Google टी 100% कॉटन से बनी Google टी-शर्ट क्लासिक Google कैप
सामान के ग्रुप का आईडी google_tee google_tee
लिंक http://my.site.com/blacktee http://my.site.com/greentee http://my.site.com/blackhat
स्थिति नए दर्शक नए दर्शक नए दर्शक
कीमत 2,199 रुपये 2,199 रुपये 1,099 रुपये
उपलब्धता स्टॉक में है स्टॉक में है स्टॉक में है
imageLink https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
GTIN 9504000059422 9504000059446 9504000059452
एमपीएन 00638NIC 00638ANG 00638ABC
ब्रैंड Google Google Google
Google प्रॉडक्ट कैटगरी कपड़े और ऐक्सेसरी > कपड़े कपड़े और ऐक्सेसरी > कपड़े कपड़े और ऐक्सेसरी > कपड़ों की ऐक्सेसरी > हैट
रंग काला हरा काला
साइज़ L M M
age_group वयस्क वयस्क वयस्क
लिंग पुरुष पुरुष unisex
included_destination Shopping Actions, शॉपिंग विज्ञापन Shopping Actions, शॉपिंग विज्ञापन 'शॉपिंग' कार्रवाइयां

products.insert

एक प्रॉडक्ट डालने के लिए, नीचे दिए गए अनुरोध यूआरएल का इस्तेमाल करें. इसमें अपने मर्चेंट आईडी और JSON का सैंपल. एक इंसर्ट करने से नया प्रॉडक्ट बन जाता है. अगर वैल्यू channel, contentLanguage, offerId, और एट्रिब्यूट के लिए मौजूद है किसी दिए गए प्रॉडक्ट के लिए feedLabel, यह तरीका उस प्रॉडक्ट को अपडेट करने और उसे बदलने का तरीका बताता है दिए गए प्रॉडक्ट के लिए, पिछले एपीआई कॉल का पूरा डेटा.

वे प्रॉडक्ट जिन्हें सात से ज़्यादा दिन तक सभी डेस्टिनेशन से बाहर रखा जाता है अपने-आप मिट जाएगा.

दिखाए गए उदाहरण में एक नई "ब्लैक Google टी" डाली गई है को कितना फ़ायदा हो रहा है.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert के लिए अनुरोध के मुख्य हिस्से का सैंपल:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

JSON के मुख्य भाग में, प्रॉडक्ट के लिए कस्टम एट्रिब्यूट भी सेट किए जा सकते हैं. उदाहरण के लिए, हम किसी एक प्रॉडक्ट के लिए purchase_quantity_limit सेट कर सकते हैं, ताकि विज्ञापनों को सीमित किया जा सके ग्राहक ऑर्डर किए जा सकने वाले आइटम की संख्या:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

ध्यान दें कि purchase_quantity_limit कस्टम एट्रिब्यूट, खरीदारी की सीमा तय करता है प्रॉडक्ट की परिभाषा के मुताबिक ऑर्डर करता है और फ़ीड भी इसमें काम करता है. कॉन्टेंट बनाने फ़िलहाल, एट्रिब्यूट बीटा वर्शन में है. एपीआई के साथ पूरी तरह काम करने तक ही यह एट्रिब्यूट काम करता है. कोई भी कोई कारोबारी या कंपनी अन्य कस्टम एट्रिब्यूट जोड़ सकती है, लेकिन वह ऐसा नहीं करता किसी खास प्रोसेसिंग से जुड़ी समस्या को हल कर सकता है.

सफल कॉल पर HTTP 200 कोड और जवाब का मुख्य भाग यह होता है शामिल किए गए प्रॉडक्ट संसाधन में सिर्फ़ id, offerId, contentLanguage, feedLabel और channel में जानकारी अपने-आप भरी गई:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Merchant Center के डेटाबेस में किसी खास प्रॉडक्ट की जानकारी पाने के लिए, इसका इस्तेमाल करें products.get. हाल ही में शामिल किए गए प्रॉडक्ट को तैयार होने में कुछ मिनट लग सकते हैं इस कॉल के लिए उपलब्ध है.

इन एचटीटीपी अनुरोध यूआरएल और पैरामीटर, अपने मर्चेंट आईडी और उस प्रॉडक्ट का प्रॉडक्ट आईडी (REST ID फ़ॉर्मैट) जो आपको चाहिए:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

कॉल सफल होने पर, HTTP 200 और "प्रॉडक्ट संसाधन" दिखता है में जवाब का मुख्य हिस्सा. यहां आईडी वाले प्रॉडक्ट से मिले प्रॉडक्ट डेटा का सैंपल दिया गया है online:en:US:1111111111:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

किसी एक प्रॉडक्ट को अपडेट करने के लिए, PATCH तरीके के साथ नीचे दिए गए अनुरोध यूआरएल का इस्तेमाल करें, आपका मर्चेंट आईडी, प्रॉडक्ट आईडी, और JSON बॉडी जिसमें आपका डेटा मौजूद हो को इस प्रॉडक्ट के लिए अपडेट करना है. products.insert के उलट, इसके लिए यह ज़रूरी है सभी लागू फ़ील्ड को उपलब्ध कराना है, products.update के लिए सिर्फ़ यह ज़रूरी है कि वे फ़ील्ड चुनें जिन्हें बदलना है.

किसी एट्रिब्यूट को जोड़ने या उसमें बदलाव करने के लिए, JSON में नई वैल्यू के साथ फ़ील्ड सबमिट करें शरीर. दिखाए गए उदाहरण से, मौजूदा ऐसेट के title और description को अपडेट कर दिया जाएगा "ब्लैक Google टी" अनुरोध के मुख्य हिस्से में दिए गए प्रॉडक्ट डेटा के साथ, अन्य सभी फ़ील्ड में कोई गड़बड़ी नहीं है.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update के लिए अनुरोध के मुख्य हिस्से का सैंपल:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

products.update अनुरोध की मदद से, सिर्फ़ टॉप-लेवल फ़ील्ड को अपडेट किया जा सकता है. अगर आपको नेस्ट किए गए फ़ील्ड अपडेट करने हैं, तो आपको पूरा टॉप-लेवल ऑब्जेक्ट देना होगा.

दिखाए गए उदाहरण से, टॉप लेवल का salePrice ऑब्जेक्ट अपडेट होगा. इसमें नेस्ट किया गया ऑब्जेक्ट भी शामिल होगा में दिए गए प्रॉडक्ट डेटा के साथ अनुरोध का मुख्य भाग, अन्य सभी फ़ील्ड को छोड़ देता है.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

दूसरे फ़ील्ड में बदलाव किए बिना, अपडेट करने के लिए कुछ फ़ील्ड चुनने के लिए अनुरोध के मुख्य हिस्से में, updateMask तय किया जा सकता है. यह क्वेरी स्ट्रिंग पैरामीटर, कॉमा लगाकर अलग किए गए उन फ़ील्ड की सूची होनी चाहिए जिनमें आपको बदलाव करना है. updateMask तब काम आता है, जब आपको यह दावा करना हो कि सिर्फ़ नाम वाले फ़ील्ड में को अपडेट कर दिया जाएगा. updateMask तय न करना, सभी को मार्क करने जैसा ही है को अपडेट करने के अनुरोध के फ़ील्ड को, जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है.

दिखाया गया उदाहरण सिर्फ़ description और availability को अपडेट करेगा एक मौजूदा "Black Google Tee" के तौर पर में दिए गए संबंधित प्रॉडक्ट डेटा के साथ अनुरोध के मुख्य हिस्से में, title के साथ-साथ अन्य सभी फ़ील्ड शामिल नहीं होंगे.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update के लिए अनुरोध के मुख्य हिस्से का सैंपल:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

अगर किसी फ़ील्ड की जानकारी updateMask सूची में दी गई है, लेकिन अनुरोध के मुख्य हिस्से में नहीं है, तो Product संसाधन मौजूद होने पर, उस फ़ील्ड को इससे मिटा दिया जाएगा.

दिखाए गए उदाहरण में, फ़ील्ड की वैल्यू हटाने के लिए, updateMask का इस्तेमाल किया जाएगा salePrice.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

सैंपल अनुरोध के मुख्य हिस्से में, salePrice फ़ील्ड शामिल नहीं होना चाहिए, ताकि उसे हटा दें. आप चाहें तो कोई बॉडी या खाली शरीर भी न दें. अन्य फ़ील्ड में हालांकि, अगर वे updateMask में न दिखें, तो उनके साथ कोई बदलाव नहीं किया जाएगा.

products.custombatch के अनुरोध में updateMask का इस्तेमाल करने के लिए, updateMask इसे अनुरोध के मुख्य भाग में शामिल किया जाना चाहिए.

दिखाए गए उदाहरण से, मौजूदा ऐसेट के price और availability को अपडेट कर दिया जाएगा "ब्लैक Google टी" दिए गए प्रॉडक्ट डेटा के साथ products.custombatch का इस्तेमाल किया जा रहा है बैच एंट्री में, title और description को छोड़कर, अन्य सभी फ़ील्ड को छोड़ा जा रहा है कोई दिक्कत नहीं है.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

किसी एक प्रॉडक्ट को मिटाने के लिए, सैंपल एचटीटीपी अनुरोध के साथ products.delete का इस्तेमाल करें यूआरएल, आपका मर्चेंट ID और प्रॉडक्ट आईडी (REST ID फ़ॉर्मैट में जैसे कि online:en:US:1111111111) जोड़ें:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

सही जवाब देने पर, HTTP Status 204 में रिस्पॉन्स के तौर पर कोई मुख्य हिस्सा नहीं दिखता.

products.list

products.list में, ऐसे सभी प्रॉडक्ट की सूची होती है जो व्यापारी/कंपनी/कारोबारी के Merchant Center में उपलब्ध हैं डेटाबेस. इस अनुरोध यूआरएल का इस्तेमाल करें:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

कॉल पूरा होने पर, इसमें मौजूद प्रॉडक्ट के लिए HTTP 200 और JSON डेटा, "संसाधन" बटन दबाएं.

उदाहरण के तौर पर, ये तीन प्रॉडक्ट दिखाए गए हैं:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}
पीछे जाएं
प्रॉडक्ट ID
आगे बढ़ें
बैच मोड