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

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

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

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

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

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

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

নতুন ক্ষমতা

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

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

অনুরোধ

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট 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 মার্চেন্ট এপিআই
অ্যাকাউন্টের বিবরণ পান 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 রিসোর্স ব্যবহার করুন। এটি Content API for Shopping-এ businessInformation অবজেক্টটিকে প্রতিস্থাপন করে।

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট 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 ) মার্চেন্ট এপিআই ( BusinessInfo ) মন্তব্য
phone_number phone ক্ষেত্রটি এখন phone এবং google.type.PhoneNumber ব্যবহার করে।
customer_service.url customer_service.uri ক্ষেত্রের নাম এখন uri ।

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

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

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

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

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

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

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

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

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

কেনাকাটার জন্য কন্টেন্ট 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 রিসোর্স ব্যবহার করুন। এটি Content API for Shopping-এ businessIdentity অবজেক্টকে প্রতিস্থাপন করে।

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট 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 ( SELF_IDENTIFIES_AS , DOES_NOT_SELF_IDENTIFY_AS ) দ্বারা প্রতিস্থাপিত করা হয়। এটি সমস্ত পরিচয় বৈশিষ্ট্যের ক্ষেত্রে প্রযোজ্য।
include_for_promotions (বুলিয়ান) promotions_consent (সংখ্যা) একটি বিশ্বব্যাপী বুলিয়ান একটি আরও বর্ণনামূলক enum ( PROMOTIONS_CONSENT_GIVEN , PROMOTIONS_CONSENT_DENIED ) দ্বারা প্রতিস্থাপিত হয়।

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

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

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

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

বিস্তারিত ক্ষেত্রের তুলনা (অনুরোধের পরামিতি)

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