बैच मोड

custombatch का इस्तेमाल insert, get या delete के एक से ज़्यादा प्रॉडक्ट के लिए किया जा सकता है कितना समय लगेगा.

कस्टम बैच एपीआई को कॉल करने के लिए, इस अनुरोध यूआरएल का इस्तेमाल करें:

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

अनुरोध के मुख्य हिस्से में ये पैरामीटर शामिल हैं: batchId, merchantID, और एक method.

productId का इस्तेमाल सिर्फ़ तब करें, जब get या delete को एक्ज़ीक्यूट किया जा रहा हो. productId custombatch के लिए Insert API कॉल के लिए, वैल्यू डालना ज़रूरी नहीं है.

custombatch:insert

इस अनुरोध के यूआरएल का इस्तेमाल, products.custombatch method=insert बनाने के लिए किया जाता है

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

दो नए प्रॉडक्ट जोड़ने के लिए, हर प्रॉडक्ट के लिए batchId तय करें. एपीआई कॉल करने की अनुमति वाले कारोबारी या कंपनी के merchantId और तरीके insert.

यहां दिए गए उदाहरण में, batchId की वैल्यू 1111 और 1112 हैं और हर प्रॉडक्ट के यूनीक आइडेंटिफ़ायर होते हैं. merchantId: 1234567, वह व्यापारी/कंपनी है जिसके पास एपीआई कॉल करने की अनुमति है. साथ ही, यह तरीका है get, delete या insert.

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

Merchant Center में insert दो टी-शर्ट के लिए, JSON फ़ॉर्मैट का सैंपल यहां दिया गया है इस डेटाबेस में सिंगल एपीआई कॉल का इस्तेमाल किया जाता है:

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "product": {
        "kind": "content#product",
        "offerId": "1111111111",

        "title": "Google Tee Black",
        "description": "The Black Google Tee is available in unisex sizing and
        features a retail fit.",
        "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"
        ],
        "includedDestination": [
          "Shopping"
        ]
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "product": {
        "kind": "content#product",
        "offerId": "2222222222",

        "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"
        ],
        "includedDestination": [
          "Shopping"
        ]
      }
    }
  ]
}

एपीआई कॉल पूरा होने पर, HTTP 200 कोड और JSON रिस्पॉन्स मिलता है में डाले गए प्रॉडक्ट शामिल हैं. रिटर्न JSON का फ़ॉर्मैट निम्न के समान है:

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1111,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Tee Black",
    "description": "The Black Google Tee is available in unisex sizing and
    features a retail fit.",
    "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"
    ],
    "includedDestination": [
      "Shopping"
    ]
   }
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1112,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:2222222222",
    "offerId": "2222222222",
    "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"
    ],
    "includedDestination": [
      "Shopping"
    ]
   }
  }
 ]
}

custombatch:get

यह अनुरोध यूआरएल, products.custombatch से कॉल करता है method=get:

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

प्रॉडक्ट पाने के लिए, उस प्रॉडक्ट के लिए खास batchId की जानकारी दें एपीआई कॉल के लिए, व्यापारी/कंपनी का merchantId एपीआई कॉल, get तरीका, और वापस लाए जा रहे प्रॉडक्ट का productId.

दोनों प्रॉडक्ट वापस पाने के लिए, JSON अनुरोध का मुख्य हिस्सा नीचे दिया गया है पिछले custombatch:insert उदाहरण का इस्तेमाल करके शामिल किया गया, जिसके बारे में बताया गया है productId की वैल्यू के हिसाब से. सूची में मौजूद हर आइटम के लिए batchId यूनीक होता है:

{
  "entries": [
    {
      "batchId": 1113,
      "merchantId": 1234567,
      "method": "get",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1114,
      "merchantId": 1234567,
      "method": "get",
      "productId": "online:en:US:2222222222"
    }
  ]
}

यह कॉल एक HTTP 200 कोड और जवाब का यह मुख्य हिस्सा दिखाता है:

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1113,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:1111111111",
    "offerId": "1111111111",
    "title": "Google Tee Black",
    "description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
    "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"
    ],
    "includedDestination": [
      "Shopping"
    ]
   }
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1114,
   "product": {
    "kind": "content#product",
    "id": "online:en:US:2222222222",
    "offerId": "2222222222",
    "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"
    ],
    "includedDestination": [
      "Shopping"
    ]
   }
  }
 ]
}

custombatch:delete

इस अनुरोध यूआरएल का इस्तेमाल products.custombatch बनाने के लिए किया जाता है method=delete:

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

किसी प्रॉडक्ट को मिटाने के लिए, वह batchId बताएं जो इस एपीआई कॉल में मौजूद प्रॉडक्ट के लिए, व्यापारी/कंपनी का merchantId यह एपीआई कॉल करें, तरीका delete, और प्रॉडक्ट का productId हटाया जा रहा है.

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "productId": "online:en:US:2222222222"
    }
  ]
}

यह कॉल, मिटाए गए कोड के लिए HTTP 200 कोड और batchId वैल्यू दिखाता है आइटम:

{
 "kind": "content#productsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1115
  },
  {
   "kind": "content#productsCustomBatchResponseEntry",
   "batchId": 1116
  }
 ]
}