মার্চেন্ট এপিআই-এর সাথে ইন্টারঅ্যাক্ট করার এই পদ্ধতিতে, সাধারণত HTTP(S)-এর মাধ্যমে API এন্ডপয়েন্টগুলিতে সরাসরি কাঁচা অনুরোধ করা হয়। আপনি অনুরোধের বডি তৈরি করা, হেডার সেট করা (প্রমাণীকরণ সহ) এবং প্রতিক্রিয়া বিশ্লেষণ করার মতো দিকগুলি ম্যানুয়ালি পরিচালনা করেন।
ধাপ ১. একজন ডেভেলপার হিসেবে নিবন্ধন করুন।
মার্চেন্ট এপিআই ব্যবহার করতে, আপনাকে অবশ্যই আপনার ডেভেলপারের যোগাযোগের তথ্য নিবন্ধন করতে হবে।
নিবন্ধনের মাধ্যমে নিম্নলিখিত কাজগুলি সম্পন্ন হয়:
- একজন ব্যবহারকারীকে
API developerভূমিকা অর্পণ করে আপনার Merchant Center অ্যাকাউন্টের জন্য একটি প্রযুক্তিগত যোগাযোগ তৈরি করে। এর ফলে Google বিশেষ করে API এবং ডেভেলপার যে বৈশিষ্ট্যগুলি ব্যবহার করছেন সেগুলি সম্পর্কে গুরুত্বপূর্ণ আপডেট পাঠাতে পারে, যেমন পরিষেবা ঘোষণা এবং নতুন বৈশিষ্ট্য সম্পর্কে তথ্য, যা ডেভেলপারদের কাছে কম আকর্ষণীয় হতে পারে। - একাধিক মার্চেন্ট অ্যাকাউন্টের সাথে একাধিকবার নিবন্ধন না করেই আপনাকে কাজ করতে দেয়। আপনি যখন নিবন্ধন করেন, তখন মার্চেন্ট 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"
]
}
ধাপ ২. ডেভেলপারের পরিচিতি এবং অনুমতিগুলি পরিচালনা করুন
যখন আপনি নিবন্ধন করবেন:
- যদি ইমেল ঠিকানাটি Merchant Center অ্যাকাউন্টের কোনও ব্যবহারকারীর হয়, তাহলে সেই ব্যবহারকারীকে
API_DEVELOPERভূমিকা দেওয়া হবে। - যদি ইমেল ঠিকানাটি কোনও বিদ্যমান ব্যবহারকারীর না হয়, তাহলে সেই ঠিকানায় একটি আমন্ত্রণ পাঠানো হবে। প্রাপককে
API_DEVELOPERভূমিকায় নতুন ব্যবহারকারী হিসেবে যোগ করার জন্য আমন্ত্রণটি গ্রহণ করতে হবে।
প্রাথমিক নিবন্ধনের পরে, আমরা আপনাকে একাধিক ডেভেলপার যুক্ত করার এবং তাদের অতিরিক্ত অ্যাক্সেস অধিকার দেওয়ার পরামর্শ দিচ্ছি।
ধাপ ২ক। অতিরিক্ত অনুমতি দিন
গুরুত্বপূর্ণ বিজ্ঞপ্তিগুলি গ্রহণের জন্য API_DEVELOPER ভূমিকা প্রয়োজন, তবে মার্চেন্ট সেন্টারের মধ্যে এর ন্যূনতম অনুমতি রয়েছে। এই ব্যবহারকারীকে মার্চেন্ট সেন্টার UI-তে অন্যান্য API কল করতে বা সেটিংস পরিচালনা করতে অনুমতি দেওয়ার জন্য, আপনাকে তাদের অতিরিক্ত ভূমিকা প্রদান করতে হবে, যেমন 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"
]
}
ধাপ ২খ। ব্যাকআপ ডেভেলপার যোগ করুন
আপনার প্রাথমিক ডেভেলপার পরিচিতি আপনার প্রতিষ্ঠান ছেড়ে চলে গেলে আপনার API অ্যাক্সেস যাতে ব্যাহত না হয়, তার জন্য আপনার কমপক্ষে একজন ব্যাকআপ ডেভেলপার যোগ করা উচিত।
আপনি accounts.users.create পদ্ধতি ব্যবহার করে একজন ব্যবহারকারী যোগ করতে পারেন অথবা accounts.users.patch ব্যবহার করে একজন ব্যবহারকারী আপডেট করতে পারেন। আমরা এই ব্যবহারকারীকে ADMIN এবং API_DEVELOPER উভয় ভূমিকা দেওয়ার পরামর্শ দিচ্ছি।
ধাপ ৩. একটি প্রাথমিক পণ্য ডেটা উৎস তৈরি করুন
একটি পণ্য সন্নিবেশ করার জন্য, আপনার একটি প্রাথমিক পণ্য ডেটা উৎসের প্রয়োজন। নিম্নলিখিত অনুরোধটি দেখায় যে কীভাবে একটি ডেটা উৎস তৈরি করবেন যা আপনি আপনার অ্যাকাউন্টে একটি পণ্য সন্নিবেশ করতে ব্যবহার করতে পারেন:
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"
}
আপনার তৈরি করা মার্চেন্ট সেন্টার অ্যাকাউন্টের আইডি দিয়ে {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-তে এই ডেটা সোর্সটি দেখতে পারেন। আরও তথ্যের জন্য, ডেটা সোর্স ট্যাবটি কীভাবে খুঁজে পাবেন তা দেখুন।
ধাপ ৪. একটি পণ্য ঢোকান।
ডেটা সোর্স তৈরি করার পর, এতে একটি পণ্য সন্নিবেশ করার চেষ্টা করুন। সঠিক 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 পদ্ধতি ব্যবহার করতে পারেন। আপনি এই পণ্যটি দেখতে Merchant Center UI ব্যবহার করতে পারেন। আপনার পণ্যের ডেটা দেখার বিষয়ে আরও তথ্যের জন্য, Merchant Center-এ পণ্যের ওভারভিউ দেখুন।