আপনি কেনাকাটা বাস্তবায়নের জন্য আপনার বিদ্যমান সামগ্রী API এর সাথে বণিক API একীভূত করতে এই নির্দেশিকা ব্যবহার করতে পারেন।
এবার শুরু করা যাক
মার্চেন্ট এপিআই এবং এর সাব-এপিআই সম্পর্কে বিস্তারিত জানার জন্য মার্চেন্ট এপিআই ডিজাইন দেখুন।
মার্চেন্ট এপিআই ব্যবহার শুরু করতে, আপনার অনুরোধের URLগুলিকে নিম্নলিখিত ফর্ম্যাটে পরিবর্তন করুন:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
আরও তথ্যের জন্য কুইকস্টার্ট গাইড এবং মার্চেন্ট এপিআই রেফারেন্স দেখুন।
জিআরপিসি সমর্থন
মার্চেন্ট API gRPC এবং REST সমর্থন করে। আপনি একই সময়ে বণিক API-এর জন্য gRPC এবং কেনাকাটার জন্য সামগ্রী API-এর জন্য REST ব্যবহার করতে পারেন।
মার্চেন্ট এপিআই ক্লায়েন্ট লাইব্রেরির জন্য gRPC প্রয়োজন।
আরও তথ্যের জন্য gRPC ব্যবহার দেখুন।
সামঞ্জস্য
এই নির্দেশিকাটি সাধারণ পরিবর্তনগুলি বর্ণনা করে যা সমগ্র মার্চেন্ট API-এ প্রযোজ্য। নির্দিষ্ট বৈশিষ্ট্য পরিবর্তনের জন্য নিম্নলিখিত নির্দেশিকা দেখুন:
- মাইগ্রেট অ্যাকাউন্ট ম্যানেজমেন্ট
- শিপিং সেটিংস মাইগ্রেট করুন
- পণ্য ব্যবস্থাপনা মাইগ্রেট করুন
- মাইগ্রেট ডেটা সোর্স ম্যানেজমেন্ট
- স্থানান্তরিত জায় ব্যবস্থাপনা
- মাইগ্রেট প্রচার ব্যবস্থাপনা
- মাইগ্রেট রিপোর্টিং ব্যবস্থাপনা
- মাইগ্রেট রূপান্তর উত্স ব্যবস্থাপনা
- স্থানীয় ফিড অংশীদারিত্ব ব্যবস্থাপনা মাইগ্রেট করুন
Merchant API শপিং v2.1 বৈশিষ্ট্যের জন্য বিদ্যমান সামগ্রী API-এর পাশাপাশি কাজ করার জন্য ডিজাইন করা হয়েছে।
উদাহরণস্বরূপ, আপনি শপিং v2.1 ইনভেন্টরি এবং products বাস্তবায়নের জন্য আপনার বিদ্যমান সামগ্রী API-এর পাশাপাশি মার্চেন্ট ইনভেন্টরি API ব্যবহার করতে পারেন। আপনি একটি নতুন স্থানীয় পণ্য আপলোড করতে শপিংয়ের জন্য সামগ্রী API ব্যবহার করতে পারেন (যেটি আপনি স্থানীয় দোকানে বিক্রি করেন), তারপর সেই পণ্যের জন্য ইন-স্টোর তথ্য পরিচালনা করতে মার্চেন্ট ইনভেন্টরিস এপিআই LocalInventory সংস্থান ব্যবহার করুন।
ব্যাচ অনুরোধ
Merchant API কেনাকাটার জন্য সামগ্রী API-তে বৈশিষ্ট্যযুক্ত customBatch পদ্ধতি সমর্থন করে না। পরিবর্তে, ব্যাচের অনুরোধ পাঠান দেখুন। আপনি যদি customBatch ব্যবহার করেন, এবং মার্চেন্ট API-এর জন্য এই বৈশিষ্ট্যটির প্রয়োজন হয়, তাহলে আপনার প্রতিক্রিয়াতে কেন তা আমাদের জানান।
শনাক্তকারী
Google এর API উন্নতি নীতিগুলির সাথে সারিবদ্ধ করতে, আমরা মার্চেন্ট API সংস্থানগুলির শনাক্তকারীগুলিতে কিছু পরিবর্তন করেছি৷
নাম আইডি প্রতিস্থাপন করে
সমস্ত মার্চেন্ট API সংস্থান তাদের অনন্য শনাক্তকারী হিসাবে name ক্ষেত্রটি ব্যবহার করে।
আপনার কলগুলিতে name ক্ষেত্রটি কীভাবে ব্যবহার করবেন তার একটি উদাহরণ এখানে রয়েছে:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
এই নতুন name ক্ষেত্রটি মার্চেন্ট এপিআই-এ সমস্ত রিড এবং রাইট কলের জন্য রিসোর্স শনাক্তকারী হিসাবে ফেরত দেওয়া হয়।
name ক্ষেত্রে প্রত্যাবর্তিত মানটি নতুন আইডি বিন্যাস ব্যবহার করে।
উদাহরণ স্বরূপ, একটি রিসোর্স থেকে name পুনরুদ্ধার করার জন্য একটি getName() পদ্ধতি প্রয়োগ করুন এবং বণিক ও রিসোর্স আইডি থেকে name তৈরি করার পরিবর্তে একটি পরিবর্তনশীল হিসাবে আউটপুট সংরক্ষণ করুন।
নতুন আইডি ফরম্যাট
মার্চেন্ট এপিআই-এ, রিসোর্স আইডি নিম্নলিখিত ফর্ম্যাট ব্যবহার করে: channel~language~feedLabel~offerId
কন্টেন্ট এপিআই রিসোর্স ব্যবহার করা হয়েছে : আইডিতে প্রতিটি মানের মধ্যে ~ এর পরিবর্তে: channel:language:feedLabel:offerId
সমস্ত মার্চেন্ট API কল আইডির মানগুলির মধ্যে ~ সহ নতুন ফর্ম্যাট প্রদান করে৷ আমরা প্রতিক্রিয়া থেকে নতুন ফর্ম্যাট সংরক্ষণ করার এবং আপনার ভবিষ্যতের কলগুলিতে এটি ব্যবহার করার পরামর্শ দিই৷
শিশু সম্পদের জন্য পিতামাতার ক্ষেত্র
মার্চেন্ট API-এ, সমস্ত চাইল্ড রিসোর্সের parent ক্ষেত্র থাকে। আপনি সন্তানকে সন্নিবেশ করার জন্য সম্পদের name উল্লেখ করতে parent ক্ষেত্রটি ব্যবহার করতে পারেন, পুরো অভিভাবক সম্পদ পাস করার পরিবর্তে। আপনি সেই parent শিশু সম্পদের তালিকা করতে list পদ্ধতি সহ parent ক্ষেত্রটিও ব্যবহার করতে পারেন।
উদাহরণস্বরূপ, একটি প্রদত্ত পণ্যের জন্য স্থানীয় জায় তালিকাভুক্ত করতে, list পদ্ধতির জন্য parent ক্ষেত্রে পণ্যের name উল্লেখ করুন। এই ক্ষেত্রে, প্রদত্ত product ফেরত দেওয়া LocalInventory সম্পদের parent ।
প্রকারভেদ
এখানে মার্চেন্ট API সাব-এপিআই জুড়ে শেয়ার করা কিছু সাধারণ প্রকার রয়েছে।
দাম
মার্চেন্ট কমন প্যাকেজে Price জন্য কী পরিবর্তন করা হয়েছে তা এখানে:
| বিষয়বস্তু API | বণিক API | |
|---|---|---|
| পরিমাণ ক্ষেত্র | value:string | amountMicros:int64 |
| মুদ্রা ক্ষেত্র | currency:string | currencyCode:string |
Price পরিমাণ এখন মাইক্রোতে রেকর্ড করা হয়েছে, যেখানে 1 মিলিয়ন মাইক্রো আপনার মুদ্রার স্ট্যান্ডার্ড ইউনিটের সমতুল্য।
কেনাকাটার জন্য সামগ্রী API-তে, Price একটি স্ট্রিং আকারে একটি দশমিক সংখ্যা ছিল।
পরিমাণ ক্ষেত্রের নাম value থেকে পরিবর্তিত হয়েছে amountMicros
মুদ্রা ক্ষেত্রের নাম currency থেকে currencyCode পরিবর্তিত হয়েছে। ফর্ম্যাটটি ISO 4217 হিসাবে রয়ে গেছে।