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

অ্যাকাউন্টের API আপনার অ্যাকাউন্টের বিভিন্ন দিক জুড়ে আরও সুনির্দিষ্ট নিয়ন্ত্রণ সহ আপনার বণিক কেন্দ্র অ্যাকাউন্টগুলিকে আরও দক্ষতার সাথে পরিচালনা করার অনুমতি দেওয়ার জন্য সম্পদের একটি সংগ্রহে বিভক্ত।

এই নির্দেশিকাটি মূল পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনাকে আপনার বিদ্যমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনকে কেনাকাটার জন্য সামগ্রী API থেকে মার্চেন্ট API-এ স্থানান্তর করতে সহায়তা করে৷

এক সম্পদ থেকে অনেক

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

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

শপিং Account রিসোর্স ম্যাপের কনটেন্ট এপিআই থেকে মার্চেন্ট এপিআই-এর নতুন রিসোর্সে কীভাবে ধারণা করা হয় তার একটি সারাংশ এখানে দেওয়া হল:

নতুন ক্ষমতা

বণিক API অ্যাকাউন্ট পরিচালনার জন্য নতুন ক্ষমতাও প্রবর্তন করে যা কেনাকাটার জন্য সামগ্রী API-তে উপলব্ধ ছিল না:

  • পরিষেবার শর্তাবলী: পরিষেবার TermsOfService এবং TermsOfServiceAgreementState সংস্থানগুলি ব্যবহার করে প্রোগ্রাম্যাটিকভাবে পুনরুদ্ধার করুন এবং পরিষেবার শর্তাদি গ্রহণ করুন৷
  • উপনামের মাধ্যমে অ্যাকাউন্ট অ্যাক্সেস: একটি providerId~accountAlias ফর্ম্যাট ব্যবহার করে অ্যাকাউন্টগুলি অ্যাক্সেস করে, যে ব্যবসাগুলি একাধিক অ্যাকাউন্ট পরিচালনা করে তাদের নিজস্ব অ্যাকাউন্ট শনাক্তকারী ব্যবহার করার জন্য একটি সামঞ্জস্যপূর্ণ উপায় প্রদান করে।

অনুরোধ

এই সারণীটি কেনাকাটার জন্য সামগ্রী API এবং মার্চেন্ট API-এর মধ্যে সাধারণ অ্যাকাউন্ট পরিচালনার কাজের জন্য অনুরোধ URLগুলির একটি সমন্বিত তুলনা প্রদান করে।

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

মূল অ্যাকাউন্ট তথ্য পরিচালনা করুন

মার্চেন্ট এপিআই-এর Account রিসোর্সে একটি বণিক কেন্দ্র অ্যাকাউন্টের প্রয়োজনীয় বিবরণ থাকে, যেমন তার নাম, আইডি এবং মৌলিক সেটিংস।

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

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

ব্যবসার তথ্য পরিচালনা করুন

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

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

কেনাকাটার জন্য সামগ্রী API ( business_information ) মার্চেন্ট API ( BusinessInfo ) নোট
phone_number phone ক্ষেত্রটি এখন phone এবং google.type.PhoneNumber ব্যবহার করে।
customer_service.url customer_service.uri মাঠের নাম এখন uri ।

আপনার হোমপেজ পরিচালনা করুন

আপনার দোকানের ওয়েবসাইট URL পরিচালনা করতে এবং যাচাইকরণ এবং দাবি করতে, Homepage সংস্থানটি ব্যবহার করুন৷ এটি শপিংয়ের জন্য সামগ্রী API থেকে websiteUrl ক্ষেত্র এবং accounts.claimwebsite পদ্ধতি প্রতিস্থাপন করে।

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

কেনাকাটার জন্য সামগ্রী API ( Account ) মার্চেন্ট API ( Homepage ) নোট
website_url uri দোকানের হোমপেজের URL।
সরাসরি পাওয়া যায় না claimed একটি বুলিয়ান ক্ষেত্র যা true যদি হোমপেজ দাবি করা হয়।

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

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

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

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

অ্যাকাউন্ট সম্পর্ক এবং পরিষেবাগুলি পরিচালনা করুন

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

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

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

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

কেনাকাটার জন্য সামগ্রী API-এর accounttax পরিষেবা মার্চেন্ট API-এ উপলব্ধ নেই৷ ইউএস সেলস ট্যাক্স দেওয়ার আর প্রয়োজন নেই, আরও তথ্যের জন্য দেখুন মার্চেন্ট সেন্টারের পণ্যের ডেটা স্পেসিফিকেশন আপডেট 2025 ।

ব্যবসার পরিচয় পরিচালনা করুন

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

তুলনা অনুরোধ

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

বিস্তারিত ক্ষেত্রের তুলনা

কেনাকাটার জন্য সামগ্রী API ( business_identity ) মার্চেন্ট এপিআই ( 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 ) দ্বারা প্রতিস্থাপিত হয়৷

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

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

তুলনা অনুরোধ

বিবরণ অনুরোধ করুন কেনাকাটার জন্য সামগ্রী API বণিক API
উপ-অ্যাকাউন্ট তালিকা GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
সমস্ত অ্যাক্সেসযোগ্য অ্যাকাউন্টের তালিকা করুন পাওয়া যায় না GET /accounts/v1/accounts

বিশদ ক্ষেত্রের তুলনা (অনুরোধ প্যারামিটার)

কেনাকাটার জন্য সামগ্রী API ( accounts.list ) মার্চেন্ট API ( accounts.listSubaccounts ) নোট
merchant_id (পাথ প্যারামিটার) provider (পাথ প্যারামিটার) accounts/{account} ফর্ম্যাটে উন্নত অ্যাকাউন্টের আইডি।
max_results page_size ফেরত দিতে অ্যাকাউন্টের সর্বাধিক সংখ্যা।