ব্যাচ মোড

আপনি custombatch ব্যবহার করে একটিমাত্র এপিআই কলে একসাথে একাধিক প্রোডাক্ট insert , get বা delete পারেন।

কাস্টম ব্যাচ এপিআই-গুলোতে কল করার জন্য নিম্নলিখিত রিকোয়েস্ট ইউআরএলটি ব্যবহার করুন:

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

অনুরোধের বডিতে নির্দিষ্ট প্যারামিটার থাকে: batchId , merchantID এবং একটি method ।

শুধুমাত্র get বা delete অপারেশন চালানোর সময় productId ব্যবহার করুন। custombatch এর insert API কলে productId প্রয়োজন হয় না।

কাস্টমব্যাচ: সন্নিবেশ

products.custombatch method=insert করার জন্য নিম্নলিখিত রিকোয়েস্ট URL ব্যবহার করা হয়।

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

নতুন দুটি পণ্য যোগ করার জন্য, প্রতিটি পণ্যের batchId , API কল করার জন্য অনুমোদিত মার্চেন্টের merchantId এবং insert মেথডটি উল্লেখ করুন।

নিম্নলিখিত উদাহরণে, batchId মান যথাক্রমে 1111 এবং 1112 , এবং এগুলো প্রতিটি পণ্যের জন্য অনন্য শনাক্তকারী। merchantId: 1234567 হলো সেই মার্চেন্ট যিনি API কল করার জন্য অনুমোদিত, এবং মেথডটি হলো get , delete , বা insert ।

insert একটি নতুন প্রোডাক্ট তৈরি করে। যদি কোনো নির্দিষ্ট প্রোডাক্টের জন্য channel , contentLanguage , offerId এবং feedLabel অ্যাট্রিবিউটগুলোতে ভ্যালু বিদ্যমান থাকে, তাহলে এই মেথডটি এন্ট্রিটি আপডেট করে এবং প্রোডাক্টটির জন্য পূর্ববর্তী API কলগুলোর সমস্ত ডেটা প্রতিস্থাপন করে।

একটিমাত্র এপিআই কল ব্যবহার করে মার্চেন্ট সেন্টার ডেটাবেসে দুটি টি-শার্ট 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"
    ]
   }
  }
 ]
}

কাস্টমব্যাচ:গেট

নিম্নলিখিত অনুরোধ URL-টি method=get ব্যবহার করে products.custombatch কল করে:

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

কোনো পণ্য পেতে, এপিআই কলের জন্য পণ্যটির অনন্য batchId , এপিআই কল করার জন্য অনুমোদিত মার্চেন্টের merchantId , get মেথড এবং যে পণ্যটি আনা হচ্ছে তার productId উল্লেখ করুন।

পূর্ববর্তী custombatch:insert উদাহরণ ব্যবহার করে সন্নিবেশিত দুটি পণ্য, যা তাদের productId মান দ্বারা নির্দিষ্ট করা হয়েছে, তা পুনরুদ্ধার করার জন্য নিম্নলিখিতটি একটি নমুনা JSON অনুরোধ বডি। তালিকার প্রতিটি আইটেমের জন্য 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"
    ]
   }
  }
 ]
}

কাস্টমব্যাচ:মুছে ফেলুন

নিম্নলিখিত রিকোয়েস্ট URL-টি method=delete সহ products.custombatch তৈরি করতে ব্যবহৃত হয়:

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

কোনো পণ্য মুছে ফেলার জন্য, এই API কলের মধ্যে পণ্যটির নিজস্ব batchId , এই API কলটি করার জন্য অনুমোদিত মার্চেন্টের 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
  }
 ]
}