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

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

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

মূল পার্থক্য

শপিং-এর জন্য কন্টেন্ট এপিআই-এর তুলনায় মার্চেন্ট এপিআই হোমপেজ-সম্পর্কিত বেশ কিছু পরিবর্তন এনেছে:

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

অনুরোধ

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

অনুরোধের বিবরণ	কেনাকাটার জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই
হোমপেজের বিবরণ জানুন	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

শনাক্তকারী

মার্চেন্ট এপিআই-তে রিসোর্স শনাক্তকরণ প্রক্রিয়াকে আরও সহজ করা হয়েছে।

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

পদ্ধতি

Content API for Shopping-এর accounts.claimwebsite মেথডটি, যা মূলত ক্লেইম করার কাজের উপর কেন্দ্র করে তৈরি ছিল, এখন Merchant API-এর Homepage রিসোর্সের অন্তর্গত আরও বিস্তৃত কার্যকারিতাসমূহের একটি অংশ।

কেনাকাটার পদ্ধতির জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই পদ্ধতি	প্রাপ্যতা ও নোট
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 রিসোর্সের দিকে প্রবণতা বাড়ছে।

কেনাকাটার জন্য কন্টেন্ট এপিআই	মার্চেন্ট এপিআই	বর্ণনা
merchantId ( accounts.claimwebsite এর জন্য পাথ প্যারামিটার)	name ( Homepage মেথডগুলির জন্য পাথ প্যারামিটার, ফরম্যাট: accounts/{account}/homepage )	মার্চেন্ট এপিআই-এর name স্ট্রিং-এর account অংশটি শপিং-এর জন্য কন্টেন্ট এপিআই-এর 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)। মার্চেন্ট এপিআই-তে, এটি Homepage রিসোর্সের মধ্যে একটি সুস্পষ্ট ফিল্ড। এটি accounts.homepage.updateHomepage ব্যবহার করে সেট করা হয় এবং সমস্ত Homepage মেথড দ্বারা রিটার্ন করা হয়।
AccountStatus.website_claimed ( AccountStatus রিসোর্সের একটি ফিল্ড, যা accountstatuses.get ব্যবহার করে পড়া হয়)	Homepage.claimed ( Homepage রিসোর্সের একটি আউটপুট-অনলি বুলিয়ান ফিল্ড)	uri দাবি করা এবং যাচাই করা হয়েছে কিনা তা নির্দেশ করে। এই স্ট্যাটাসটি এর সাথে যুক্ত সমস্ত মার্চেন্ট এপিআই মেথড দ্বারা ফেরত আসা Homepage রিসোর্সে সরাসরি পাওয়া যায়।
প্রযোজ্য নয়	UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage অনুরোধের মূল অংশের প্যারামিটার)	homepage.update এর জন্য একটি ঐচ্ছিক ফিল্ড মাস্ক, যা নির্দিষ্ট করে যে Homepage রিসোর্সের কোন ফিল্ডগুলো (যেমন, uri ) আপডেট করা হচ্ছে।