মার্চেন্ট এপিআই এর সাথে ইন্টারঅ্যাক্ট করার এই পদ্ধতিতে সরাসরি এপিআই এন্ডপয়েন্টে, সাধারণত HTTP(S) এর মাধ্যমে কাঁচা অনুরোধ করুন। আপনি ম্যানুয়ালি রিকোয়েস্ট বডি গঠন, হেডার সেট করা (প্রমাণিকরণ সহ), এবং প্রতিক্রিয়া পার্স করার মতো দিকগুলি পরিচালনা করেন।
ধাপ 1. ডেভেলপার হিসেবে নিবন্ধন করুন
মার্চেন্ট API ব্যবহার করতে, আপনাকে অবশ্যই আপনার বিকাশকারীর যোগাযোগের তথ্য নিবন্ধন করতে হবে।
নিবন্ধন নিম্নলিখিত সম্পন্ন করে:
- একজন ব্যবহারকারীকে
API developerভূমিকা অর্পণ করে আপনার Merchant Center অ্যাকাউন্টের জন্য একটি প্রযুক্তিগত যোগাযোগ তৈরি করে। এটি Google-কে বিশেষভাবে API এবং বিকাশকারী যে বৈশিষ্ট্যগুলি ব্যবহার করছে সে সম্পর্কে গুরুত্বপূর্ণ আপডেট পাঠাতে দেয়, যেমন পরিষেবার ঘোষণা এবং নতুন বৈশিষ্ট্য সম্পর্কে তথ্য, যা অ-বিকাশকারীদের কাছে কম আগ্রহী হতে পারে৷ - একাধিকবার নিবন্ধন না করেই আপনাকে একাধিক মার্চেন্ট অ্যাকাউন্টের সাথে কাজ করতে দেয়। আপনি যখন নিবন্ধন করেন, তখন মার্চেন্ট এপিআইকে প্রমাণীকরণ করতে ব্যবহৃত Google ক্লাউড প্রজেক্ট আইডি আপনার বণিক কেন্দ্র অ্যাকাউন্টের সাথে যুক্ত থাকে, যার প্রযুক্তিগত পরিচিতি রয়েছে (
API developer)। এইভাবে, নিবন্ধিত Google ক্লাউড প্রকল্পের সাথে প্রমাণীকরণ সম্পন্ন হওয়া পর্যন্ত আপনি আপনার পরিচালনা করা সমস্ত বণিক অ্যাকাউন্টগুলির জন্য গুরুত্বপূর্ণ আপডেট পেতে পারেন৷
রেজিস্ট্রেশন করার সময়, রেজিস্ট্রেশনে বিস্তারিত পূর্বশর্ত এবং সীমাবদ্ধতাগুলি পর্যবেক্ষণ করুন।
developerRegistration.registerGcp পদ্ধতি ব্যবহার করে নিবন্ধন করতে, আপনি অনুরোধের অংশে উপযুক্ত ইমেল ঠিকানা দিয়ে {DEVELOPER_EMAIL} প্রতিস্থাপন করে এই উদাহরণ দিয়ে শুরু করতে পারেন।
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
"developerEmail": "{DEVELOPER_EMAIL}"
}
একটি সফল কল একটি DeveloperRegistration সংস্থান ফেরত দেয়, যা আপনার প্রকল্প এবং আপনার অ্যাকাউন্টের মধ্যে লিঙ্ক নিশ্চিত করে৷
{
"name": "accounts/{ACCOUNT_ID}/developerRegistration",
"gcpIds": [
"123456789012345"
]
}
ধাপ 2. বিকাশকারীর পরিচিতি এবং অনুমতিগুলি পরিচালনা করুন৷
আপনি যখন নিবন্ধন করবেন:
- যদি ইমেল ঠিকানাটি Merchant Center অ্যাকাউন্টের কোনো ব্যবহারকারীর হয়, তাহলে সেই ব্যবহারকারীকে
API_DEVELOPERভূমিকা দেওয়া হয়। - যদি ইমেল ঠিকানাটি বিদ্যমান ব্যবহারকারীর না হয়, তাহলে সেই ঠিকানায় একটি আমন্ত্রণ পাঠানো হয়।
API_DEVELOPERভূমিকা সহ একজন নতুন ব্যবহারকারী হিসাবে যোগ করার জন্য প্রাপককে আমন্ত্রণ গ্রহণ করতে হবে৷
প্রাথমিক নিবন্ধনের পরে, আমরা সুপারিশ করি যে আপনি একাধিক বিকাশকারীকে যুক্ত করুন এবং তাদের অতিরিক্ত অ্যাক্সেসের অধিকার প্রদান করুন৷
ধাপ 2a। অতিরিক্ত অনুমতি দিন
গুরুত্বপূর্ণ বিজ্ঞপ্তিগুলি পাওয়ার জন্য API_DEVELOPER ভূমিকার প্রয়োজন, তবে এটির Merchant Center-এর মধ্যে ন্যূনতম অনুমতি রয়েছে৷ এই ব্যবহারকারীকে অন্য API কল করতে বা Merchant Center UI-তে সেটিংস পরিচালনা করার অনুমতি দিতে, আপনাকে তাদের অতিরিক্ত ভূমিকা দিতে হবে, যেমন STANDARD বা ADMIN ৷ আরও তথ্যের জন্য, অ্যাক্সেসের ধরন দেখুন।
আপনি accounts.users.patch পদ্ধতির মাধ্যমে ব্যবহারকারীর অ্যাক্সেসের অধিকার আপডেট করতে পারেন।
নিম্নলিখিত উদাহরণ দেখায় কিভাবে একজন ব্যবহারকারীকে ADMIN এবং API_DEVELOPER উভয় ভূমিকা প্রদান করতে আপডেট করতে হয়। এটি তাদের সম্পূর্ণরূপে অ্যাকাউন্ট পরিচালনা করতে দেয় এবং তারা API-সম্পর্কিত যোগাযোগগুলিও পাবে।
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights
{
"access_rights": [
"ADMIN",
"API_DEVELOPER"
]
}
ধাপ 2 খ. ব্যাকআপ ডেভেলপার যোগ করুন
যদি আপনার প্রাথমিক বিকাশকারী পরিচিতি আপনার সংস্থা ছেড়ে চলে যায় তাহলে আপনার API অ্যাক্সেস ব্যাহত হওয়া থেকে আটকাতে, আপনাকে অন্তত একজন ব্যাকআপ বিকাশকারী যোগ করা উচিত।
আপনি accounts.users.create পদ্ধতির সাথে একজন ব্যবহারকারীকে যোগ করতে পারেন অথবা accounts.users.patch মাধ্যমে একজনকে আপডেট করতে পারেন। আমরা এই ব্যবহারকারীকে ADMIN এবং API_DEVELOPER উভয় ভূমিকা দেওয়ার সুপারিশ করি৷
ধাপ 3. একটি প্রাথমিক পণ্য ডেটা উৎস তৈরি করুন
একটি পণ্য সন্নিবেশ করার জন্য, আপনার একটি প্রাথমিক পণ্য ডেটা উত্স প্রয়োজন৷ নিম্নলিখিত অনুরোধটি দেখায় কিভাবে একটি ডেটা উত্স তৈরি করতে হয় যা আপনি আপনার অ্যাকাউন্টে একটি পণ্য সন্নিবেশ করতে ব্যবহার করতে পারেন:
POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources
{
"primaryProductDataSource": {
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
আপনার তৈরি বণিক কেন্দ্র অ্যাকাউন্টের ID দিয়ে {ACCOUNT_ID} প্রতিস্থাপন করুন।
আপনি এই অনুরোধটি সফলভাবে চালানোর পরে, আপনি নিম্নলিখিত প্রতিক্রিয়া দেখতে পাবেন:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
name ক্ষেত্রের মান কপি করুন। আপনি একটি পণ্য সন্নিবেশ এটি প্রয়োজন হবে.
আপনি Merchant Center UI-তে এই ডেটা উৎস দেখতে পারেন। আরও তথ্যের জন্য, ডেটা উত্স ট্যাবটি কীভাবে সন্ধান করবেন তা দেখুন।
ধাপ 4. একটি পণ্য ঢোকান
একবার আপনি ডেটা উত্স তৈরি করার পরে, এটিতে একটি পণ্য সন্নিবেশ করার চেষ্টা করুন। সঠিক ACCOUNT_ID সরবরাহ করে নিম্নলিখিতটি চালান। আপনি আগে কপি করা মান দিয়ে {DATASOURCE_NAME} প্রতিস্থাপন করুন।
POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"productAttributes": {
"gender": "MALE",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
আপনি এই অনুরোধটি সফলভাবে চালানোর পরে, আপনি নিম্নলিখিত প্রতিক্রিয়া দেখতে পাবেন:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"productAttributes": {
"brand": "New brand",
"gender": "MALE"
}
}
নতুন তৈরি পণ্যের পণ্যের আইডি হল en~US~tshirt-123 । আপনি এই পণ্যের বিবরণ পুনরুদ্ধার করতে accounts.products.get পদ্ধতি ব্যবহার করতে পারেন। আপনি এই পণ্যটি দেখতে বণিক কেন্দ্র UI ব্যবহার করতে পারেন। আপনার পণ্য ডেটা দেখুন দেখুন।