মার্চেন্ট এপিআই একটি ডেডিকেটেড Homepage রিসোর্স প্রবর্তন করে। এই সংস্থানটি আপনার হোমপেজ দাবি পরিচালনা করার জন্য নতুন পদ্ধতি সরবরাহ করে, কেনাকাটার জন্য ক্লাসিক সামগ্রী API এর বাইরেও ক্ষমতা প্রদান করে।
আপনার অনলাইন স্টোরের বৈশিষ্ট্যগুলি অ্যাক্সেস করা একটি দ্বি-পদক্ষেপ প্রক্রিয়া: প্রথমে মালিকানা যাচাই করা, তারপর আপনার অ্যাকাউন্টের জন্য সাইট দাবি করা৷ চূড়ান্ত ধাপটি সম্পূর্ণ করতে, accounts.homepage.claim ব্যবহার করুন।
মূল পার্থক্য
কেনাকাটার জন্য সামগ্রী API-এর তুলনায় মার্চেন্ট এপিআই বেশ কিছু হোমপেজ-সম্পর্কিত পরিবর্তন করে:
- ডেডিকেটেড রিসোর্স : মার্চেন্ট এপিআই সমস্ত হোমপেজ-সম্পর্কিত ক্রিয়াকলাপের জন্য একটি স্বতন্ত্র
Homepageরিসোর্স (accounts.homepage) প্রদান করে। (শপিংয়ের জন্য সামগ্রী API-তে, আপনি দাবির ক্রিয়া সম্পাদন করতেaccounts.claimwebsiteব্যবহার করেছেন, হোমপেজ URL (website_url)Accountসংস্থানের অংশ ছিল এবং দাবির স্থিতি (website_claimed) ছিলAccountStatusসংস্থানের অংশ৷) - দানাদার পদ্ধতি : মার্চেন্ট এপিআই এর জন্য নির্দিষ্ট পদ্ধতি অফার করে:
- হোমপেজের বিবরণ পুনরুদ্ধার করুন:
accounts.homepage.getHomepage - হোমপেজ URI আপডেট করুন:
accounts.homepage.updateHomepage - হোমপেজ দাবি করুন:
accounts.homepage.claim - হোমপেজ ডিসক্লেইম করুন:
accounts.homepage.unclaimকন্টেন্ট API কেনাকাটার জন্য দাবি অ্যাকশনের জন্যaccounts.claimwebsiteব্যবহার করা হয়েছে, URL সেট করার জন্যaccounts.update(এবং কার্যকরভাবে একটি খালি URL সেট করে ডিসক্লেইম) এবংaccounts.get/accountstatuses.getযথাক্রমে URL এবং দাবি স্ট্যাটাস পুনরুদ্ধার করতে।
- হোমপেজের বিবরণ পুনরুদ্ধার করুন:
- কেন্দ্রীভূত তথ্য : মার্চেন্ট API
Homepageরিসোর্সেuri(হোমপেজ ইউআরএল) এবং সরাসরিclaimedস্ট্যাটাস উভয়ই থাকে।Homepageরিসোর্সে অপারেটিং সমস্ত পদ্ধতি এই রিসোর্স ফিরিয়ে দেয়, বর্তমান অবস্থার উপর তাৎক্ষণিক প্রতিক্রিয়া প্রদান করে। কেনাকাটার জন্য সামগ্রী API-তে,accounts.claimwebsiteআপডেট করা স্থিতি ফেরত দেয়নি; আলাদা কল প্রয়োজন ছিল। - স্পষ্ট দাবিত্যাগ : কেনাকাটার জন্য সামগ্রী API-তে, খালি স্ট্রিংয়ে
Account.website_urlআপডেট করার মাধ্যমে দাবিত্যাগ সাধারণত অর্জন করা হয়েছিল। মার্চেন্ট API একটি ডেডিকেটেডhomepage.unclaimপদ্ধতি প্রদান করে। - দাবি ওভাররাইট করুন : মালিকানা যাচাই করা গেলে অন্য অ্যাকাউন্ট থেকে দাবি নেওয়ার জন্য উভয় APIই দাবি প্রক্রিয়া চলাকালীন একটি
overwriteপ্যারামিটার সমর্থন করে।
অনুরোধ
মার্চেন্ট API হোমপেজের বিভিন্ন দিক পরিচালনার জন্য স্বতন্ত্র RESTful শেষ পয়েন্ট ব্যবহার করে।
| বিবরণ অনুরোধ করুন | কেনাকাটার জন্য কেনাকাটার জন্য সামগ্রী API | বণিক 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 ( Account.website_url সেট করা accounts.update ব্যবহার করে) | POST /accounts/v1/accounts/{account}/homepage:claim |
| হোমপেজ অস্বীকার করুন | accounts.update (খালি স্ট্রিং এ Account.website_url সেট করা) | POST /accounts/v1/accounts/{account}/homepage:unclaim |
শনাক্তকারী
মার্চেন্ট এপিআই-এ সম্পদ শনাক্তকরণ সহজ করা হয়েছে।
| শনাক্তকারীর বিবরণ | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| সম্পদ অ্যাক্সেসের জন্য অ্যাকাউন্ট শনাক্তকারী | merchantId (উন্নত অ্যাকাউন্ট) এবং accountId (সাব-অ্যাকাউন্ট) পথে | account ( name ক্ষেত্রের অংশ, যেমন, accounts/{account_id}/homepage ) |
| হোমপেজ রিসোর্স আইডেন্টিফায়ার | প্রযোজ্য নয় ( Account রিসোর্সে অন্তর্নিহিত) | name : accounts/{account_id}/homepage ( Homepage সাব-রিসোর্স সনাক্ত করে) |
পদ্ধতি
কেনাকাটার জন্য সামগ্রী API থেকে accounts.claimwebsite পদ্ধতি, যা দাবি করার ক্রিয়াকলাপের উপর দৃষ্টি নিবদ্ধ করা হয়েছিল, এটি এখন মার্চেন্ট API-এর Homepage সংস্থানের মধ্যে কার্যকারিতার একটি বিস্তৃত সেটের অংশ।
| শপিং পদ্ধতির জন্য সামগ্রী API | মার্চেন্ট API পদ্ধতি | উপলব্ধতা এবং নোট |
|---|---|---|
accounts.claimwebsite | accounts.homepage.claim | একটি ওয়েবসাইট দাবি সরাসরি শুরু বা পুনরায় যাচাই করে। homepage.update ব্যবহার করে পূর্বে সেট করা uri তে কাজ করে। একটি overwrite প্যারামিটার অন্তর্ভুক্ত। Homepage রিসোর্সকে তার বর্তমান uri এবং claimed স্ট্যাটাস দিয়ে ফিরিয়ে দেয়। |
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 | একটি হোমপেজ স্পষ্টভাবে দাবিমুক্ত করার জন্য নতুন উত্সর্গীকৃত পদ্ধতি৷ |
বিস্তারিত ক্ষেত্রের পরিবর্তন
যেভাবে হোমপেজ তথ্য কাঠামোগত এবং অ্যাক্সেস করা হয় তা উল্লেখযোগ্যভাবে পরিবর্তিত হয়েছে, মার্চেন্ট এপিআই-এর সুস্পষ্ট Homepage রিসোর্সের দিকে যাচ্ছে।
| কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|
merchantId ( accounts.claimwebsite এর জন্য পাথ প্যারামিটার ) | name ( Homepage পদ্ধতির জন্য পাথ প্যারামিটার, ফরম্যাট: accounts/{account}/homepage ) | মার্চেন্ট এপিআই-এ name স্ট্রিং-এর account অংশটি কেনাকাটার জন্য সামগ্রী API-এর accountId সাথে মিলে যায়। |
accountId ( accounts.claimwebsite এর জন্য পাথ প্যারামিটার ) | name ( Homepage পদ্ধতির জন্য পাথ প্যারামিটার, ফরম্যাট: accounts/{account}/homepage ) | নির্দিষ্ট অ্যাকাউন্টের শনাক্তকারী যার হোমপেজ পরিচালিত হচ্ছে। |
overwrite ( ContentAccountsClaimwebsiteRequest body এবং AccountsCustomBatchRequestEntry এ বুলিয়ান) | ClaimHomepageRequest.overwrite ( homepage.claim বুলিয়ান। অনুরোধের বডি দাবি করুন) | ঐচ্ছিক। যদি true , ওয়েবসাইটটি দাবি করার চেষ্টা করে, সম্ভাব্যভাবে অন্য অ্যাকাউন্ট থেকে একটি বিদ্যমান দাবি মুছে ফেলা হয় যদি অনুরোধকারী অ্যাকাউন্ট দ্বারা মালিকানা যাচাই করা যায়। |
Account.website_url ( Account রিসোর্সে ক্ষেত্র, accounts.update ব্যবহার করে সেট করুন, accounts.get ব্যবহার করে পড়ুন) | Homepage.uri ( Homepage রিসোর্সে ক্ষেত্র) | দোকানের হোমপেজের URI (URL)। মার্চেন্ট এপিআইতে, এটি Homepage রিসোর্সের মধ্যে একটি সুস্পষ্ট ক্ষেত্র। এটি accounts.homepage.updateHomepage ব্যবহার করে সেট করা হয়েছে এবং সমস্ত Homepage পদ্ধতি দ্বারা ফিরে এসেছে৷ |
AccountStatus.website_claimed ( AccountStatus রিসোর্সে ক্ষেত্র, accountstatuses.get ব্যবহার করে পড়ুন) | Homepage.claimed ( Homepage রিসোর্সে output_only বুলিয়ান ক্ষেত্র) | uri দাবি করা এবং যাচাই করা হয়েছে কিনা তা নির্দেশ করে। এই স্ট্যাটাসটি সরাসরি Homepage রিসোর্সে পাওয়া যায় যা এর সমস্ত সংশ্লিষ্ট মার্চেন্ট এপিআই পদ্ধতি দ্বারা প্রত্যাবর্তিত হয়। |
| N/A | UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage অনুরোধ বডি প্যারামিটার) | Homepage রিসোর্সের কোন ক্ষেত্রগুলি (যেমন, uri ) আপডেট করা হচ্ছে তা নির্দিষ্ট করতে homepage.update এর জন্য একটি ঐচ্ছিক ফিল্ড মাস্ক৷ |