মাইগ্রেট অ্যাকাউন্ট লিঙ্কিং

শপিং-এর জন্য কন্টেন্ট এপিআই-এর একটিমাত্র link পদ্ধতি থেকে অ্যাকাউন্ট সম্পর্কগুলির ব্যবস্থাপনা মার্চেন্ট এপিআই-তে আরও সূক্ষ্ম ও সুস্পষ্ট একটি সিস্টেমে রূপান্তরিত হয়েছে। নতুন এপিআইটি একটি অ্যাকাউন্ট অন্য অ্যাকাউন্টকে যে নির্দিষ্ট পরিষেবাগুলি প্রদান করে, তা সংজ্ঞায়িত করার জন্য AccountRelationship এবং AccountService মতো বিশেষ রিসোর্স ব্যবহার করে। আরও বিস্তারিত জানতে, ‘অ্যাকাউন্টগুলির মধ্যে সম্পর্ক’ দেখুন।

মূল পার্থক্য

  • সম্পর্ক এবং পরিষেবার জন্য নির্দিষ্ট রিসোর্স : মার্চেন্ট এপিআই-তে, AccountRelationship রিসোর্সটি একজন পরিষেবা প্রদানকারী এবং একজন মার্চেন্টের মধ্যে সংযোগ নির্ধারণ করে, অন্যদিকে AccountService রিসোর্সটি ঠিক কোন পরিষেবা প্রদান করা হচ্ছে তা নির্দিষ্ট করে (উদাহরণস্বরূপ accountAggregation )। এটি শপিং-এর জন্য কন্টেন্ট এপিআই-এর জেনেরিক linkType এবং services ফিল্ডগুলোকে প্রতিস্থাপন করে।
  • সুস্পষ্ট অ্যাকশন মেথড : action প্যারামিটারসহ একটিমাত্র link মেথডের পরিবর্তে, মার্চেন্ট এপিআই সার্ভিসগুলো পরিচালনার জন্য স্বতন্ত্র মেথড ব্যবহার করে, যেমন propose , approve এবং reject ।
  • গুগল বিজনেস প্রোফাইলের সাথে সংযোগের জন্য বিশেষ ব্যবস্থা : পূর্বে googleMyBusinessLink ফিল্ড সেট করার মাধ্যমে গুগল বিজনেস প্রোফাইলের সাথে সংযোগ স্থাপন করা হতো, কিন্তু এখন এর জন্য একটি বিশেষ পদ্ধতি রয়েছে, gbpAccounts.linkGbpAccount ।
  • পরিষেবা হিসাবে ক্লায়েন্ট অ্যাকাউন্ট তৈরি : একটি অ্যাডভান্সড অ্যাকাউন্টের অধীনে ক্লায়েন্ট অ্যাকাউন্ট তৈরি করাকে এখন accounts.createAndConfigure পদ্ধতি ব্যবহার করে একটি accountAggregation পরিষেবা প্রস্তাব করা হিসাবে গণ্য করা হয়। অ্যাকাউন্ট সম্পর্কে আরও তথ্য মার্চেন্ট অ্যাকাউন্টস এপিআই (Merchant Accounts API) পৃষ্ঠায় পাওয়া যাবে। কোনো হ্যান্ডশেকের প্রয়োজন নেই, কারণ ব্যবহারকারীর অ্যাডভান্সড অ্যাকাউন্ট এবং ক্লায়েন্ট অ্যাকাউন্ট উভয়টিতেই অ্যাক্সেস রয়েছে।

অনুরোধ

মার্চেন্ট এপিআই বিভিন্ন ধরনের অ্যাকাউন্ট লিঙ্ক ও পরিষেবা ব্যবস্থাপনার জন্য নির্দিষ্ট এন্ডপয়েন্ট প্রদান করে:

মার্চেন্ট এপিআই অনুরোধ ইউআরএল

  • একটি নতুন পরিষেবা প্রস্তাব করুন : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • একটি পরিষেবা অনুমোদন করুন : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Reject a service : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • গুগল বিজনেস প্রোফাইলের লিঙ্ক : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • একটি ক্লায়েন্ট অ্যাকাউন্ট তৈরি করুন (অ্যাকাউন্ট অ্যাগ্রিগেশন লিঙ্ক) : POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

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

অনুরোধের বিবরণ কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই
অ্যাকাউন্ট লিঙ্ক করুন (উদাহরণস্বরূপ, তৃতীয় পক্ষের প্ল্যাটফর্ম) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
গুগল বিজনেস প্রোফাইলের লিঙ্ক PUT .../v2.1/{merchantId}/accounts/{accountId} ( googleMyBusinessLink ফিল্ড সহ) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
একটি ক্লায়েন্ট অ্যাকাউন্ট তৈরি করুন POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

পদ্ধতি

শপিং পদ্ধতির জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই পদ্ধতি প্রাপ্যতা ও নোট
accounts.link accountServices.propose অন্য একটি অ্যাকাউন্ট দিয়ে নতুন পরিষেবা শুরু করতে এই পদ্ধতিটি ব্যবহার করুন।
accounts.link ( action: "approve" সহ) accountServices.approve বিচারাধীন পরিষেবা প্রস্তাব অনুমোদন করতে এই পদ্ধতিটি ব্যবহার করুন।
accounts.link ( action: "remove" সহ) accountServices.reject অপেক্ষাধীন বা চালু কোনো পরিষেবা প্রত্যাখ্যান করতে এই পদ্ধতিটি ব্যবহার করুন।
accounts.insert (ক্লায়েন্ট অ্যাকাউন্টগুলির জন্য) accounts.createAndConfigure একটি অ্যাডভান্সড অ্যাকাউন্টের অধীনে নতুন ক্লায়েন্ট অ্যাকাউন্ট তৈরি করতে accountAggregation সার্ভিসের সাথে এই পদ্ধতিটি ব্যবহার করুন।
accounts.update ( googleMyBusinessLink সহ) gbpAccounts.linkGbpAccount মার্চেন্ট সেন্টার অ্যাকাউন্টকে গুগল বিজনেস প্রোফাইলের সাথে লিঙ্ক করতে এই নির্দিষ্ট পদ্ধতিটি ব্যবহার করুন।
accounts.update ( adsLinks সহ) AccountRelationship সম্পদ গুগল অ্যাডস-এর সাথে সংযোগ স্থাপন গুগল অ্যাডস ইউআই (UI) থেকে পরিচালনা করা হয়। এর ফলে তৈরি হওয়া লিঙ্কটি মার্চেন্ট এপিআই (Merchant API)-তে একটি AccountRelationship হিসেবে প্রদর্শিত হয়, যা দেখা গেলেও সরাসরি তৈরি করা যায় না।

বিস্তারিত ক্ষেত্রের পরিবর্তন

কেনাকাটার জন্য কন্টেন্ট এপিআই মার্চেন্ট এপিআই বর্ণনা
AccountsLinkRequest.action পদ্ধতি propose , approve , reject সার্ভিস লাইফসাইকেলে প্রতিটি স্টেট পরিবর্তনের জন্য একক action ফিল্ডের পরিবর্তে ডেডিকেটেড এপিআই মেথড ব্যবহার করা হয়।
AccountsLinkRequest.linkType AccountService.service_type AccountService রিসোর্সের মধ্যে থাকা জেনেরিক linkType স্ট্রিংটি productsManagement বা accountAggregation মতো একটি স্ট্রাকচার্ড service_type oneof ফিল্ড দ্বারা প্রতিস্থাপিত হয়।
AccountsLinkRequest.services AccountService.service_type স্ট্রিং-ভিত্তিক পরিষেবাগুলির তালিকা এখন AccountService রিসোর্সের মধ্যে নির্বাচিত নির্দিষ্ট service_type দ্বারা উপস্থাপিত হয়।
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider পরিষেবা প্রদানকারী অ্যাকাউন্টের আইডি এখন propose অনুরোধের provider ক্ষেত্রে উল্লেখ করা হয়েছে।
Account.googleMyBusinessLink LinkGbpAccountRequest জিবিপি লিঙ্কের বিবরণ ধারণকারী অবজেক্টটি linkGbpAccount পদ্ধতির জন্য একটি বিশেষ অনুরোধ বার্তা দ্বারা প্রতিস্থাপিত হয়।
Account.adsLinks AccountRelationship গুগল অ্যাডস লিঙ্কগুলিকে একটি AccountRelationship রিসোর্স হিসেবে উপস্থাপন করা হয়, যেখানে provider হলো providers/GOOGLE_ADS । এই সম্পর্কটি সাধারণত গুগল অ্যাডস UI থেকে পরিচালনা করা হয়।