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.unclaimContent 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) আপডেট করা হচ্ছে তা নির্দিষ্ট করে। |