অ্যাকাউন্ট ম্যানেজমেন্ট মাইগ্রেট করুন

Accounts API-কে রিসোর্সের সংগ্রহে ভাগ করা হয়েছে যাতে আপনার Merchant Center অ্যাকাউন্ট আরও দক্ষতার সাথে ম্যানেজ করা যায় এবং আপনার অ্যাকাউন্টের বিভিন্ন দিক আরও নিখুঁতভাবে নিয়ন্ত্রণ করা যায়।

এই নির্দেশিকা গুরুত্বপূর্ণ পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনার বর্তমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনকে Content API for Shopping থেকে Merchant API-তে মাইগ্রেট করতে সাহায্য করে।

একটি রিসোর্স থেকে অনেক রিসোর্সে

Content API for Shopping-এ, Account রিসোর্সটি একটি মনোলিথিক অবজেক্ট ছিল যার মধ্যে অ্যাকাউন্টের নাম এবং ওয়েবসাইটের URL থেকে শুরু করে ব্যবহারকারীর তালিকা এবং ব্যবসার তথ্য পর্যন্ত সবকিছু ছিল।

মার্চেন্ট API এটিকে আরও ছোট, আরও ফোকাস করা রিসোর্সে বিভক্ত করে। এই পরিবর্তন আরও টার্গেট করা এবং দক্ষ API কলের অনুমতি দেয়। যেমন, শুধু আপনার ব্যবসার ঠিকানা আপডেট করতে, আপনি এখন সম্পূর্ণ Account অবজেক্ট আপডেট করার পরিবর্তে BusinessInfo রিসোর্সে PATCH অনুরোধ করেন।

Content API for Shopping Account রিসোর্স থেকে নেওয়া ধারণাগুলি কীভাবে Merchant API-এর নতুন রিসোর্সে ম্যাপ করা হয় তার সারসংক্ষেপ এখানে দেওয়া হল:

নতুন ক্ষমতা

এছাড়াও, Merchant API অ্যাকাউন্ট ম্যানেজমেন্টের জন্য নতুন ক্ষমতা নিয়ে আসে যা Content API for Shopping-এ উপলভ্য ছিল না:

  • পরিষেবার শর্তাবলী: TermsOfService এবং TermsOfServiceAgreementState রিসোর্স ব্যবহার করে প্রোগ্রাম্যাটিক্যালি পরিষেবার শর্তাবলী ফিরিয়ে আনুন ও তাতে সম্মতি দিন।
  • অ্যাকাউন্ট তৈরি করা: accounts.createAndConfigure পদ্ধতি এখন সম্পর্ক (যেমন accountManagement) সহ অ্যাকাউন্ট তৈরি করা, alias সেট করা এবং নতুন accounts.verifySelf পদ্ধতি ব্যবহার করে API-ভিত্তিক যাচাইকরণের পক্ষে user.verificationMailSettings.verificationMailMode ফিল্ড ব্যবহার করে ইমেল যাচাইকরণ বন্ধ করাকে সমর্থন করে।
  • অ্যাকাউন্ট অ্যাক্সেস করার জন্য ছদ্মনাম: providerId~accountAlias ফর্ম্যাট ব্যবহার করে অ্যাকাউন্ট অ্যাক্সেস করুন, যা একাধিক অ্যাকাউন্ট ম্যানেজ করে এমন ব্যবসার জন্য তাদের নিজস্ব অ্যাকাউন্ট শনাক্তকারী ব্যবহার করার একটি সামঞ্জস্যপূর্ণ উপায় প্রদান করে।

অনুরোধ

এই সারণীতে Content API for Shopping এবং Merchant API-এর মধ্যে সাধারণ অ্যাকাউন্ট ম্যানেজমেন্ট টাস্কের জন্য অনুরোধ URL-এর একটি একত্রিত তুলনা প্রদান করা হয়েছে।

অনুরোধের বিবরণ Content API for Shopping Merchant API
অ্যাকাউন্ট পান GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
অ্যালিয়াসের মাধ্যমে অ্যাকাউন্ট পান সরাসরি উপলভ্য নয় GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
সাব-অ্যাকাউন্টের তালিকা তৈরি করুন GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
সাব-অ্যাকাউন্ট তৈরি করুন POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
অ্যাকাউন্ট ডেটা আপডেট করুন PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH উপযুক্ত রিসোর্সে। যেমন, অ্যাকাউন্টের নাম আপডেট করতে: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
সাব-অ্যাকাউন্ট মুছে দিন DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
ওয়েবসাইট দাবি করুন POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
অ্যাকাউন্ট লিঙ্ক করুন POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

অ্যাকাউন্টের মূল তথ্য ম্যানেজ করুন

Merchant API-তে Account রিসোর্সে Merchant Center অ্যাকাউন্টের প্রয়োজনীয় বিবরণ থাকে, যেমন, নাম, আইডি ও প্রাথমিক সেটিংস।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
অ্যাকাউন্টের বিবরণ পান GET /content/v2.1/{merchantId}/accounts/{accountId} (name, adult_content-এর মতো মূল অ্যাট্রিবিউট অ্যাক্সেস করছে) GET /accounts/v1/accounts/{account}
সাব-অ্যাকাউন্ট তৈরি করা POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
অ্যাকাউন্টের বিবরণ আপডেট করুন PUT /content/v2.1/{merchantId}/accounts/{accountId} (মূল অ্যাট্রিবিউট আপডেট করা হচ্ছে) PATCH /accounts/v1/accounts/{account}
সাব-অ্যাকাউন্ট মুছে দেওয়া DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

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

Content API for Shopping (Account) Merchant API (Account) নোট
id account_id সংখ্যাগত আইডি এখন শুধুমাত্র আউটপুট ফিল্ড। প্রাথমিক শনাক্তকারী হল রিসোর্স name।
name account_name অ্যাকাউন্টের মানুষের-পঠনযোগ্য নাম।
language language_code ফিল্ডের নাম এখন language_code।

ব্যবসার তথ্য ম্যানেজ করুন

আপনার ব্যবসা সম্পর্কে সর্বজনীন তথ্য, যেমন আপনার ঠিকানা এবং গ্রাহক পরিষেবা সংক্রান্ত যোগাযোগের তথ্য ম্যানেজ করতে BusinessInfo রিসোর্স ব্যবহার করুন। এটি Content API for Shopping-এ businessInformation অবজেক্টের জায়গায় থাকবে।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
ব্যবসার তথ্য পান GET /content/v2.1/{merchantId}/accounts/{accountId} (business_information অ্যাট্রিবিউট অ্যাক্সেস করছে) GET /accounts/v1/accounts/{account}/businessInfo
ব্যবসার তথ্য আপডেট করুন PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_information অ্যাট্রিবিউট আপডেট করা হচ্ছে) PATCH /accounts/v1/accounts/{account}/businessInfo

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

Content API for Shopping (business_information) Merchant API (BusinessInfo) নোট
phone_number phone ফিল্ডটি এখন phone এবং google.type.PhoneNumber ব্যবহার করে।
customer_service.url customer_service.uri ফিল্ডের নাম এখন uri।

আপনার হোমপেজ ম্যানেজ করুন

আপনার স্টোরের ওয়েবসাইট URL ম্যানেজ করতে এবং যাচাইকরণ ও দাবি করার কাজ করতে, Homepage রিসোর্স ব্যবহার করুন। এটি Content API for Shopping থেকে websiteUrl ফিল্ড এবং accounts.claimwebsite পদ্ধতিকে প্রতিস্থাপন করে।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
হোমপেজ URL পান GET /content/v2.1/{merchantId}/accounts/{accountId} (website_url অ্যাট্রিবিউট অ্যাক্সেস করছে) GET /accounts/v1/accounts/{account}/homepage
হোমপেজের URL আপডেট করুন PUT /content/v2.1/{merchantId}/accounts/{accountId} (website_url অ্যাট্রিবিউট আপডেট করা হচ্ছে) PATCH /accounts/v1/accounts/{account}/homepage
হোমপেজ দাবি করুন POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
হোমপেজের দাবি বাতিল করুন উপলভ্য নয় POST /accounts/v1/accounts/{account}/homepage:unclaim

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

Content API for Shopping (Account) Merchant API (Homepage) নোট
website_url uri স্টোরের হোমপেজের URL।
সরাসরি উপলভ্য নয় claimed একটি বুলিয়ান ফিল্ড যা true হয় যদি হোমপেজ দাবি করা হয়।

ব্যবহারকারীদের পরিচালনা করুন

User রিসোর্স আপনাকে Merchant Center অ্যাকাউন্ট কে অ্যাক্সেস করতে পারবে তা ম্যানেজ করতে দেয়। এটি Account রিসোর্সের মধ্যে users অ্যারের জায়গায় থাকবে। একটি মূল পার্থক্য হল ব্যবহারকারী তৈরির প্রসেস। Merchant API-তে, কোনও ব্যবহারকারীকে যোগ করলে একটি আমন্ত্রণ পাঠানো হয়। অ্যাকাউন্ট অ্যাক্সেস করার আগে ব্যবহারকারীকে আমন্ত্রণ গ্রহণ করতে হবে।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
ব্যবহারকারীদের তালিকা GET /content/v2.1/{merchantId}/accounts/{accountId} (users অ্যাট্রিবিউট অ্যাক্সেস করছে) GET /accounts/v1/accounts/{account}/users
ব্যবহারকারী তৈরি করুন PUT /content/v2.1/{merchantId}/accounts/{accountId} (users অ্যাট্রিবিউট আপডেট করা হচ্ছে) POST /accounts/v1/accounts/{account}/users
ব্যবহারকারীর তথ্য আপডেট করা PUT /content/v2.1/{merchantId}/accounts/{accountId} (users অ্যাট্রিবিউট আপডেট করা হচ্ছে) PATCH /accounts/v1/accounts/{account}/users/{email}
ব্যবহারকারীকে মুছে ফেলা PUT /content/v2.1/{merchantId}/accounts/{accountId} (users অ্যাট্রিবিউট আপডেট করা হচ্ছে) DELETE /accounts/v1/accounts/{account}/users/{email}

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

Content API for Shopping (users অ্যারে অবজেক্ট) Merchant API (User রিসোর্স) নোট
email_address name (accounts/{account}/users/{email} ফর্ম্যাটে) ব্যবহারকারীর ইমেল এখন রিসোর্সের নামের অংশ।
admin, order_manager, reporting_manager ইত্যাদি। access_rights অ্যাক্সেস অধিকার এখন একটি পুনরাবৃত্ত enum ফিল্ডে একত্রিত করা হয়েছে।
উপলভ্য নয় state ব্যবহারকারী PENDING নাকি VERIFIED তা দেখানোর জন্য একটি নতুন আউটপুট-অনলি ফিল্ড।

অ্যাকাউন্ট সম্পর্ক ও পরিষেবা ম্যানেজ করা

Content API for Shopping-এ, accounts.link-এর সাথে সম্পর্ক ম্যানেজ করা হয়। Merchant API-তে AccountService এবং AccountRelationship রিসোর্স সহ আরও স্পষ্ট মডেল চালু করা হয়েছে, যার জন্য হ্যান্ডশেক প্রসেস (প্রস্তাব দেওয়া ও গ্রহণ করা) প্রয়োজন।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
অ্যাকাউন্ট লিঙ্ক করুন POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
লিঙ্ক করা অ্যাকাউন্টের তালিকা GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships ও GET /accounts/v1/accounts/{account}/services

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

Content API for Shopping (AccountLink) Merchant API (AccountService, AccountRelationship) নোট
linked_account_id provider (AccountService-এ) পরিষেবা প্রদানকারী অ্যাকাউন্টের আইডি।
service service_type (AccountService-এ) যে ধরনের পরিষেবা প্রদান করা হচ্ছে (যেমন, ACCOUNT_AGGREGATION)।
status handshake.approval_state (AccountService-এ) লিঙ্কের স্ট্যাটাস (যেমন, PENDING, ESTABLISHED)।

অ্যাকাউন্ট ট্যাক্স সেটিংস

Content API for Shopping-এর accounttax পরিষেবা Merchant API-তে উপলভ্য নেই। মার্কিন যুক্তরাষ্ট্রের সেলস ট্যাক্স সংক্রান্ত তথ্য আর প্রদান করতে হবে না, আরও তথ্যের জন্য Merchant Center প্রোডাক্ট ডেটা স্পেসিফিকেশন আপডেট ২০২৫ দেখুন।

ব্যবসার পরিচয় ম্যানেজ করুন

আপনার ব্যবসা সম্পর্কে অ্যাট্রিবিউট নিজে থেকে ঘোষণা করতে BusinessIdentity রিসোর্স ব্যবহার করুন। এটি Content API for Shopping-এ businessIdentity অবজেক্টকে রিপ্লেস করে।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
ব্যবসার পরিচয় পান GET /content/v2.1/{merchantId}/accounts/{accountId} (business_identity অ্যাট্রিবিউট অ্যাক্সেস করছে) GET /accounts/v1/accounts/{account}/businessIdentity
ব্যবসার পরিচয় আপডেট করুন PUT /content/v2.1/{merchantId}/accounts/{accountId} (business_identity অ্যাট্রিবিউট আপডেট করা হচ্ছে) PATCH /accounts/v1/accounts/{account}/businessIdentity

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

Content API for Shopping (business_identity) Merchant API (BusinessIdentity) নোট
black_owned.self_identified (বুলিয়ান) black_owned.identity_declaration (enum) আরও স্পষ্ট ঘোষণার জন্য বুলিয়ানকে enum (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) দিয়ে পরিবর্তন করা হয়েছে। এটি সব পরিচয় অ্যাট্রিবিউটের ক্ষেত্রে প্রযোজ্য।
include_for_promotions (বুলিয়ান) promotions_consent (enum) গ্লোবাল বুলিয়ানকে আরও বর্ণনামূলক enum (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED) দিয়ে পরিবর্তন করা হয়েছে।

অ্যাকাউন্টের তালিকা

Content API for Shopping-এ উন্নত অ্যাকাউন্টের একমাত্র ধরন হল 'মাল্টি-ক্লায়েন্ট অ্যাকাউন্ট (MCA)' এবং এটি প্রদত্ত মাল্টি-ক্লায়েন্ট অ্যাকাউন্টের অ্যাকাউন্ট তালিকাভুক্ত করার জন্য একটি accounts.list পদ্ধতি প্রকাশ করেছে। Merchant API-তে উন্নত অ্যাকাউন্ট অনেক বেশি শক্তিশালী, যা আরও বিস্তৃত পরিসরের অ্যাকাউন্টের ধরন এবং সম্পর্ককে অনুমতি দেয়। উন্নত অ্যাকাউন্টের জন্য সহজ মাইগ্রেশনের অনুমতি দিতে, Merchant API, Content API for Shopping-এর accounts.list-এর সরাসরি সমতুল্য accounts.listSubaccounts পদ্ধতি প্রদান করে। আমরা একটি নতুন, আরও শক্তিশালী accounts.list পদ্ধতি নিয়ে আসছি যা উন্নত অ্যাকাউন্ট ফিল্টারিংয়ের সুবিধা দেয়।

তুলনা করার অনুরোধ করুন

অনুরোধের বিবরণ Content API for Shopping Merchant API
উন্নত অ্যাকাউন্টের অ্যাকাউন্ট তালিকাভুক্ত করুন GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
অ্যাক্সেস করা যায় এমন সব অ্যাকাউন্টের তালিকা উপলভ্য নয় GET /accounts/v1/accounts

বিস্তারিত ফিল্ড তুলনা (অনুরোধের প্যারামিটার)

Content API for Shopping (accounts.list) Merchant API (accounts.listSubaccounts) নোট
merchant_id (পাথ প্যারামিটার) provider (পাথ প্যারামিটার) accounts/{account} ফর্ম্যাটে উন্নত অ্যাকাউন্টের আইডি।
max_results page_size ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক অ্যাকাউন্ট।
পূর্ববর্তী
Refactor code for concurrent requests
পরবর্তী
Migrate accountstatuses to Account Issues