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

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

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

একটি উৎস থেকে বহু উৎসে

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

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

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

নতুন ক্ষমতা

মার্চেন্ট এপিআই অ্যাকাউন্ট ব্যবস্থাপনার জন্য এমন কিছু নতুন সুবিধাও নিয়ে এসেছে যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না:

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

অনুরোধ

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
অ্যাকাউন্ট পান 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 রিসোর্সে একটি মার্চেন্ট সেন্টার অ্যাকাউন্টের প্রয়োজনীয় বিবরণ, যেমন এর নাম, আইডি এবং মৌলিক সেটিংস থাকে।

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

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

বিস্তারিত মাঠ তুলনা

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

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

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

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

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

বিস্তারিত মাঠ তুলনা

কেনাকাটার জন্য কন্টেন্ট এপিআই ( business_information ) মার্চেন্ট এপিআই ( BusinessInfo ) নোট
phone_number phone ফিল্ডটির নাম এখন phone এবং এটি google.type.PhoneNumber ব্যবহার করে।
customer_service.url customer_service.uri ফিল্ডের নাম এখন uri ।

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

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

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
হোমপেজের ইউআরএল পান GET /content/v2.1/{merchantId}/accounts/{accountId} ( website_url অ্যাট্রিবিউট অ্যাক্সেস করা হচ্ছে) GET /accounts/v1/accounts/{account}/homepage
হোমপেজ ইউআরএল আপডেট করুন 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

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

কেনাকাটার জন্য কন্টেন্ট এপিআই ( Account ) মার্চেন্ট এপিআই ( Homepage ) নোট
website_url uri স্টোরের হোমপেজের ইউআরএল।
সরাসরি উপলব্ধ নয় claimed একটি বুলিয়ান ফিল্ড, যার true হয় যদি হোমপেজটি দাবি করা হয়ে থাকে।

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

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

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

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

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

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

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

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

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

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

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

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

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

শপিং-এর জন্য কন্টেন্ট এপিআই (Content API) থেকে accounttax পরিষেবাটি মার্চেন্ট এপিআই (Merchant API)-তে উপলব্ধ নয়। মার্কিন বিক্রয় কর (US sales tax) প্রদান করা এখন আর বাধ্যতামূলক নয়, আরও তথ্যের জন্য মার্চেন্ট সেন্টার প্রোডাক্ট ডেটা স্পেসিফিকেশন আপডেট ২০২৫ (Merchant Center product data specification update 2025) দেখুন।

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

আপনার ব্যবসা সম্পর্কিত অ্যাট্রিবিউটগুলো স্ব-ঘোষণা করতে BusinessIdentity রিসোর্সটি ব্যবহার করুন। এটি শপিং-এর জন্য কন্টেন্ট এপিআই-তে থাকা businessIdentity অবজেক্টটিকে প্রতিস্থাপন করে।

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

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

বিস্তারিত মাঠ তুলনা

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

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

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

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

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

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

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