শিপিং সেটিংস

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

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

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

shippingsettings.list

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

shippingsettings.list পদ্ধতির উদাহরণ URL:

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

নিচে একটি এমসিএ অ্যাকাউন্টের সাব-অ্যাকাউন্ট 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

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

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

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

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

{
 "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

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

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

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

{
...
    "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

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

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

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

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

  1. batchId=1 অ্যাকাউন্ট আইডি 1111 এর জন্য শিপিং সেটিংস পুনরুদ্ধার করতে ব্যবহৃত হয়।
  2. batchId=2 , শিপিং পরিষেবা GSA শিপিংয়ের জন্য maxTransitTimeInDays 8 এ আপডেট করতে ব্যবহৃত হয় GSA Shipping - Free Ship Over $49.99 । (এই সেটিংটি 7 থেকে পরিবর্তন করা হয়েছে অ্যাকাউন্ট আইডি 2222 -এর জন্য shippingsettings.update এর পূর্ববর্তী প্রতিক্রিয়া বডি উদাহরণে দেখানো হয়েছে)।
{
  "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

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

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"
  }
 ]
}

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

যদিও বণিক কেন্দ্রে অঞ্চলগুলি তৈরি করা সুবিধাজনক, তবে ঘন ঘন পরিবর্তন হওয়া একাধিক অঞ্চলের অ্যাকাউন্টগুলি বজায় রাখতে সামগ্রী API ব্যবহার করুন৷

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

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

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

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

API এর মাধ্যমে অঞ্চল নির্ধারণের সঠিক উপায় নিম্নরূপ:

  1. সমস্ত শিপিং পরিষেবা এবং postalCodeGroups (অঞ্চল) পুনরুদ্ধার করতে একটি get করুন।
  2. get কল থেকে update কলে শিপিং পরিষেবাগুলি কপি করুন৷
  3. আপনি যদি আপনার শিপিং পরিষেবাতে ট্রানজিট টাইম লেবেল ব্যবহার না করেন তবে অনুরোধের বডি থেকে নিম্নলিখিত এন্ট্রিটি সরান:

    "transitTimeLabels": [
        "all other labels"
    ],
    
  4. update কলের জন্য postalCodeGroups বিভাগে অঞ্চলগুলিকে পপুলেট করুন।

  5. শিপিং পরিষেবা এবং postalCodeGroups বিভাগগুলি জনবহুল করে update কল করুন৷

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

{
  "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"
    }
   ]
  }
 ]
}

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

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

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

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

একই দিনে ডেলিভারি শিপিং পরিষেবাগুলির local_delivery রয়েছে তাদের shipmentType হিসাবে। এই সময়ে সমস্ত 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() পদ্ধতির সাথে কারণ এটিই একমাত্র যা বিদ্যমান মান পরিবর্তন করে।