API এর সাথে মৌলিক ক্রিয়াকলাপ সম্পাদন করা এটি ব্যবহার শুরু করার একটি ভাল উপায়।
পূর্বশর্ত
আপনি শুরু করার আগে, নিম্নলিখিতগুলি সম্পূর্ণ করুন:
- নিশ্চিত করুন যে আপনার একটি বৈধ CSS সেন্টার অ্যাকাউন্ট আছে।
- একটি API বিকাশকারী নিবন্ধন করুন।
- আপনার অনুমতি সেটআপের সঠিকতা যাচাই করুন।
- আপনি CSS API সক্ষম করেছেন তা যাচাই করুন।
- আপনি আপনার পরিবেশের জন্য ক্লায়েন্ট লাইব্রেরি ইনস্টল করেছেন তা যাচাই করুন।
আরও তথ্যের জন্য, Quickstart দেখুন।
CSS API সক্রিয় করুন
CSS API ব্যবহার করতে একজন বিকাশকারী হিসাবে নিবন্ধন করুন, আপনাকে অবশ্যই আপনার CSS সেন্টার অ্যাকাউন্ট এবং আপনার Google ক্লাউড প্রকল্পকে বিকাশকারী নিবন্ধন পদ্ধতি ব্যবহার করে লিঙ্ক করতে হবে, নিম্নরূপ:
লিঙ্ক CSS সেন্টার এবং আপনার Google ক্লাউড প্রকল্প: লিঙ্কটি স্বয়ংক্রিয়ভাবে প্রতিষ্ঠিত হয়, কারণ কলারের অ্যাক্সেস টোকেন বা API কী-এর উপর ভিত্তি করে Google ক্লাউড প্রজেক্টে অ্যাক্সেস রয়েছে এবং তিনি CSS সেন্টার অ্যাকাউন্টের একজন অনুমোদিত ব্যবহারকারী।
একটি API বিকাশকারী নিবন্ধন করুন
CSS সেন্টার অ্যাকাউন্টে একজন API ডেভেলপার ব্যবহারকারী যোগ করুন: যদি একজন ব্যবহারকারী ইতিমধ্যেই বিদ্যমান থাকে তবে তাদের নতুন "API বিকাশকারী" অ্যাক্সেস টাইপ দেওয়া হবে। একজন নতুন ব্যবহারকারীর ক্ষেত্রে, তারা একটি CSS সেন্টার ইমেল আমন্ত্রণ পায়।
রেজিস্ট্রেশনের পর আপনি GetDeveloperRegistration ব্যবহার করে রেজিস্ট্রেশন স্ট্যাটাস দেখতে পারেন অথবা UnregisterGCP ব্যবহার করে আনরেজিস্টার করতে পারেন। আপনি নিম্নলিখিত নিবন্ধন কল ব্যবহার করতে পারেন:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
অনুরোধ সফলভাবে চালানোর পরে, প্রতিক্রিয়া আশা করুন:
{
"developerRegistration":
{
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": [
"GOOGLE_CLOUD_PROJECT_ID"
]
}
}
সিএসএস পণ্য
পণ্য সাব-এপিআই-এর মতো, CSS API CssProductInput এবং ListCssProduct মধ্যে পার্থক্য করে। InsertCssProductInput দিয়ে একটি পণ্য সন্নিবেশ করুন।
একবার আমাদের অভ্যন্তরীণ সিস্টেমগুলি পণ্যটি প্রক্রিয়া করার পরে (এতে কয়েক মিনিট সময় লাগতে পারে), এটি ListCssProducts দিয়ে পুনরুদ্ধার করুন।
raw_provided_id ব্যবহার করে আপনার পণ্য শনাক্ত করুন। আমরা সুপারিশ করি যে আপনি এমন একটি শনাক্তকারী ব্যবহার করুন যা আপনি ইতিমধ্যে আপনার নিজের সিস্টেমে ব্যবহার করছেন৷ বিকল্পভাবে, একটি তৈরি করার সাধারণ পদ্ধতিগুলির মধ্যে নিম্নলিখিতগুলির মধ্যে একটির ব্যবহার অন্তর্ভুক্ত:
- গ্লোবাললি ইউনিক আইডেন্টিফায়ার (GUID)
- ইউনিভার্সলি ইউনিক আইডেন্টিফায়ার (UUIDs)
- সংযুক্ত অনন্য পণ্য বৈশিষ্ট্য (উদাহরণস্বরূপ, brand_model_color_size)
আরও তথ্যের জন্য, একটি পণ্য সন্নিবেশ/তালিকা/আপডেট/মুছুন দেখুন।
মৌলিক অপারেশন
এখানে কয়েকটি মৌলিক অনুরোধ রয়েছে যা আপনি চেষ্টা করতে পারেন।
InsertCssProductInputব্যবহার করে একটি পরীক্ষার পণ্য সন্নিবেশ করুন। প্রেরণের বৈশিষ্ট্যগুলির বিষয়ে সহায়তার জন্য, এই নমুনা কোডটি পর্যালোচনা করুন।ListCssProductsব্যবহার করে আপনার সমস্ত পণ্য তালিকাভুক্ত করুন। নোট করুন যে একটি পণ্য সন্নিবেশ করা এবং তালিকার জন্য তার উপস্থিতির মধ্যে একটি ছোট প্রক্রিয়াকরণ বিলম্ব আছে৷ আপনি এখনই একটি দেখতে না পেলে, কয়েক সেকেন্ড পরে আবার চেষ্টা করুন।আপনার
cssproductinput.nameব্যবহার করেUpdateCssProductInputব্যবহার করে একটি একক পণ্য আপডেট করুন। আপডেট করার জন্য আপনাকে শুধুমাত্র প্রয়োজনীয় বৈশিষ্ট্যগুলি পাঠাতে হবে। একটি উদাহরণের জন্য, নমুনা কোড দেখুন।raw_provided_idসরবরাহ করেDeleteCssProductInpuব্যবহার করে পরীক্ষার পণ্যটি মুছুন।
সীমাবদ্ধতা
একটি পৃথক পণ্য সন্নিবেশ করা বা মুছে ফেলা ধীর হতে পারে। কর্মক্ষমতা উন্নত করতে, কর্মক্ষমতা উন্নত করতে Async ব্যবহার করুন । এটি সমান্তরালভাবে API কল করা সক্ষম করে।
তালিকা এবং আপনার অ্যাকাউন্ট লেবেল
CSS API-এ লেবেল ম্যানেজমেন্ট আপনাকে কাস্টম ট্যাগ ব্যবহার করে আপনার ক্লায়েন্ট মার্চেন্ট সেন্টার অ্যাকাউন্টগুলিকে প্রোগ্রাম্যাটিকভাবে সংগঠিত করতে দেয়। এই বৈশিষ্ট্যটি আপনাকে দক্ষতার সাথে ক্লায়েন্টদের শ্রেণীবদ্ধ করতে সহায়তা করে (উদাহরণস্বরূপ, প্রকার বা কৌশল অনুসারে), আরও ভাল সংগঠন এবং সুবিন্যস্ত ক্রিয়াকলাপ সক্ষম করে। আপনি লেবেলগুলিতে নিম্নলিখিত ফাংশনগুলি সম্পাদন করতে API ব্যবহার করতে পারেন: