হোমপেজ সেটিংস মাইগ্রেট করুন

Merchant API-তে একটি বিশেষ Homepage রিসোর্স যোগ করা হয়েছে। এই রিসোর্স আপনার হোমপেজ দাবি ম্যানেজ করার নতুন পদ্ধতি প্রদান করে, যা শপিংয়ের জন্য ক্লাসিক কন্টেন্ট API-এর বাইরেও সুবিধা প্রদান করে।

আপনার অনলাইন স্টোরের জন্য ফিচার অ্যাক্সেস করা একটি দুই-ধাপের প্রক্রিয়া: প্রথমে মালিকানা যাচাই করা, তারপর আপনার অ্যাকাউন্টের জন্য সাইট দাবি করা। শেষ ধাপ সম্পূর্ণ করতে, accounts.homepage.claim ব্যবহার করুন।

প্রধান পার্থক্য

Content API for Shopping-এর তুলনায় Merchant API হোমপেজ-সম্পর্কিত বেশ কিছু পরিবর্তন করে:

  • ডেডিকেটেড রিসোর্স: Merchant API হোমপেজ-সম্পর্কিত সব অপারেশনের জন্য একটি স্বতন্ত্র Homepage রিসোর্স (accounts.homepage) প্রদান করে। (Content API for Shopping-এ, আপনি দাবি সংক্রান্ত অ্যাকশন পারফর্ম করতে accounts.claimwebsite ব্যবহার করেছেন, হোমপেজ URL (website_url) Account রিসোর্সের অংশ ছিল এবং দাবির স্ট্যাটাস (website_claimed) AccountStatus রিসোর্সের অংশ ছিল।)
  • গ্র্যানুলার পদ্ধতি: Merchant API এইসব কাজ করার জন্য নির্দিষ্ট পদ্ধতি অফার করে:
    • হোমপেজের বিবরণ ফিরিয়ে আনুন: accounts.homepage.getHomepage
    • হোমপেজ URI আপডেট করুন: accounts.homepage.updateHomepage
    • হোমপেজ দাবি করুন: accounts.homepage.claim
    • হোমপেজ ডিসক্লেম করুন: accounts.homepage.unclaim Content API for Shopping দাবি সংক্রান্ত অ্যাকশনের জন্য accounts.claimwebsite, URL সেট করার জন্য accounts.update (এবং কার্যকরভাবে একটি খালি URL সেট করে ডিসক্লেম করুন) এবং URL ও দাবির স্ট্যাটাস যথাক্রমে ফিরিয়ে আনতে accounts.get/accountstatuses.get ব্যবহার করেছে।
  • কেন্দ্রীভূত তথ্য: Merchant API Homepage রিসোর্সে uri (হোমপেজ URL) এবং claimed স্ট্যাটাস সরাসরি থাকে। Homepage রিসোর্সে কাজ করা সব পদ্ধতি এই রিসোর্স ফিরিয়ে দেয়, যা বর্তমান অবস্থার ব্যাপারে তাত্ক্ষণিক মতামত প্রদান করে। Content API for Shopping-এ, accounts.claimwebsite আপডেট করা স্ট্যাটাস দেখায়নি; আলাদা কল করতে হয়েছে।
  • স্পষ্টভাবে ত্যজন: Content API for Shopping-এ, সাধারণত Account.website_url-কে খালি স্ট্রিংয়ে আপডেট করে ত্যজন করা হয়। Merchant API একটি নির্দিষ্ট homepage.unclaim পদ্ধতি প্রদান করে।
  • দাবি ওভাররাইট করা: মালিকানা যাচাই করা গেলে, অন্য অ্যাকাউন্ট থেকে দাবি নিজের অ্যাকাউন্টে নিয়ে আসার জন্য, দাবি করার প্রসেস চলাকালীন দুটি API-ই overwrite প্যারামিটারকে সমর্থন করে।

অনুরোধ

হোমপেজের বিভিন্ন দিক ম্যানেজ করার জন্য মার্চেন্ট API স্বতন্ত্র RESTful এন্ডপয়েন্ট ব্যবহার করে।

অনুরোধের বিবরণ Content API for Shopping for Shopping Merchant API
হোমপেজের বিবরণ পান accounts.get (Account.website_url পড়তে), accountstatuses.get (AccountStatus.website_claimed পড়তে) GET /accounts/v1/accounts/{account}/homepage
হোমপেজ URI আপডেট করুন accounts.update (Account.website_url সেটিং) PATCH /accounts/v1/accounts/{account}/homepage
হোমপেজ দাবি বা আবার যাচাই করুন POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (accounts.update ব্যবহার করে সেট করা Account.website_url-এর উপর কাজ করা হয়েছে) POST /accounts/v1/accounts/{account}/homepage:claim
হোমপেজ ডিসক্লেম করুন accounts.update (Account.website_url-কে খালি স্ট্রিংয়ে সেট করা) POST /accounts/v1/accounts/{account}/homepage:unclaim

আইডেন্টিফায়ার

Merchant API-তে রিসোর্স শনাক্তকরণ স্ট্রিমলাইন করা হয়েছে।

শনাক্তকারীর বিবরণ Content API for Shopping Merchant API
রিসোর্স অ্যাক্সেসের জন্য অ্যাকাউন্ট শনাক্তকারী পাথে merchantId (উন্নত অ্যাকাউন্ট) এবং accountId (সাব-অ্যাকাউন্ট) account (name ফিল্ডের অংশ, যেমন, accounts/{account_id}/homepage)
হোমপেজ রিসোর্স আইডেন্টিফায়ার প্রযোজ্য নয় (Account রিসোর্সের ক্ষেত্রে অন্তর্নিহিত) name: accounts/{account_id}/homepage (Homepage সাব-রিসোর্স শনাক্ত করে)

পদ্ধতি

Content API for Shopping-এর accounts.claimwebsite পদ্ধতি, যা দাবি করার অ্যাকশনের উপর ফোকাস করে, এখন Merchant API-এর Homepage রিসোর্সের মধ্যে আরও বিস্তৃত কার্যকারিতার অংশ।

Content API for Shopping পদ্ধতি মার্চেন্ট API পদ্ধতি উপলভ্যতা ও নোট
accounts.claimwebsite accounts.homepage.claim সরাসরি কোনও ওয়েবসাইট দাবি শুরু বা পুনরায় যাচাই করে। homepage.update ব্যবহার করে আগে সেট করা uri-এর উপর কাজ করে। এতে overwrite প্যারামিটার অন্তর্ভুক্ত আছে। বর্তমান uri এবং claimed স্ট্যাটাস সহ Homepage রিসোর্স ফিরিয়ে দেয়।
accounts.get (Account.website_url পড়তে), accountstatuses.get (AccountStatus.website_claimed পড়তে) accounts.homepage.getHomepage একক কলে বর্তমান হোমপেজ uri এবং এর claimed স্ট্যাটাস ফিরিয়ে আনার জন্য নতুন ডেডিকেটেড পদ্ধতি।
accounts.update (Account.website_url সেট করতে) accounts.homepage.updateHomepage হোমপেজ uri সেট বা পরিবর্তন করার জন্য নতুন ডেডিকেটেড পদ্ধতি।
accounts.update (দাবি প্রত্যাহার করার জন্য ওয়ার্কঅ্যারাউন্ড হিসেবে Account.website_url-কে খালি স্ট্রিং হিসেবে সেট করা হচ্ছে) accounts.homepage.unclaim হোমপেজ থেকে দাবি স্পষ্টভাবে প্রত্যাহার করার জন্য নতুন নির্দিষ্ট পদ্ধতি।

বিস্তারিত ফিল্ড পরিবর্তন

হোমপেজের তথ্য যেভাবে সাজানো এবং অ্যাক্সেস করা হয় তা উল্লেখযোগ্যভাবে পরিবর্তিত হয়েছে, Merchant API-তে স্পষ্ট Homepage রিসোর্সের দিকে এগিয়ে যাচ্ছে।

Content API for Shopping Merchant API বিবরণ
merchantId (accounts.claimwebsite-এর জন্য পাথ প্যারামিটার) name (Homepage পদ্ধতির জন্য পাথ প্যারামিটার, ফর্ম্যাট: accounts/{account}/homepage) Merchant API-তে name স্ট্রিংয়ের account অংশটি Content API for Shopping-এর accountId-এর সাথে সম্পর্কিত।
accountId (accounts.claimwebsite-এর জন্য পাথ প্যারামিটার) name (Homepage পদ্ধতির জন্য পাথ প্যারামিটার, ফর্ম্যাট: accounts/{account}/homepage) যে নির্দিষ্ট অ্যাকাউন্টের হোমপেজ ম্যানেজ করা হচ্ছে সেটির শনাক্তকারী।
overwrite (ContentAccountsClaimwebsiteRequest বডি ও AccountsCustomBatchRequestEntry-এ বুলিয়ান) ClaimHomepageRequest.overwrite (homepage.claim অনুরোধের প্রধান অংশে বুলিয়ান) ঐচ্ছিক। true যদি ওয়েবসাইট দাবি করার চেষ্টা করে, তাহলে অনুরোধকারী অ্যাকাউন্ট মালিকানা যাচাই করতে পারলে, অন্য অ্যাকাউন্ট থেকে আগে করা দাবি সরিয়ে দেওয়া হতে পারে।
Account.website_url (Account রিসোর্সে ফিল্ড, accounts.update ব্যবহার করে সেট করা হয়েছে, accounts.get ব্যবহার করে পড়া হয়েছে) Homepage.uri (Homepage রিসোর্সের ফিল্ড) স্টোরের হোমপেজের URI (URL)। Merchant API-তে, এটি Homepage রিসোর্সের মধ্যে একটি এক্সপ্লিসিট ফিল্ড। এটি accounts.homepage.updateHomepage ব্যবহার করে সেট করা হয় এবং সব Homepage পদ্ধতি দ্বারা রিটার্ন করা হয়।
AccountStatus.website_claimed (AccountStatus রিসোর্সের ফিল্ড, accountstatuses.get ব্যবহার করে পড়া হয়েছে) Homepage.claimed (Homepage রিসোর্সে output_only বুলিয়ান ফিল্ড) uri দাবি ও যাচাই করা হয়েছে কিনা তা দেখায়। এই স্ট্যাটাস সরাসরি Homepage রিসোর্সে উপলভ্য থাকে যা এর সাথে যুক্ত সব Merchant API পদ্ধতির মাধ্যমে রিটার্ন করা হয়।
প্রযোজ্য নয় UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage অনুরোধের প্রধান অংশের প্যারামিটার) homepage.update-এর জন্য একটি ঐচ্ছিক ফিল্ড মাস্ক, যা Homepage রিসোর্সের কোন কোন ফিল্ড (যেমন, uri) আপডেট করা হচ্ছে তা নির্দিষ্ট করে।