আপনার অ্যাকাউন্টের বিভিন্ন দিকের উপর আরও সুনির্দিষ্ট নিয়ন্ত্রণের মাধ্যমে মার্চেন্ট সেন্টার অ্যাকাউন্টগুলোকে আরও দক্ষতার সাথে পরিচালনা করার সুযোগ দিতে অ্যাকাউন্টস এপিআই-কে বিভিন্ন রিসোর্সের একটি সংগ্রহে বিভক্ত করা হয়েছে।
এই নির্দেশিকাটি মূল পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনার বিদ্যমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনটি Content API for Shopping থেকে Merchant API-তে স্থানান্তরিত করতে সাহায্য করে।
একটি উৎস থেকে বহু উৎসে
Content API for Shopping-এ, Account রিসোর্সটি একটি একক অবজেক্ট ছিল, যাতে অ্যাকাউন্টের নাম ও ওয়েবসাইটের URL থেকে শুরু করে ব্যবহারকারীর তালিকা এবং ব্যবসার তথ্য পর্যন্ত সবকিছু অন্তর্ভুক্ত ছিল।
মার্চেন্ট এপিআই এটিকে কয়েকটি ছোট ও আরও সুনির্দিষ্ট রিসোর্সে বিভক্ত করে। এই পরিবর্তনের ফলে আরও লক্ষ্যভেদী ও কার্যকর এপিআই কল করা সম্ভব হয়। উদাহরণস্বরূপ, শুধুমাত্র আপনার ব্যবসার ঠিকানা আপডেট করতে, এখন পুরো Account অবজেক্টটি আপডেট করার পরিবর্তে BusinessInfo রিসোর্সে একটি PATCH রিকোয়েস্ট পাঠাতে হয়।
শপিং Account রিসোর্সের জন্য কন্টেন্ট এপিআই-এর ধারণাগুলো মার্চেন্ট এপিআই-এর নতুন রিসোর্সগুলোতে কীভাবে মানিয়ে যায়, তার একটি সারসংক্ষেপ এখানে দেওয়া হলো:
- অ্যাকাউন্টের মূল বিবরণ (আইডি, নাম, প্রাপ্তবয়স্কদের জন্য অনুপযুক্ত বিষয়বস্তু সংক্রান্ত সেটিংস)
Accountরিসোর্সে সংরক্ষিত থাকে। - ব্যবসায়িক তথ্য (ঠিকানা, ফোন নম্বর, গ্রাহক পরিষেবা) এখন
BusinessInfoরিসোর্স দ্বারা পরিচালিত হয়। - ওয়েবসাইট ইউআরএল এবং দাবি করার বিষয়টি
Homepageরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবহারকারী ব্যবস্থাপনা
Userরিসোর্স দ্বারা পরিচালিত হয়। - অ্যাকাউন্টের সম্পর্কগুলো (যেমন উন্নত অ্যাকাউন্ট, তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অন্যান্য গুগল পরিষেবার লিঙ্ক)
AccountRelationshipএবংAccountServiceরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবসায়িক পরিচয়ের বৈশিষ্ট্যসমূহ (যেমন, কৃষ্ণাঙ্গ-মালিকানাধীন, নারী-মালিকানাধীন)
BusinessIdentityরিসোর্স দ্বারা পরিচালিত হয়। - পরিষেবার শর্তাবলী (ToS) চুক্তি , যা একটি নতুন বৈশিষ্ট্য,
TermsOfServiceএবংTermsOfServiceAgreementStateরিসোর্স দ্বারা পরিচালিত হয়।
নতুন ক্ষমতা
মার্চেন্ট এপিআই অ্যাকাউন্ট ব্যবস্থাপনার জন্য এমন কিছু নতুন সুবিধাও নিয়ে এসেছে যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না:
- পরিষেবার শর্তাবলী:
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 (পথ পরামিতি) | The ID of the advanced account in the format accounts/{account} . |
max_results | page_size | ফেরত দেওয়ার জন্য অ্যাকাউন্টের সর্বোচ্চ সংখ্যা। |
আপনার অ্যাকাউন্টের বিভিন্ন দিকের উপর আরও সুনির্দিষ্ট নিয়ন্ত্রণের মাধ্যমে মার্চেন্ট সেন্টার অ্যাকাউন্টগুলোকে আরও দক্ষতার সাথে পরিচালনা করার সুযোগ দিতে অ্যাকাউন্টস এপিআই-কে বিভিন্ন রিসোর্সের একটি সংগ্রহে বিভক্ত করা হয়েছে।
এই নির্দেশিকাটি মূল পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনার বিদ্যমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনটি Content API for Shopping থেকে Merchant API-তে স্থানান্তরিত করতে সাহায্য করে।
একটি উৎস থেকে বহু উৎসে
Content API for Shopping-এ, Account রিসোর্সটি একটি একক অবজেক্ট ছিল, যাতে অ্যাকাউন্টের নাম ও ওয়েবসাইটের URL থেকে শুরু করে ব্যবহারকারীর তালিকা এবং ব্যবসার তথ্য পর্যন্ত সবকিছু অন্তর্ভুক্ত ছিল।
মার্চেন্ট এপিআই এটিকে কয়েকটি ছোট ও আরও সুনির্দিষ্ট রিসোর্সে বিভক্ত করে। এই পরিবর্তনের ফলে আরও লক্ষ্যভেদী ও কার্যকর এপিআই কল করা সম্ভব হয়। উদাহরণস্বরূপ, শুধুমাত্র আপনার ব্যবসার ঠিকানা আপডেট করতে, এখন পুরো Account অবজেক্টটি আপডেট করার পরিবর্তে BusinessInfo রিসোর্সে একটি PATCH রিকোয়েস্ট পাঠাতে হয়।
শপিং Account রিসোর্সের জন্য কন্টেন্ট এপিআই-এর ধারণাগুলো মার্চেন্ট এপিআই-এর নতুন রিসোর্সগুলোতে কীভাবে মানিয়ে যায়, তার একটি সারসংক্ষেপ এখানে দেওয়া হলো:
- অ্যাকাউন্টের মূল বিবরণ (আইডি, নাম, প্রাপ্তবয়স্কদের জন্য অনুপযুক্ত বিষয়বস্তু সংক্রান্ত সেটিংস)
Accountরিসোর্সে সংরক্ষিত থাকে। - ব্যবসায়িক তথ্য (ঠিকানা, ফোন নম্বর, গ্রাহক পরিষেবা) এখন
BusinessInfoরিসোর্স দ্বারা পরিচালিত হয়। - ওয়েবসাইট ইউআরএল এবং দাবি করার বিষয়টি
Homepageরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবহারকারী ব্যবস্থাপনা
Userরিসোর্স দ্বারা পরিচালিত হয়। - অ্যাকাউন্টের সম্পর্কগুলো (যেমন উন্নত অ্যাকাউন্ট, তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অন্যান্য গুগল পরিষেবার লিঙ্ক)
AccountRelationshipএবংAccountServiceরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবসায়িক পরিচয়ের বৈশিষ্ট্যসমূহ (যেমন, কৃষ্ণাঙ্গ-মালিকানাধীন, নারী-মালিকানাধীন)
BusinessIdentityরিসোর্স দ্বারা পরিচালিত হয়। - পরিষেবার শর্তাবলী (ToS) চুক্তি , যা একটি নতুন বৈশিষ্ট্য,
TermsOfServiceএবংTermsOfServiceAgreementStateরিসোর্স দ্বারা পরিচালিত হয়।
নতুন ক্ষমতা
মার্চেন্ট এপিআই অ্যাকাউন্ট ব্যবস্থাপনার জন্য এমন কিছু নতুন সুবিধাও নিয়ে এসেছে যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না:
- পরিষেবার শর্তাবলী:
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 | ফেরত দেওয়ার জন্য অ্যাকাউন্টের সর্বোচ্চ সংখ্যা। |
আপনার অ্যাকাউন্টের বিভিন্ন দিকের উপর আরও সুনির্দিষ্ট নিয়ন্ত্রণের মাধ্যমে মার্চেন্ট সেন্টার অ্যাকাউন্টগুলোকে আরও দক্ষতার সাথে পরিচালনা করার সুযোগ দিতে অ্যাকাউন্টস এপিআই-কে বিভিন্ন রিসোর্সের একটি সংগ্রহে বিভক্ত করা হয়েছে।
এই নির্দেশিকাটি মূল পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনার বিদ্যমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনটি Content API for Shopping থেকে Merchant API-তে স্থানান্তরিত করতে সাহায্য করে।
একটি উৎস থেকে বহু উৎসে
Content API for Shopping-এ, Account রিসোর্সটি একটি একক অবজেক্ট ছিল, যাতে অ্যাকাউন্টের নাম ও ওয়েবসাইটের URL থেকে শুরু করে ব্যবহারকারীর তালিকা এবং ব্যবসার তথ্য পর্যন্ত সবকিছু অন্তর্ভুক্ত ছিল।
মার্চেন্ট এপিআই এটিকে কয়েকটি ছোট ও আরও সুনির্দিষ্ট রিসোর্সে বিভক্ত করে। এই পরিবর্তনের ফলে আরও লক্ষ্যভেদী ও কার্যকর এপিআই কল করা সম্ভব হয়। উদাহরণস্বরূপ, শুধুমাত্র আপনার ব্যবসার ঠিকানা আপডেট করতে, এখন পুরো Account অবজেক্টটি আপডেট করার পরিবর্তে BusinessInfo রিসোর্সে একটি PATCH রিকোয়েস্ট পাঠাতে হয়।
শপিং Account রিসোর্সের জন্য কন্টেন্ট এপিআই-এর ধারণাগুলো মার্চেন্ট এপিআই-এর নতুন রিসোর্সগুলোতে কীভাবে মানিয়ে যায়, তার একটি সারসংক্ষেপ এখানে দেওয়া হলো:
- অ্যাকাউন্টের মূল বিবরণ (আইডি, নাম, প্রাপ্তবয়স্কদের জন্য অনুপযুক্ত বিষয়বস্তু সংক্রান্ত সেটিংস)
Accountরিসোর্সে সংরক্ষিত থাকে। - ব্যবসায়িক তথ্য (ঠিকানা, ফোন নম্বর, গ্রাহক পরিষেবা) এখন
BusinessInfoরিসোর্স দ্বারা পরিচালিত হয়। - ওয়েবসাইট ইউআরএল এবং দাবি করার বিষয়টি
Homepageরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবহারকারী ব্যবস্থাপনা
Userরিসোর্স দ্বারা পরিচালিত হয়। - অ্যাকাউন্টের সম্পর্কগুলো (যেমন উন্নত অ্যাকাউন্ট, তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অন্যান্য গুগল পরিষেবার লিঙ্ক)
AccountRelationshipএবংAccountServiceরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবসায়িক পরিচয়ের বৈশিষ্ট্যসমূহ (যেমন, কৃষ্ণাঙ্গ-মালিকানাধীন, নারী-মালিকানাধীন)
BusinessIdentityরিসোর্স দ্বারা পরিচালিত হয়। - পরিষেবার শর্তাবলী (ToS) চুক্তি , যা একটি নতুন বৈশিষ্ট্য,
TermsOfServiceএবংTermsOfServiceAgreementStateরিসোর্স দ্বারা পরিচালিত হয়।
নতুন ক্ষমতা
মার্চেন্ট এপিআই অ্যাকাউন্ট ব্যবস্থাপনার জন্য এমন কিছু নতুন সুবিধাও নিয়ে এসেছে যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না:
- পরিষেবার শর্তাবলী:
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 | ফেরত দেওয়ার জন্য অ্যাকাউন্টের সর্বোচ্চ সংখ্যা। |
আপনার অ্যাকাউন্টের বিভিন্ন দিকের উপর আরও সুনির্দিষ্ট নিয়ন্ত্রণের মাধ্যমে মার্চেন্ট সেন্টার অ্যাকাউন্টগুলোকে আরও দক্ষতার সাথে পরিচালনা করার সুযোগ দিতে অ্যাকাউন্টস এপিআই-কে বিভিন্ন রিসোর্সের একটি সংগ্রহে বিভক্ত করা হয়েছে।
এই নির্দেশিকাটি মূল পরিবর্তনগুলি ব্যাখ্যা করে এবং আপনার বিদ্যমান অ্যাকাউন্ট ম্যানেজমেন্ট ইন্টিগ্রেশনটি Content API for Shopping থেকে Merchant API-তে স্থানান্তরিত করতে সাহায্য করে।
একটি উৎস থেকে বহু উৎসে
Content API for Shopping-এ, Account রিসোর্সটি একটি একক অবজেক্ট ছিল, যাতে অ্যাকাউন্টের নাম ও ওয়েবসাইটের URL থেকে শুরু করে ব্যবহারকারীর তালিকা এবং ব্যবসার তথ্য পর্যন্ত সবকিছু অন্তর্ভুক্ত ছিল।
মার্চেন্ট এপিআই এটিকে কয়েকটি ছোট ও আরও সুনির্দিষ্ট রিসোর্সে বিভক্ত করে। এই পরিবর্তনের ফলে আরও লক্ষ্যভেদী ও কার্যকর এপিআই কল করা সম্ভব হয়। উদাহরণস্বরূপ, শুধুমাত্র আপনার ব্যবসার ঠিকানা আপডেট করতে, এখন পুরো Account অবজেক্টটি আপডেট করার পরিবর্তে BusinessInfo রিসোর্সে একটি PATCH রিকোয়েস্ট পাঠাতে হয়।
শপিং Account রিসোর্সের জন্য কন্টেন্ট এপিআই-এর ধারণাগুলো মার্চেন্ট এপিআই-এর নতুন রিসোর্সগুলোতে কীভাবে মানিয়ে যায়, তার একটি সারসংক্ষেপ এখানে দেওয়া হলো:
- অ্যাকাউন্টের মূল বিবরণ (আইডি, নাম, প্রাপ্তবয়স্কদের জন্য অনুপযুক্ত বিষয়বস্তু সংক্রান্ত সেটিংস)
Accountরিসোর্সে সংরক্ষিত থাকে। - ব্যবসায়িক তথ্য (ঠিকানা, ফোন নম্বর, গ্রাহক পরিষেবা) এখন
BusinessInfoরিসোর্স দ্বারা পরিচালিত হয়। - ওয়েবসাইট ইউআরএল এবং দাবি করার বিষয়টি
Homepageরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবহারকারী ব্যবস্থাপনা
Userরিসোর্স দ্বারা পরিচালিত হয়। - অ্যাকাউন্টের সম্পর্কগুলো (যেমন উন্নত অ্যাকাউন্ট, তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অন্যান্য গুগল পরিষেবার লিঙ্ক)
AccountRelationshipএবংAccountServiceরিসোর্স দ্বারা পরিচালিত হয়। - ব্যবসায়িক পরিচয়ের বৈশিষ্ট্যসমূহ (যেমন, কৃষ্ণাঙ্গ-মালিকানাধীন, নারী-মালিকানাধীন)
BusinessIdentityরিসোর্স দ্বারা পরিচালিত হয়। - পরিষেবার শর্তাবলী (ToS) চুক্তি , যা একটি নতুন বৈশিষ্ট্য,
TermsOfServiceএবংTermsOfServiceAgreementStateরিসোর্স দ্বারা পরিচালিত হয়।
নতুন ক্ষমতা
মার্চেন্ট এপিআই অ্যাকাউন্ট ব্যবস্থাপনার জন্য এমন কিছু নতুন সুবিধাও নিয়ে এসেছে যা শপিং-এর জন্য কন্টেন্ট এপিআই-তে উপলব্ধ ছিল না:
- পরিষেবার শর্তাবলী:
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} (accessing the business_information attribute) | GET /accounts/v1/accounts/{account}/businessInfo |
| ব্যবসার তথ্য আপডেট করুন | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the business_information attribute) | PATCH /accounts/v1/accounts/{account}/businessInfo |
Detailed field comparison
Content API for Shopping ( business_information ) | Merchant API ( BusinessInfo ) | নোট |
|---|---|---|
phone_number | phone | The field is now phone and uses google.type.PhoneNumber . |
customer_service.url | customer_service.uri | The field name is now uri . |
Manage your homepage
To manage your store's website URL and perform verification and claiming, use the Homepage resource. This replaces the websiteUrl field and the accounts.claimwebsite method from Content API for Shopping.
Request comparison
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| Get homepage URL | GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the website_url attribute) | GET /accounts/v1/accounts/{account}/homepage |
| Update homepage URL | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the website_url attribute) | PATCH /accounts/v1/accounts/{account}/homepage |
| Claim homepage | POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite | POST /accounts/v1/accounts/{account}/homepage:claim |
| Unclaim homepage | Not available | POST /accounts/v1/accounts/{account}/homepage:unclaim |
Detailed field comparison
Content API for Shopping ( Account ) | Merchant API ( Homepage ) | নোট |
|---|---|---|
website_url | uri | The URL of the store's homepage. |
| Not directly available | claimed | A boolean field that is true if the homepage is claimed. |
ব্যবহারকারীদের পরিচালনা করুন
The User resource lets you manage who can access a Merchant Center account. This replaces the users array within the Account resource. A key difference is the user creation process. In Merchant API, adding a user sends an invitation. The user must accept the invitation before they can access the account.
Request comparison
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| List users | GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the users attribute) | GET /accounts/v1/accounts/{account}/users |
| Create a user | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) | POST /accounts/v1/accounts/{account}/users |
| Update a user | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) | PATCH /accounts/v1/accounts/{account}/users/{email} |
| একজন ব্যবহারকারীকে মুছে ফেলুন | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the users attribute) | DELETE /accounts/v1/accounts/{account}/users/{email} |
Detailed field comparison
Content API for Shopping ( users array object) | Merchant API ( User resource) | নোট |
|---|---|---|
email_address | name (in format accounts/{account}/users/{email} ) | The user's email is now part of the resource name. |
admin , order_manager , reporting_manager , etc. | access_rights | Access rights are now consolidated into a repeated enum field. |
| Not available | state | A new output-only field indicating if the user is PENDING or VERIFIED . |
Manage account relationships and services
In Content API for Shopping, relationships were managed with accounts.link . Merchant API introduces a more explicit model with AccountService and AccountRelationship resources, requiring a handshake process (propose and accept).
Request comparison
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| অ্যাকাউন্ট লিঙ্ক করুন | POST /content/v2.1/{merchantId}/accounts/{accountId}/link | POST /accounts/v1/accounts/{account}/services:propose |
| List linked accounts | GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks | GET /accounts/v1/accounts/{account}/relationships and GET /accounts/v1/accounts/{account}/services |
Detailed field comparison
Content API for Shopping ( AccountLink ) | Merchant API ( AccountService , AccountRelationship ) | নোট |
|---|---|---|
linked_account_id | provider (in AccountService ) | The ID of the account providing the service. |
service | service_type (in AccountService ) | The type of service being provided (eg, ACCOUNT_AGGREGATION ). |
status | handshake.approval_state (in AccountService ) | The status of the link (eg, PENDING , ESTABLISHED ). |
Account tax settings
The accounttax service from the Content API for Shopping is not available in Merchant API. It is no longer required to provide US sales tax, for more information see Merchant Center product data specification update 2025 .
Manage business identity
Use the BusinessIdentity resource to self-declare attributes about your business. This replaces the businessIdentity object in Content API for Shopping.
Request comparison
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| Get business identity | GET /content/v2.1/{merchantId}/accounts/{accountId} (accessing the business_identity attribute) | GET /accounts/v1/accounts/{account}/businessIdentity |
| Update business identity | PUT /content/v2.1/{merchantId}/accounts/{accountId} (updating the business_identity attribute) | PATCH /accounts/v1/accounts/{account}/businessIdentity |
Detailed field comparison
Content API for Shopping ( business_identity ) | Merchant API ( BusinessIdentity ) | নোট |
|---|---|---|
black_owned.self_identified (boolean) | black_owned.identity_declaration (enum) | The boolean is replaced by an enum ( SELF_IDENTIFIES_AS , DOES_NOT_SELF_IDENTIFY_AS ) for more explicit declaration. This applies to all identity attributes. |
include_for_promotions (boolean) | promotions_consent (enum) | A global boolean is replaced by a more descriptive enum ( PROMOTIONS_CONSENT_GIVEN , PROMOTIONS_CONSENT_DENIED ). |
List accounts
In Content API for Shopping the only type of advanced account was a 'Multi-Client Account (MCA)' and it exposed an accounts.list method to list the accounts of the given Multi-Client Account. Advanced accounts in Merchant API are much more powerful, allowing a broader range of account types and relationships. To allow a straightforward migration for advanced accounts, Merchant API provides a direct equivalent to Content API for Shopping's accounts.list as a accounts.listSubaccounts method. We are introducing a new, more powerful accounts.list method that allows advanced account filtering.
Request comparison
| অনুরোধের বিবরণ | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| List accounts of an advanced account | GET /content/v2.1/{merchantId}/accounts | GET /accounts/v1/accounts/{providerId}:listSubaccounts |
| List all accessible accounts | Not available | GET /accounts/v1/accounts |
Detailed field comparison (Request parameters)
Content API for Shopping ( accounts.list ) | Merchant API ( accounts.listSubaccounts ) | নোট |
|---|---|---|
merchant_id (path parameter) | provider (path parameter) | The ID of the advanced account in the format accounts/{account} . |
max_results | page_size | The maximum number of accounts to return. |