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

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

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

অনুরোধ

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

অনুরোধের বিবরণ কেনাকাটার জন্য কেনাকাটার জন্য কন্টেন্ট 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

শনাক্তকারী

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

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

পদ্ধতি

কন্টেন্ট এপিআই ফর শপিংয়ের accounts.claimwebsite পদ্ধতি, যা দাবি করার উপর দৃষ্টি নিবদ্ধ করেছিল, এখন মার্চেন্ট এপিআই-এর Homepage রিসোর্সের মধ্যে বিস্তৃত কার্যকারিতার একটি অংশ।

কেনাকাটা পদ্ধতির জন্য কন্টেন্ট 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 মার্চেন্ট এপিআই বিবরণ
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 রিসোর্সে পাওয়া যায় যা এর সাথে সম্পর্কিত সমস্ত মার্চেন্ট এপিআই পদ্ধতি দ্বারা ফেরত পাঠানো হয়।
নিষিদ্ধ UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage রিকোয়েস্ট বডি প্যারামিটার) Homepage রিসোর্সের কোন ক্ষেত্রগুলি (যেমন, uri ) আপডেট করা হচ্ছে তা নির্দিষ্ট করার জন্য homepage.update এর জন্য একটি ঐচ্ছিক ফিল্ড মাস্ক।
পূর্ববর্তী
Migrate user and access management
পরবর্তী
Migrate region management