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

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

মূল পার্থক্য

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

অনুরোধ

মার্চেন্ট এপিআই বিভিন্ন ধরনের অ্যাকাউন্ট লিঙ্ক এবং পরিষেবাগুলি পরিচালনা করার জন্য নির্দিষ্ট শেষ পয়েন্ট প্রদান করে:

মার্চেন্ট API অনুরোধ URL

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

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

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

পদ্ধতি

শপিং পদ্ধতির জন্য সামগ্রী API মার্চেন্ট API পদ্ধতি প্রাপ্যতা এবং নোট
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 একটি Google ব্যবসায়িক প্রোফাইলের সাথে একটি মার্চেন্ট সেন্টার অ্যাকাউন্ট লিঙ্ক করতে এই উত্সর্গীকৃত পদ্ধতিটি ব্যবহার করুন।
accounts.update ( adsLinks সহ) AccountRelationship রিসোর্স Google Ads-এর সাথে লিঙ্ক করা Google Ads UI থেকে পরিচালিত হয়। ফলস্বরূপ লিঙ্কটি মার্চেন্ট এপিআই-এ AccountRelationship হিসাবে উপস্থাপন করা হয়, যা দেখা যায় কিন্তু সরাসরি তৈরি করা যায় না।

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

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