এই ডকুমেন্টটি ব্যাখ্যা করে কিভাবে আপনি Content API v2.1 থেকে Merchant API-এ স্থানান্তর করতে পারেন।
Content API v2.1 থেকে Merchant API-এ পরিবর্তনের ওভারভিউ
Merchant API Content API v2.1 এর উপর উল্লেখযোগ্য উন্নতি প্রবর্তন করে, যার লক্ষ্য ডেভেলপার এবং ব্যবসার জন্য ব্যবহারযোগ্যতা, ধারাবাহিকতা এবং নমনীয়তা বৃদ্ধি করা।
দানাদার সম্পদ কাঠামো
মার্চেন্ট এপিআই-এর সম্পদগুলি একক ধারণার প্রতিনিধিত্ব করে, যেমন account , businessDetails , user , homepage এবং program । তারা তাদের সম্পর্ক প্রতিফলিত করার জন্য শ্রেণিবদ্ধভাবে সংগঠিত হয়। উদাহরণস্বরূপ, একটি account হল একজন user মূল সম্পদ।
ইউনিফাইড অ্যাকাউন্ট পরিষেবা
সমস্ত অ্যাকাউন্ট পরিষেবাগুলি (উদাহরণস্বরূপ, MCAs এবং তাদের সাব-অ্যাকাউন্টগুলির জন্য বা তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অ্যাকাউন্টগুলির মধ্যে অ্যাকাউন্ট একত্রিতকরণ) একটি ইউনিফাইড accountService রিসোর্সের মাধ্যমে পরিচালিত হয়। পরিষেবা প্রদানকারীরা accountRelationship রিসোর্স ব্যবহার করে তাদের সম্পর্ক পরিচালনা করতে পারে।
সরলীকৃত URL গঠন
ইউআরএলগুলি এখন একাধিক আইডির পরিবর্তে একটি একক অ্যাকাউন্ট আইডি ব্যবহার করে (উদাহরণস্বরূপ, merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId} )। URL পাথগুলি দানাদার সংস্থান কাঠামোকে মিরর করে।
অন্যান্য উন্নতি
- বর্ধিত প্রোগ্রাম এবং ব্যবহারকারী ব্যবস্থাপনা : শপিং বিজ্ঞাপন এবং বিনামূল্যে তালিকার মতো প্রোগ্রামগুলি একক
programসংস্থানের অধীনে একত্রিত করা হয়।userসম্পদে দানাদার অ্যাক্সেসের অধিকার সহ ব্যাপক ব্যবস্থাপনার ক্ষমতা রয়েছে। - স্ট্রাকচার্ড ব্যবসায়িক তথ্য এবং ব্যবসার পরিচয় :
businessInfoএবংbusinessIdentityজন্য উৎসর্গীকৃত সংস্থান রয়েছে। তারা অঞ্চল-নির্দিষ্ট ডেটার জন্য ক্ষেত্রগুলির সাথে সম্মতি সমর্থন অন্তর্ভুক্ত করে। উদাহরণস্বরূপ, কোরিয়ান ব্যবসা নিবন্ধন নম্বর। - স্ট্রীমলাইনড হোমপেজ দাবি করা : একটি ডেডিকেটেড
homepageরিসোর্স স্টোরের হোমপেজ ইউআরএল পরিচালনা করে।claimএবংunclaimমতো পদ্ধতিগুলি API এর মাধ্যমে সরাসরি দাবি করা ওয়েবসাইট পরিচালনা করে। - Google API নির্দেশিকাগুলির সাথে সম্মতি : মার্চেন্ট API-এর লক্ষ্য হল Google-এর API উন্নতির প্রস্তাবগুলির সাথে সারিবদ্ধ করা৷
অ্যাকাউন্ট পরিচালনার স্থানান্তর
আপনি আপনার বণিক অ্যাকাউন্ট তৈরি এবং পরিচালনা করতে accounts সম্পদ ব্যবহার করতে পারেন। আরও তথ্যের জন্য, মার্চেন্ট অ্যাকাউন্ট API-এর ওভারভিউ দেখুন।
এই পৃষ্ঠাটি বর্ণনা করে যে আপনি কীভাবে সামগ্রী API থেকে মার্চেন্ট API-এ অ্যাকাউন্ট পরিচালনা স্থানান্তর করতে পারেন।
অনুরোধ
বণিক অ্যাকাউন্ট API-এর জন্য নিম্নলিখিত অনুরোধ URL বিন্যাসটি ব্যবহার করুন:
POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
এখানে অ্যাকাউন্ট তৈরি এবং পরিচালনার অনুরোধের জন্য বণিক অ্যাকাউন্ট API-এর সাথে কেনাকাটার জন্য সামগ্রী API-এর একটি নমুনা তুলনা করা হল:
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/ merchantId /accounts/ accountId / | https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId |
| শনাক্তকারী | মার্চেন্টআইডি /accounts/ অ্যাকাউন্ট আইডি | accounts/ অ্যাকাউন্ট আইডি |
সম্পদ
অ্যাকাউন্টের ডেটা কেনাকাটার জন্য সামগ্রী API-তে Account সংস্থান ব্যবহার করে পাস করা হয়। বণিক অ্যাকাউন্ট API অ্যাকাউন্ট ডেটা পাস করার জন্য একাধিক সংস্থান সরবরাহ করে। এই সম্পদগুলির মধ্যে রয়েছে Account , User , BusinessInfo , এবং BusinessIdentity রিসোর্স৷
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে Account সংস্থান এবং মার্চেন্ট অ্যাকাউন্ট API-এ Account সংস্থানের মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
id | name |
name | accountName |
kind | পাওয়া যায় না |
websiteUrl | Homepage রিসোর্সে uri ক্ষেত্র |
adultContent | adultContent |
sellerId | AccountRelationship রিসোর্সে accountIdAlias ফিল্ড |
users | [User](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users) রিসোর্সে |
youtubeChannelLinks | এখনো পাওয়া যায় নি |
googleMyBusinessLink | এখনো পাওয়া যায় নি |
businessInformation | [businessInfo](/merchant/api/reference/rest/v1/BusinessInfo) রিসোর্সে |
businessIdentity | [businessIdentity](/merchant/api/reference/rest/v1/BusinessIdentity) রিসোর্সে |
automaticImprovements | এখনো পাওয়া যায় নি |
adsLinks | AccountService সম্পদে campaignsManagement ক্ষেত্র |
cssId | শুধুমাত্র CSS API এ উপলব্ধ |
labelIds | শুধুমাত্র CSS API এ উপলব্ধ |
accountManagement | AccountService রিসোর্সে accountManagement ফিল্ড |
automaticLabelIds | শুধুমাত্র CSS API এ উপলব্ধ |
conversionSettings | এখনো পাওয়া যায় নি |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountUser সংস্থান এবং মার্চেন্ট অ্যাকাউন্ট API-এ User সংস্থানের মধ্যে একটি তুলনা প্রদান করে৷
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
emailAddress | ইমেল name অংশ ( accounts/{account}/users/{email} )। |
admin | user#accessRights.ADMIN |
orderManager | পাওয়া যায় না |
paymentsManager | পাওয়া যায় না |
paymentsAnalyst | পাওয়া যায় না |
reportingManager | user#accessRights.PERFORMANCE_REPORTING |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountBusinessInformation রিসোর্স এবং মার্চেন্ট অ্যাকাউন্ট এপিআই-এ এর সমতুল্য সংস্থান businessInfo মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
businessInformation | businessInfo |
phoneNumber | phone |
phoneVerificationStatus | phoneVerificationState |
customerService | customerService |
koreanBusinessRegistrationNumber | koreanBusinessRegistrationNumber |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountBusinessIdentity রিসোর্স এবং মার্চেন্ট অ্যাকাউন্ট API-এ businessIdentity সংস্থানের মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
blackOwned | blackOwned |
womenOwned | womenOwned |
veteranOwned | veteranOwned |
latinoOwned | latinoOwned |
smallBusiness | smallBusiness |
includeForPromotions | promotionsConsent |
- true PROMOTION_CONSENT_GIVEN বোঝায় | |
- false PROMOTION_CONSENT_DENIED বোঝায় |
Content API-এ AccountIdentityType রিসোর্স IdentityAttribute টাইপ এবং MerchantAPI-তে এর ফিল্ড identityDeclaration দ্বারা প্রতিনিধিত্ব করা হয়।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
self_identified | identityDeclaration |
- true SELF_IDENTIFIES_AS বোঝায় | |
- false DOES_NOT_SELF_IDENTIFY_AS বোঝায় |
পদ্ধতি
মার্চেন্ট অ্যাকাউন্ট এপিআই-তে নিম্নলিখিত পদ্ধতিগুলি চালু করা হয়েছে:
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
accounts.authinfo | কোনো ফিল্টার ছাড়াই GET https://merchantapi.googleapis.com/accounts/v1beta/accounts |
accounts.claimwebsite | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId /homepage:claim |
| আরও তথ্যের জন্য, পদ্ধতি দেখুন: accounts.v1beta.accounts.homepage.claim | |
accounts.custombatch | পাওয়া যায় না। বণিক API-এ কাস্টম ব্যাচ সমর্থিত নয়। |
accounts.delete | DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId মুছুন |
accounts.get | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId ` |
accounts.insert | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure |
| আরও তথ্যের জন্য, একটি বণিক অ্যাকাউন্ট তৈরি করুন এবং কনফিগার করুন দেখুন৷ | |
accounts.link | AccountService সম্পদ |
accounts.list | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId :listSubaccounts |
accounts.listlinks | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId /services পান |
accounts.update | সম্পদের জন্য একটি আপডেট অনুরোধের মানচিত্র যেখানে প্রয়োজনীয় ক্ষেত্র বা ক্ষেত্রগুলির সেট সংজ্ঞায়িত করা হয়েছে। |
এই ডকুমেন্টটি ব্যাখ্যা করে কিভাবে আপনি Content API v2.1 থেকে Merchant API-এ স্থানান্তর করতে পারেন।
Content API v2.1 থেকে Merchant API-এ পরিবর্তনের ওভারভিউ
Merchant API Content API v2.1 এর উপর উল্লেখযোগ্য উন্নতি প্রবর্তন করে, যার লক্ষ্য ডেভেলপার এবং ব্যবসার জন্য ব্যবহারযোগ্যতা, ধারাবাহিকতা এবং নমনীয়তা বৃদ্ধি করা।
দানাদার সম্পদ কাঠামো
মার্চেন্ট এপিআই-এর সম্পদগুলি একক ধারণার প্রতিনিধিত্ব করে, যেমন account , businessDetails , user , homepage এবং program । তারা তাদের সম্পর্ক প্রতিফলিত করার জন্য শ্রেণিবদ্ধভাবে সংগঠিত হয়। উদাহরণস্বরূপ, একটি account হল একজন user মূল সম্পদ।
ইউনিফাইড অ্যাকাউন্ট পরিষেবা
সমস্ত অ্যাকাউন্ট পরিষেবাগুলি (উদাহরণস্বরূপ, MCAs এবং তাদের সাব-অ্যাকাউন্টগুলির জন্য বা তৃতীয় পক্ষের পরিষেবা প্রদানকারী এবং অ্যাকাউন্টগুলির মধ্যে অ্যাকাউন্ট একত্রিতকরণ) একটি ইউনিফাইড accountService রিসোর্সের মাধ্যমে পরিচালিত হয়। পরিষেবা প্রদানকারীরা accountRelationship রিসোর্স ব্যবহার করে তাদের সম্পর্ক পরিচালনা করতে পারে।
সরলীকৃত URL গঠন
ইউআরএলগুলি এখন একাধিক আইডির পরিবর্তে একটি একক অ্যাকাউন্ট আইডি ব্যবহার করে (উদাহরণস্বরূপ, merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId} )। URL পাথগুলি দানাদার সংস্থান কাঠামোকে মিরর করে।
অন্যান্য উন্নতি
- বর্ধিত প্রোগ্রাম এবং ব্যবহারকারী ব্যবস্থাপনা : শপিং বিজ্ঞাপন এবং বিনামূল্যে তালিকার মতো প্রোগ্রামগুলি একক
programসংস্থানের অধীনে একত্রিত করা হয়।userসম্পদে দানাদার অ্যাক্সেসের অধিকার সহ ব্যাপক ব্যবস্থাপনার ক্ষমতা রয়েছে। - স্ট্রাকচার্ড ব্যবসায়িক তথ্য এবং ব্যবসার পরিচয় :
businessInfoএবংbusinessIdentityজন্য উৎসর্গীকৃত সংস্থান রয়েছে। তারা অঞ্চল-নির্দিষ্ট ডেটার জন্য ক্ষেত্রগুলির সাথে সম্মতি সমর্থন অন্তর্ভুক্ত করে। উদাহরণস্বরূপ, কোরিয়ান ব্যবসা নিবন্ধন নম্বর। - স্ট্রীমলাইনড হোমপেজ দাবি করা : একটি ডেডিকেটেড
homepageরিসোর্স স্টোরের হোমপেজ ইউআরএল পরিচালনা করে।claimএবংunclaimমতো পদ্ধতিগুলি API এর মাধ্যমে সরাসরি দাবি করা ওয়েবসাইট পরিচালনা করে। - Google API নির্দেশিকাগুলির সাথে সম্মতি : মার্চেন্ট API-এর লক্ষ্য হল Google-এর API উন্নতির প্রস্তাবগুলির সাথে সারিবদ্ধ করা৷
অ্যাকাউন্ট পরিচালনার স্থানান্তর
আপনি আপনার বণিক অ্যাকাউন্ট তৈরি এবং পরিচালনা করতে accounts সম্পদ ব্যবহার করতে পারেন। আরও তথ্যের জন্য, মার্চেন্ট অ্যাকাউন্ট API-এর ওভারভিউ দেখুন।
এই পৃষ্ঠাটি বর্ণনা করে যে আপনি কীভাবে সামগ্রী API থেকে মার্চেন্ট API-এ অ্যাকাউন্ট পরিচালনা স্থানান্তর করতে পারেন।
অনুরোধ
বণিক অ্যাকাউন্ট API-এর জন্য নিম্নলিখিত অনুরোধ URL বিন্যাসটি ব্যবহার করুন:
POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
এখানে অ্যাকাউন্ট তৈরি এবং পরিচালনার অনুরোধের জন্য বণিক অ্যাকাউন্ট API-এর সাথে কেনাকাটার জন্য সামগ্রী API-এর একটি নমুনা তুলনা করা হল:
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/ merchantId /accounts/ accountId / | https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId |
| শনাক্তকারী | মার্চেন্টআইডি /accounts/ অ্যাকাউন্ট আইডি | accounts/ অ্যাকাউন্ট আইডি |
সম্পদ
অ্যাকাউন্টের ডেটা কেনাকাটার জন্য সামগ্রী API-তে Account সংস্থান ব্যবহার করে পাস করা হয়। বণিক অ্যাকাউন্ট API অ্যাকাউন্ট ডেটা পাস করার জন্য একাধিক সংস্থান সরবরাহ করে। এই সম্পদগুলির মধ্যে রয়েছে Account , User , BusinessInfo , এবং BusinessIdentity রিসোর্স৷
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে Account সংস্থান এবং মার্চেন্ট অ্যাকাউন্ট API-এ Account সংস্থানের মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
id | name |
name | accountName |
kind | পাওয়া যায় না |
websiteUrl | Homepage রিসোর্সে uri ক্ষেত্র |
adultContent | adultContent |
sellerId | AccountRelationship রিসোর্সে accountIdAlias ফিল্ড |
users | [User](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users) রিসোর্সে |
youtubeChannelLinks | এখনো পাওয়া যায় নি |
googleMyBusinessLink | এখনো পাওয়া যায় নি |
businessInformation | [businessInfo](/merchant/api/reference/rest/v1/BusinessInfo) রিসোর্সে |
businessIdentity | [businessIdentity](/merchant/api/reference/rest/v1/BusinessIdentity) রিসোর্সে |
automaticImprovements | এখনো পাওয়া যায় নি |
adsLinks | AccountService সম্পদে campaignsManagement ক্ষেত্র |
cssId | শুধুমাত্র CSS API এ উপলব্ধ |
labelIds | শুধুমাত্র CSS API এ উপলব্ধ |
accountManagement | AccountService রিসোর্সে accountManagement ফিল্ড |
automaticLabelIds | শুধুমাত্র CSS API এ উপলব্ধ |
conversionSettings | এখনো পাওয়া যায় নি |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountUser সংস্থান এবং মার্চেন্ট অ্যাকাউন্ট API-এ User সংস্থানের মধ্যে একটি তুলনা প্রদান করে৷
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
emailAddress | ইমেল name অংশ ( accounts/{account}/users/{email} )। |
admin | user#accessRights.ADMIN |
orderManager | পাওয়া যায় না |
paymentsManager | পাওয়া যায় না |
paymentsAnalyst | পাওয়া যায় না |
reportingManager | user#accessRights.PERFORMANCE_REPORTING |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountBusinessInformation রিসোর্স এবং মার্চেন্ট অ্যাকাউন্ট এপিআই-এ এর সমতুল্য সংস্থান businessInfo মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
businessInformation | businessInfo |
phoneNumber | phone |
phoneVerificationStatus | phoneVerificationState |
customerService | customerService |
koreanBusinessRegistrationNumber | koreanBusinessRegistrationNumber |
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API-তে AccountBusinessIdentity রিসোর্স এবং মার্চেন্ট অ্যাকাউন্ট API-এ businessIdentity সংস্থানের মধ্যে একটি তুলনা প্রদান করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
blackOwned | blackOwned |
womenOwned | womenOwned |
veteranOwned | veteranOwned |
latinoOwned | latinoOwned |
smallBusiness | smallBusiness |
includeForPromotions | promotionsConsent |
- true PROMOTION_CONSENT_GIVEN বোঝায় | |
- false PROMOTION_CONSENT_DENIED বোঝায় |
Content API-এ AccountIdentityType রিসোর্স IdentityAttribute টাইপ এবং MerchantAPI-তে এর ফিল্ড identityDeclaration দ্বারা প্রতিনিধিত্ব করা হয়।
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
self_identified | identityDeclaration |
- true SELF_IDENTIFIES_AS বোঝায় | |
- false DOES_NOT_SELF_IDENTIFY_AS বোঝায় |
পদ্ধতি
মার্চেন্ট অ্যাকাউন্ট এপিআই-তে নিম্নলিখিত পদ্ধতিগুলি চালু করা হয়েছে:
| কেনাকাটার জন্য সামগ্রী API | বণিক অ্যাকাউন্ট API |
|---|---|
accounts.authinfo | কোনো ফিল্টার ছাড়াই GET https://merchantapi.googleapis.com/accounts/v1beta/accounts |
accounts.claimwebsite | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId /homepage:claim |
| আরও তথ্যের জন্য, পদ্ধতি দেখুন: accounts.v1beta.accounts.homepage.claim | |
accounts.custombatch | পাওয়া যায় না। বণিক API-এ কাস্টম ব্যাচ সমর্থিত নয়। |
accounts.delete | DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/ accountId মুছুন |
accounts.get | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId ` |
accounts.insert | POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure |
| আরও তথ্যের জন্য, একটি বণিক অ্যাকাউন্ট তৈরি করুন এবং কনফিগার করুন দেখুন৷ | |
accounts.link | AccountService সম্পদ |
accounts.list | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId :listSubaccounts |
accounts.listlinks | GET https://merchantapi.googleapis.com/accounts/v1beta/ accountId /services পান |
accounts.update | সম্পদের জন্য একটি আপডেট অনুরোধের মানচিত্র যেখানে প্রয়োজনীয় ক্ষেত্র বা ক্ষেত্রগুলির সেট সংজ্ঞায়িত করা হয়েছে। |