শিপিং সেটিংস

shippingsettings রিসোর্সটি আপনাকে আপনার মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট (MCA) এবং এর সাথে যুক্ত সমস্ত সাব-অ্যাকাউন্টের শিপিং সেটিংস পুনরুদ্ধার ও আপডেট করার সুযোগ দেয়।

এমসিএ সাধারণত ইন্টিগ্রেটর, অ্যাগ্রিগেটর এবং চ্যানেল পার্টনাররা ব্যবহার করেন, যারা একাধিক মার্চেন্টের জন্য অনলাইন স্টোর ও এপিআই পরিষেবা পরিচালনা করেন। যেসব মার্চেন্টের একাধিক অনলাইন স্টোর বা ব্র্যান্ড রয়েছে এবং সেগুলো আলাদা আলাদা ওয়েবসাইটে বিক্রি হয়, তারাও একটিমাত্র এমসিএ-এর অধীনে সাব-অ্যাকাউন্ট রাখার সিদ্ধান্ত নিতে পারেন।

গুগল কিছু পণ্যের আনুমানিক ডেলিভারির সময় স্বয়ংক্রিয়ভাবে আপডেট করতে পারে। আরও বিস্তারিত জানতে ‘স্বয়ংক্রিয় উন্নতি সক্ষম করুন’ দেখুন।

শিপিং সেটিংস.তালিকা

shippingsettings.list কলটি একটি অ্যাকাউন্টের সমস্ত শিপিং রিসোর্স তথ্য ফেরত দেয়, অথবা যদি এটি একটি MCA অ্যাকাউন্ট হয়, তাহলে সমস্ত সাব-অ্যাকাউন্টের তথ্য ফেরত দেয়।

shippingsettings.list মেথডের জন্য উদাহরণ URL:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings

নিম্নলিখিতটি একটি MCA অ্যাকাউন্টের সাব-অ্যাকাউন্ট 1111 এবং 2222 এর শিপিং সেটিংস প্রদর্শনকারী একটি নমুনা JSON প্রতিক্রিয়া:

{
 "kind": "content#shippingsettingsListResponse",
 "resources": [
  {
   "accountId": "1111",
   "services": [
    {
     "name": "Standard Shipping",
     "active": true,
     "deliveryCountry": "US",
     "currency": "USD",
     "deliveryTime": {
      "minHandlingTimeInDays": 0,
      "maxHandlingTimeInDays": 1,
      "transitTimeTable": {
       "postalCodeGroupNames": [
        "Region1",
        "Region2",
        "all other locations"
       ],
       "transitTimeLabels": [
        "all other labels"
       ],
       "rows": [
        {
         "values": [
          {
           "minTransitTimeInDays": 1,
           "maxTransitTimeInDays": 2
          }
         ]
        },
        {
         "values": [
          {
           "minTransitTimeInDays": 2,
           "maxTransitTimeInDays": 3
          }
         ]
        },
        {
         "values": [
          {
           "minTransitTimeInDays": 3,
           "maxTransitTimeInDays": 5
          }
         ]
        }
       ]
      }
     },
     "rateGroups": [
      {
       "singleValue": {
        "flatRate": {
         "value": "0",
         "currency": "USD"
        }
       },
       "name": "Standard Shipping"
      }
     ],
     "eligibility": "All scenarios"
    },
    {
     "name": "Expedited",
     "active": true,
     "deliveryCountry": "US",
     "currency": "USD",
     "deliveryTime": {
      "minTransitTimeInDays": 2,
      "maxTransitTimeInDays": 2,
      "minHandlingTimeInDays": 0,
      "maxHandlingTimeInDays": 1
     },
     "rateGroups": [
      {
       "singleValue": {
        "flatRate": {
         "value": "9.99",
         "currency": "USD"
        }
       },
       "name": "Expedited"
      }
     ],
     "eligibility": "All scenarios"
    }
   ],
   "postalCodeGroups": [
    {
     "name": "Region1",
     "country": "US",
     "postalCodeRanges": [
      {
       "postalCodeRangeBegin": "94035",
       "postalCodeRangeEnd": "94070"
      }
     ]
    },
    {
     "name": "Region2",
     "country": "US",
     "postalCodeRanges": [
      {
       "postalCodeRangeBegin": "94071",
       "postalCodeRangeEnd": "94082"
      }
     ]
    }
   ]
  },
  {
   "accountId": "2222",
   "services": [
    {
     "name": "FedEx",
     "active": true,
     "deliveryCountry": "US",
     "currency": "USD",
     "deliveryTime": {
      "minTransitTimeInDays": 4,
      "maxTransitTimeInDays": 6,
      "minHandlingTimeInDays": 0,
      "maxHandlingTimeInDays": 0
     },
     "rateGroups": [
      {
       "singleValue": {
        "flatRate": {
         "value": "5.99",
         "currency": "USD"
        }
       },
       "name": "All products"
      }
     ],
     "eligibility": "All scenarios except Shopping Actions"
    },
    {
     "name": "GSA Shipping - Free Ship Over $49.99",
     "active": true,
     "deliveryCountry": "US",
     "currency": "USD",
     "deliveryTime": {
      "minTransitTimeInDays": 3,
      "maxTransitTimeInDays": 7,
      "minHandlingTimeInDays": 1,
      "maxHandlingTimeInDays": 2
     },
     "rateGroups": [
      {
       "mainTable": {
        "rowHeaders": {
         "prices": [
          {
           "value": "49.99",
           "currency": "USD"
          },
          {
           "value": "infinity",
           "currency": "USD"
          }
         ]
        },
        "rows": [
         {
          "cells": [
           {
            "flatRate": {
             "value": "6.99",
             "currency": "USD"
            }
           }
          ]
         },
         {
          "cells": [
           {
            "flatRate": {
             "value": "0",
             "currency": "USD"
            }
           }
          ]
         }
        ]
       },
       "name": "Free Ship Over $49.99"
      }
     ],
     "eligibility": "Shopping Actions"
    }
   ]
  }
 ]
}

শিপিং সেটিংস.গেট

shippingsettings.get কলটি একটি MCA অ্যাকাউন্টকে একটি একক সাব-অ্যাকাউন্টের শিপিং সেটিংসের তথ্য পেতে, অথবা একটি স্বতন্ত্র অ্যাকাউন্টকে তার নিজস্ব অ্যাকাউন্টের স্থিতির তথ্য পেতে অনুমতি দেয়।

শিপিং সেটিংসের তথ্য পেতে নিম্নলিখিত কলটি ব্যবহার করুন, যেখানে merchantId হলো MCA অ্যাকাউন্ট নম্বর এবং accountId হলো এর সাব-অ্যাকাউন্ট। যদি মার্চেন্ট সেন্টার অ্যাকাউন্টটি একটি মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট না হয়, তবুও shippingsettings.get শিপিং সেটিংসের তথ্য ফেরত দিতে পারে। এই ক্ষেত্রে, merchantId এবং accountId উভয় প্যারামিটারের জন্য একই মার্চেন্ট সেন্টার অ্যাকাউন্ট নম্বর ব্যবহার করুন।

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

list কলের জন্য ব্যবহৃত MCA অ্যাকাউন্ট থেকে Standard এবং Expedited শিপিং পরিষেবা কনফিগার করা একটি সাব-অ্যাকাউন্টের জন্য নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া:

{
 "accountId": "1111",
 "services": [
  {
   "name": "Standard Shipping",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minHandlingTimeInDays": 0,
    "maxHandlingTimeInDays": 1,
    "transitTimeTable": {
     "postalCodeGroupNames": [
      "Region1",
      "Region2",
      "all other locations"
     ],
     "transitTimeLabels": [
      "all other labels"
     ],
     "rows": [
      {
       "values": [
        {
         "minTransitTimeInDays": 1,
         "maxTransitTimeInDays": 2
        }
       ]
      },
      {
       "values": [
        {
         "minTransitTimeInDays": 2,
         "maxTransitTimeInDays": 3
        }
       ]
      },
      {
       "values": [
        {
         "minTransitTimeInDays": 3,
         "maxTransitTimeInDays": 5
        }
       ]
      }
     ]
    }
   },
   "rateGroups": [
    {
     "singleValue": {
      "flatRate": {
       "value": "0",
       "currency": "USD"
      }
     },
     "name": "Standard Shipping"
    }
   ],
   "eligibility": "All scenarios"
  },
  {
   "name": "Expedited",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minTransitTimeInDays": 2,
    "maxTransitTimeInDays": 2,
    "minHandlingTimeInDays": 0,
    "maxHandlingTimeInDays": 1
   },
   "rateGroups": [
    {
     "singleValue": {
      "flatRate": {
       "value": "9.99",
       "currency": "USD"
      }
     },
     "name": "Expedited"
    }
   ],
   "eligibility": "All scenarios"
  }
 ],
 "postalCodeGroups": [
  {
   "name": "Region1",
   "country": "US",
   "postalCodeRanges": [
    {
     "postalCodeRangeBegin": "94035",
     "postalCodeRangeEnd": "94070"
    }
   ]
  },
  {
   "name": "Region2",
   "country": "US",
   "postalCodeRanges": [
    {
     "postalCodeRangeBegin": "94071",
     "postalCodeRangeEnd": "94082"
    }
   ]
  }
 ]
}

শিপিং সেটিংস আপডেট

shippingsettings.update কলটি একটি MCA অ্যাকাউন্টকে একটি একক সাব-অ্যাকাউন্ট বা একটি স্বতন্ত্র অ্যাকাউন্টের শিপিং সেটিংসের তথ্য আপডেট করার সুযোগ দেয়।

PUT https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

নিম্নলিখিতটি হলো MCA মার্চেন্ট আইডি 10 -এর অন্তর্গত অ্যাকাউন্ট আইডি 2222 এর সাব-অ্যাকাউন্টের জন্য GSA Shipping - Free Ship Over $49.99 পরিষেবার ক্ষেত্রে maxTransitTimeInDays 7 এ আপডেট করার একটি নমুনা JSON অনুরোধ বডি।

{
...
    "services": [
      {
        "name": "FedEx",
        "active": true,
        "deliveryCountry": "US",
        "currency": "USD",
        "deliveryTime": {
          "minTransitTimeInDays": 4,
          "maxTransitTimeInDays": 6,
          "minHandlingTimeInDays": 0,
          "maxHandlingTimeInDays": 0
        },
        "rateGroups": [
          {
            "singleValue": {
              "flatRate": {
                "value": "5.99",
                "currency": "USD"
              }
            },
            "name": "All products"
          }
        ],
        "eligibility": "All scenarios except Shopping Actions"
      },
      {
        "name": "GSA Shipping - Free Ship Over $49.99",
        "active": true,
        "deliveryCountry": "US",
        "currency": "USD",
        "deliveryTime": {
          "minTransitTimeInDays": 3,
          "maxTransitTimeInDays": 7,
          "minHandlingTimeInDays": 1,
          "maxHandlingTimeInDays": 2
        },
        "rateGroups": [
          {
            "mainTable": {
              "rowHeaders": {
                "prices": [
                  {
                    "value": "49.99",
                    "currency": "USD"
                  },
                  {
                    "value": "infinity",
                    "currency": "USD"
                  }
                ]
              },
              "rows": [
                {
                  "cells": [
                    {
                      "flatRate": {
                        "value": "6.99",
                        "currency": "USD"
                      }
                    }
                  ]
                },
                {
                  "cells": [
                    {
                      "flatRate": {
                        "value": "0",
                        "currency": "USD"
                      }
                    }
                  ]
                }
              ]
            },
            "name": "Free Ship Over $49.99"
          }
        ],
        "eligibility": "Shopping Actions"
      }
    ]
  }
}

নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া বডি:

{
 "accountId": "2222",
 "services": [
  {
   "name": "FedEx",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minTransitTimeInDays": 4,
    "maxTransitTimeInDays": 6,
    "minHandlingTimeInDays": 0,
    "maxHandlingTimeInDays": 0
   },
   "rateGroups": [
    {
     "singleValue": {
      "flatRate": {
       "value": "5.99",
       "currency": "USD"
      }
     },
     "name": "All products"
    }
   ],
   "eligibility": "All scenarios except Shopping Actions"
  },
  {
   "name": "GSA Shipping - Free Ship Over $49.99",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minTransitTimeInDays": 3,
    "maxTransitTimeInDays": 7,
    "minHandlingTimeInDays": 1,
    "maxHandlingTimeInDays": 2
   },
   "rateGroups": [
    {
     "mainTable": {
      "rowHeaders": {
       "prices": [
        {
         "value": "49.99",
         "currency": "USD"
        },
        {
         "value": "infinity",
         "currency": "USD"
        }
       ]
      },
      "rows": [
       {
        "cells": [
         {
          "flatRate": {
           "value": "6.99",
           "currency": "USD"
          }
         }
        ]
       },
       {
        "cells": [
         {
          "flatRate": {
           "value": "0",
           "currency": "USD"
          }
         }
        ]
       }
      ]
     },
     "name": "Free Ship Over $49.99"
    }
   ],
   "eligibility": "Shopping Actions"
  }
 ]
}

শিপিংসেটিংস.কাস্টমব্যাচ

shippingsettings.custombatch কলটি একটি মাল্টি-ক্লায়েন্ট অ্যাকাউন্টের একাধিক সাব-অ্যাকাউন্টের জন্য শিপিং সেটিংসের তথ্য পুনরুদ্ধার বা আপডেট করে।

JSON অনুরোধটিতে MCA অ্যাকাউন্ট নম্বরের merchantId , সাব-অ্যাকাউন্টের accountId , একটি অনন্য batchId অন্তর্ভুক্ত থাকে এবং শিপিং সেটিংস পুনরুদ্ধার করার জন্য get ও শিপিং সেটিংস পরিবর্তন করার জন্য update method সেট করা থাকে।

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

নিম্নলিখিত নমুনা JSON অনুরোধ বডিতে দুটি অংশ রয়েছে:

  1. অ্যাকাউন্ট আইডি 1111 এর শিপিং সেটিংস পুনরুদ্ধার করতে batchId=1 ব্যবহৃত হয়।
  2. batchId=2 , শিপিং সার্ভিস GSA Shipping - Free Ship Over $49.99 এর জন্য maxTransitTimeInDays 8 এ আপডেট করতে ব্যবহৃত হয়। ( shippingsettings.update এর জন্য পূর্ববর্তী রেসপন্স বডি উদাহরণে দেখানো অ্যাকাউন্ট আইডি 2222 এর জন্য এই সেটিংটি 7 থেকে পরিবর্তন করা হয়েছিল)। 
{
  "entries": [
    {
      "accountId": 1111,
      "merchantId": 10,
      "method": "get",
      "batchId": 1
    },
    {
      "accountId": 2222,
      "merchantId": 10,
      "method": "update",
      "batchId": 2,
      "shippingSettings": {
        "services": [
          {
            "name": "FedEx",
            "active": true,
            "deliveryCountry": "US",
            "currency": "USD",
            "deliveryTime": {
              "minTransitTimeInDays": 4,
              "maxTransitTimeInDays": 5,
              "minHandlingTimeInDays": 0,
              "maxHandlingTimeInDays": 0
            },
            "rateGroups": [
              {
                "singleValue": {
                  "flatRate": {
                    "value": "5.99",
                    "currency": "USD"
                  }
                },
                "name": "All products"
              }
            ],
            "eligibility": "All scenarios except Shopping Actions"
          },
          {
            "name": "GSA Shipping - Free Ship Over $49.99",
            "active": true,
            "deliveryCountry": "US",
            "currency": "USD",
            "deliveryTime": {
              "minTransitTimeInDays": 3,
              "maxTransitTimeInDays": 8,
              "minHandlingTimeInDays": 1,
              "maxHandlingTimeInDays": 2
            },
            "rateGroups": [
              {
                "mainTable": {
                  "rowHeaders": {
                    "prices": [
                      {
                        "value": "49.99",
                        "currency": "USD"
                      },
                      {
                        "value": "infinity",
                        "currency": "USD"
                      }
                    ]
                  },
                  "rows": [
                    {
                      "cells": [
                        {
                          "flatRate": {
                            "value": "6.99",
                            "currency": "USD"
                          }
                        }
                      ]
                    },
                    {
                      "cells": [
                        {
                          "flatRate": {
                            "value": "0",
                            "currency": "USD"
                          }
                        }
                      ]
                    }
                  ]
                },
                "name": "Free Ship Over $49.99"
              }
            ],
            "eligibility": "Shopping Actions"
          }
        ]
      }
    }
  ]
}

নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া বডি: 

{
 "kind": "content#shippingsettingsCustomBatchResponse",
 "entries": [
  {
   "kind": "content#shippingsettingsCustomBatchResponseEntry",
   "batchId": 1,
   "shippingSettings": {
    "accountId": "1111",
    "services": [
     {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
       "minHandlingTimeInDays": 0,
       "maxHandlingTimeInDays": 1,
       "transitTimeTable": {
        "postalCodeGroupNames": [
         "Region1",
         "Region2",
         "all other locations"
        ],
        "transitTimeLabels": [
         "all other labels"
        ],
        "rows": [
         {
          "values": [
           {
            "minTransitTimeInDays": 1,
            "maxTransitTimeInDays": 2
           }
          ]
         },
         {
          "values": [
           {
            "minTransitTimeInDays": 2,
            "maxTransitTimeInDays": 3
           }
          ]
         },
         {
          "values": [
           {
            "minTransitTimeInDays": 3,
            "maxTransitTimeInDays": 5
           }
          ]
         }
        ]
       }
      },
      "rateGroups": [
       {
        "singleValue": {
         "flatRate": {
          "value": "0",
          "currency": "USD"
         }
        },
        "name": "Standard Shipping"
       }
      ],
      "eligibility": "All scenarios"
     },
     {
      "name": "Expedited",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
       "minTransitTimeInDays": 2,
       "maxTransitTimeInDays": 2,
       "minHandlingTimeInDays": 0,
       "maxHandlingTimeInDays": 1
      },
      "rateGroups": [
       {
        "singleValue": {
         "flatRate": {
          "value": "9.99",
          "currency": "USD"
         }
        },
        "name": "Expedited"
       }
      ],
      "eligibility": "All scenarios"
     }
    ],
    "postalCodeGroups": [
     {
      "name": "Region1",
      "country": "US",
      "postalCodeRanges": [
       {
        "postalCodeRangeBegin": "94035",
        "postalCodeRangeEnd": "94070"
       }
      ]
     },
     {
      "name": "Region2",
      "country": "US",
      "postalCodeRanges": [
       {
        "postalCodeRangeBegin": "94071",
        "postalCodeRangeEnd": "94082"
       }
      ]
     }
    ]
   }
  },
  {
   "kind": "content#shippingsettingsCustomBatchResponseEntry",
   "batchId": 2,
   "shippingSettings": {
    "accountId": "2222",
    "services": [
     {
      "name": "FedEx",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
       "minTransitTimeInDays": 4,
       "maxTransitTimeInDays": 5,
       "minHandlingTimeInDays": 0,
       "maxHandlingTimeInDays": 0
      },
      "rateGroups": [
       {
        "singleValue": {
         "flatRate": {
          "value": "5.99",
          "currency": "USD"
         }
        },
        "name": "All products"
       }
      ],
      "eligibility": "All scenarios except Shopping Actions"
     },
     {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
       "minTransitTimeInDays": 3,
       "maxTransitTimeInDays": 8,
       "minHandlingTimeInDays": 1,
       "maxHandlingTimeInDays": 2
      },
      "rateGroups": [
       {
        "mainTable": {
         "rowHeaders": {
          "prices": [
           {
            "value": "49.99",
            "currency": "USD"
           },
           {
            "value": "infinity",
            "currency": "USD"
           }
          ]
         },
         "rows": [
          {
           "cells": [
            {
             "flatRate": {
              "value": "6.99",
              "currency": "USD"
             }
            }
           ]
          },
          {
           "cells": [
            {
             "flatRate": {
              "value": "0",
              "currency": "USD"
             }
            }
           ]
          }
         ]
        },
        "name": "Free Ship Over $49.99"
       }
      ],
      "eligibility": "Shopping Actions"
     }
    ]
   }
  }
 ]
}

শিপিং সেটিংস সমর্থিত ক্যারিয়ারগুলি পান

shippingsettings.getsupportedcarriers কলটি একটি MCA অ্যাকাউন্ট বা একটি স্বতন্ত্র অ্যাকাউন্টকে তার সমর্থিত ক্যারিয়ারগুলো পেতে সাহায্য করে। 

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedCarriers

নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া বডি: 

{
 "kind": "content#shippingsettingsGetSupportedCarriersResponse",
 "carriers": [
  {
   "name": "FedEx",
   "country": "US",
   "services": [
    "Ground",
    "Home Delivery",
    "Express Saver",
    "First Overnight",
    "Priority Overnight",
    "Standard Overnight",
    "2Day"
   ]
  },
  {
   "name": "UPS",
   "country": "US",
   "services": [
    "2nd Day Air",
    "2nd Day Air AM",
    "3 Day Select",
    "Ground",
    "Next Day Air",
    "Next Day Air Early AM",
    "Next Day Air Saver"
   ]
  },
  {
   "name": "USPS",
   "country": "US",
   "services": [
    "Priority Mail Express",
    "Media Mail",
    "Retail Ground",
    "Priority Mail",
    "First Class Package Service Retail",
    "First Class Package Service Commercial Base"
   ]
  },
  {
   "name": "Australia Post",
   "country": "AU",
   "services": [
    "Regular Parcel",
    "Express Post"
   ]
  },
  {
   "name": "TNT",
   "country": "AU",
   "services": [
    "Road Express",
    "Overnight Express"
   ]
  },
  {
   "name": "TOLL",
   "country": "AU",
   "services": [
    "Road Delivery",
    "Overnight Priority"
   ]
  },
  {
   "name": "DHL",
   "country": "DE",
   "services": [
    "Paket",
    "Päckchen"
   ]
  },
  {
   "name": "DPD",
   "country": "DE",
   "services": [
    "Express 12",
    "Express",
    "Classic Parcel"
   ]
  },
  {
   "name": "Hermes",
   "country": "DE",
   "services": [
    "Päckchen",
    "Paketklasse S",
    "Paketklasse M",
    "Paketklasse L"
   ]
  },
  {
   "name": "UPS",
   "country": "DE",
   "services": [
    "Express",
    "Express Saver",
    "Standard"
   ]
  },
  {
   "name": "DHL UK",
   "country": "GB",
   "services": [
    "Express",
    "Express 12"
   ]
  },
  {
   "name": "DPD UK",
   "country": "GB",
   "services": [
    "Express 12",
    "Express Next Day",
    "Standard Parcel 12",
    "Standard Parcel Next Day",
    "Standard Parcel Two Day"
   ]
  },
  {
   "name": "RMG",
   "country": "GB",
   "services": [
    "1st Class Small Parcel",
    "1st Class Medium Parcel",
    "2nd Class Small Parcel",
    "2nd Class Medium Parcel"
   ]
  },
  {
   "name": "TNT UK",
   "country": "GB",
   "services": [
    "Express",
    "Express 10",
    "Express 12"
   ]
  },
  {
   "name": "UPS UK",
   "country": "GB",
   "services": [
    "Express",
    "Express Saver",
    "Standard"
   ]
  },
  {
   "name": "Yodel",
   "country": "GB",
   "services": [
    "B2C 48HR",
    "B2C 72HR",
    "B2C Packet"
   ]
  }
 ]
}

শিপিং সেটিংস সমর্থিত ছুটির দিনগুলি পান

shippingsettings.getsupportedholidays কলটি একটি MCA অ্যাকাউন্ট বা একটি স্বতন্ত্র অ্যাকাউন্টকে সমর্থিত ছুটির দিনগুলি পুনরুদ্ধার করার সুযোগ দেয়। 

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedHolidays

নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া: 

{
 "kind": "content#shippingsettingsGetSupportedHolidaysResponse",
 "holidays": [
  {
   "id": "FR_Christmas_2019-12-25",
   "countryCode": "FR",
   "type": "Christmas",
   "date": "2019-12-25",
   "deliveryGuaranteeDate": "2019-12-24",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Easter_2019-04-21",
   "countryCode": "US",
   "type": "Easter",
   "date": "2019-04-21",
   "deliveryGuaranteeDate": "2019-04-20",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Mother's Day_2019-05-12",
   "countryCode": "US",
   "type": "Mother's Day",
   "date": "2019-05-12",
   "deliveryGuaranteeDate": "2019-05-11",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Father's Day_2019-06-16",
   "countryCode": "US",
   "type": "Father's Day",
   "date": "2019-06-16",
   "deliveryGuaranteeDate": "2019-06-15",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Independence Day (USA)_2019-07-04",
   "countryCode": "US",
   "type": "Independence Day (USA)",
   "date": "2019-07-04",
   "deliveryGuaranteeDate": "2019-07-03",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Halloween_2019-10-31",
   "countryCode": "US",
   "type": "Halloween",
   "date": "2019-10-31",
   "deliveryGuaranteeDate": "2019-10-30",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Thanksgiving_2019-11-28",
   "countryCode": "US",
   "type": "Thanksgiving",
   "date": "2019-11-28",
   "deliveryGuaranteeDate": "2019-11-27",
   "deliveryGuaranteeHour": "18"
  },
  {
   "id": "US_Christmas_2019-12-25",
   "countryCode": "US",
   "type": "Christmas",
   "date": "2019-12-25",
   "deliveryGuaranteeDate": "2019-12-24",
   "deliveryGuaranteeHour": "18"
  }
 ]
}

পোস্টাল কোড গ্রুপ সেট করুন

মার্চেন্ট সেন্টারে অঞ্চল তৈরি করা সুবিধাজনক হলেও, ঘন ঘন পরিবর্তনশীল একাধিক অঞ্চলের অ্যাকাউন্টগুলো রক্ষণাবেক্ষণের জন্য কন্টেন্ট এপিআই ব্যবহার করুন।

শিপিং সেটিংস পরিষেবাটি আপনাকে শিপিং সেটিংস এবং অঞ্চলগুলি সেট করতে, পেতে এবং আপডেট করতে দেয়। এপিআই-তে, অঞ্চলগুলিকে postalCodeGroups বলা হয়। 

"postalCodeGroups": [
  {
    "name": "string,
    "country": string,
    "postalCodeRanges": [
      {
        "postalCodeRangeBegin": string,
        "postalCodeRangeEnd": string
      }
    ]
  }
]

UI-এর মতোই, postalCodeGroups হলো পোস্টাল কোড, পোস্টাল কোডের রেঞ্জ, পোস্টাল কোড প্রিফিক্স বা প্রিফিক্স রেঞ্জের একটি সাধারণ তালিকা।

যেহেতু অঞ্চলগুলি শিপিং সেটিংসের সাথে একত্রে পুনরুদ্ধার এবং সেট করা হয়, তাই বিদ্যমান শিপিং সেটিংস রিসোর্সের মাধ্যমে শুধুমাত্র postalCodeGroups পূরণ করলে শিপিং পরিষেবাগুলি মুছে যায়।

এপিআই-এর মাধ্যমে অঞ্চল নির্ধারণ করার সঠিক পদ্ধতিটি নিম্নরূপ:

  1. সমস্ত শিপিং পরিষেবা এবং postalCodeGroups (অঞ্চল) পুনরুদ্ধার করতে একটি get কল করুন।
  2. get কল থেকে শিপিং সার্ভিসগুলো update কলে কপি করুন।

  3. আপনার শিপিং পরিষেবাতে ট্রানজিট টাইম লেবেল ব্যবহার না করলে, অনুরোধের মূল অংশ থেকে নিম্নলিখিত এন্ট্রিটি সরিয়ে দিন: 

    "transitTimeLabels": [
    "all other labels"
],

  4. update কলের জন্য postalCodeGroups বিভাগে অঞ্চলগুলি পূরণ করুন।

  5. শিপিং সার্ভিসেস এবং postalCodeGroups উভয় সেকশন পূরণ করে update কলটি করুন।

নিম্নলিখিতটি উপরে ব্যবহৃত প্রথম get উদাহরণ থেকে নেওয়া একটি নমুনা update কল অনুরোধ বডি, যেখানে অঞ্চল ১-এর postalCodeGroups 94035 থেকে 94036 এ আপডেট করা হয়েছে: 

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
        "minHandlingTimeInDays": 0,
        "maxHandlingTimeInDays": 1,
        "transitTimeTable": {
          "postalCodeGroupNames": [
            "Region1",
            "Region2",
            "all other locations"
          ],
          "rows": [
            {
              "values": [
                {
                  "minTransitTimeInDays": 1,
                  "maxTransitTimeInDays": 2
                }
              ]
            },
            {
              "values": [
                {
                  "minTransitTimeInDays": 2,
                  "maxTransitTimeInDays": 3
                }
              ]
            },
            {
              "values": [
                {
                  "minTransitTimeInDays": 3,
                  "maxTransitTimeInDays": 5
                }
              ]
            }
          ]
        }
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "value": "0",
              "currency": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
      "eligibility": "All scenarios"
    },
    {
      "name": "Expedited",
      "active": true,
      "deliveryCountry": "US",
      "currency": "USD",
      "deliveryTime": {
        "minTransitTimeInDays": 2,
        "maxTransitTimeInDays": 2,
        "minHandlingTimeInDays": 0,
        "maxHandlingTimeInDays": 1
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "value": "9.99",
              "currency": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
      "eligibility": "All scenarios"
    }
  ],
  "postalCodeGroups": [
    {
      "name": "Region1",
      "country": "US",
      "postalCodeRanges": [
        {
          "postalCodeRangeBegin": "94036",
          "postalCodeRangeEnd": "94070"
        }
      ]
    },
    {
      "name": "Region2",
      "country": "US",
      "postalCodeRanges": [
        {
          "postalCodeRangeBegin": "94071",
          "postalCodeRangeEnd": "94082"
        }
      ]
    }
  ]
}

নিম্নলিখিতটি একটি নমুনা JSON প্রতিক্রিয়া: 

{
 "accountId": "1111",
 "services": [
  {
   "name": "Standard Shipping",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minHandlingTimeInDays": 0,
    "maxHandlingTimeInDays": 1,
    "transitTimeTable": {
     "postalCodeGroupNames": [
      "Region1",
      "Region2",
      "all other locations"
     ],
     "rows": [
      {
       "values": [
        {
         "minTransitTimeInDays": 1,
         "maxTransitTimeInDays": 2
        }
       ]
      },
      {
       "values": [
        {
         "minTransitTimeInDays": 2,
         "maxTransitTimeInDays": 3
        }
       ]
      },
      {
       "values": [
        {
         "minTransitTimeInDays": 3,
         "maxTransitTimeInDays": 5
        }
       ]
      }
     ]
    }
   },
   "rateGroups": [
    {
     "singleValue": {
      "flatRate": {
       "value": "0",
       "currency": "USD"
      }
     },
     "name": "Standard Shipping"
    }
   ],
   "eligibility": "All scenarios"
  },
  {
   "name": "Expedited",
   "active": true,
   "deliveryCountry": "US",
   "currency": "USD",
   "deliveryTime": {
    "minTransitTimeInDays": 2,
    "maxTransitTimeInDays": 2,
    "minHandlingTimeInDays": 0,
    "maxHandlingTimeInDays": 1
   },
   "rateGroups": [
    {
     "singleValue": {
      "flatRate": {
       "value": "9.99",
       "currency": "USD"
      }
     },
     "name": "Expedited"
    }
   ],
   "eligibility": "All scenarios"
  }
 ],
 "postalCodeGroups": [
  {
   "name": "Region1",
   "country": "US",
   "postalCodeRanges": [
    {
     "postalCodeRangeBegin": "94036",
     "postalCodeRangeEnd": "94070"
    }
   ]
  },
  {
   "name": "Region2",
   "country": "US",
   "postalCodeRanges": [
    {
     "postalCodeRangeBegin": "94071",
     "postalCodeRangeEnd": "94082"
    }
   ]
  }
 ]
}

পিকআপ/সংগ্রহ কেন্দ্র ব্যবহার করুন

পিকআপ/কালেকশন-পয়েন্ট অর্ডার সম্পর্কে আরও তথ্যের জন্য, যার মধ্যে হোম ডেলিভারি অর্ডার থেকে এগুলি কীভাবে আলাদা এবং পিকআপ-সংক্রান্ত কী কী তথ্য প্রক্রিয়া করতে হবে, সে সম্পর্কে জানতে পিকআপ/কালেকশন পয়েন্ট গাইডটি দেখুন।

একই দিনে ডেলিভারি

আপনার স্থানীয় ইনভেন্টরি থাকলে, আপনি শপিং-এর জন্য কন্টেন্ট এপিআই ব্যবহার করে একই দিনে ডেলিভারি শিপিং পরিষেবা কনফিগার করতে পারেন।

একই দিনে ডেলিভারি করা শিপিং পরিষেবাগুলোর shipmentType হলো local_delivery । বর্তমানে, সমস্ত local_delivery শিপিং পরিষেবা একই দিনের ডেলিভারি হিসেবে বিবেচিত হয়। আপনি লোকাল ডেলিভারির জন্য deliveryTime তথ্য পরিবর্তন করতে পারবেন না।

আপনার স্থানীয় ইনভেন্টরির পণ্যগুলির জন্য একই দিনে ডেলিভারি সেট আপ করতে shippingsettings.update ব্যবহার করুন।

এখানে একটি নমুনা অনুরোধের মূল অংশ দেওয়া হলো, যা আপনার অ্যাকাউন্টের সমস্ত দোকানে একই দিনে ডেলিভারি পরিষেবা যোগ করবে:

আপনার বাস্তবায়নে ব্যবহার করার আগে নিম্নলিখিত নমুনার সমস্ত মান আপডেট করুন। 

{
   "accountId":"accountId",
   "services":[
      {
         "name": "Local Delivery",
         "active":true,
         "shipmentType":"local_delivery",
         "deliveryCountry":"US",
         "currency":"USD",
         "rateGroups":[
            {
               "singleValue":{
                  "flatRate":{
                     "value":"0",
                     "currency":"USD"
                  }
               }
            }
         ],
         "eligibility":"All scenarios",
         "storeConfig":{
            "storeServiceType":"all stores",
            "storeCodes":[
               
            ],
            "cutoffConfig":{
               "storeCloseOffsetHours":2,
               "no_delivery_post_cutoff":true
            },
            "serviceRadius":{
               "value":4,
               "unit":"Miles"
            }
         }
      }
   ]
}

পরের দিন ডেলিভারি

আপনার একই দিনের ডেলিভারির কাটঅফ সময়ের পরে দেওয়া অর্ডারগুলি ডিফল্টরূপে পরের দিনের ডেলিভারির জন্য নির্ধারিত হয়। পরের দিনের ডেলিভারি বন্ধ করতে, no_delivery_post_cutoff কে true সেট করুন। আপনি যদি পরের দিনের ডেলিভারি বন্ধ করেন, তাহলে আপনার শিপিং পরিষেবাগুলি প্রতিদিন শুধুমাত্র কাটঅফ সময়ের আগে দেখা যাবে।

পরের দিন ডেলিভারি শুধুমাত্র তখনই পাওয়া যায় যখন shipmentType local_delivery হয়।

পরীক্ষা

যেহেতু সমস্ত আইটেম প্রোডাকশনে আছে, তাই লাইভ থাকা আইটেমগুলিতে কোনো গুরুত্বপূর্ণ পরিবর্তন করা থেকে বিরত থাকা উচিত, বিশেষ করে update() মেথডের ক্ষেত্রে, কারণ শুধুমাত্র এটিই বিদ্যমান মান পরিবর্তন করে।