অঞ্চল ব্যবস্থাপনায় অভিবাসন
এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশনকে Content API for Shopping-এর RegionsService থেকে Accounts সাব-API-এর অন্তর্গত RegionsService এ মাইগ্রেট করবেন।
রিজিয়নস সার্ভিসটি আপনাকে আঞ্চলিক মূল্য নির্ধারণ এবং শিপিং ওভাররাইডের মতো ব্যবহারের জন্য নিজস্ব ভৌগোলিক এলাকা নির্ধারণ করতে দেয়। আপনি RegionalInventory এবং ShippingSettings মতো সার্ভিসগুলোর সাথে রিজিয়ন ব্যবহার করতে পারেন।
মূল পার্থক্য
- এপিআই কাঠামো: রিজিয়নস সার্ভিসটি এখন মার্চেন্ট এপিআই-এর
Accountsসাব-এপিআই-এর একটি অংশ (উদাহরণস্বরূপ,merchantapi.googleapis.com/accounts/v1/...)। - রিসোর্স নেম: মার্চেন্ট এপিআই Get, Update, এবং Delete অপারেশনগুলির জন্য URL পাথে আলাদা
merchant_idএবংregion_idপ্যারামিটারের পরিবর্তে রিসোর্স নেম (accounts/{account}/regions/{region}) ব্যবহার করে। - AIP সম্মতি: মার্চেন্ট এপিআই মেথডগুলো স্ট্যান্ডার্ড এপিআই ইমপ্রুভমেন্ট প্রপোজাল প্যাটার্ন অনুসরণ করে (যেমন List/Create-এর জন্য
parent, Get/Delete-এর জন্যname, এবং স্ট্যান্ডার্ডupdate_maskব্যবহার)। - র্যাপার টাইপ: যে ফিল্ডগুলো আগে কন্টেন্ট এপিআই-তে
google.protobuf.StringValueবাgoogle.protobuf.BoolValueব্যবহার করত, সেগুলো এখন মার্চেন্ট এপিআই-তে স্ট্যান্ডার্ডoptionalফিল্ড ব্যবহার করে। - নতুন বৈশিষ্ট্য:
- মার্চেন্ট এপিআই, কোনো একটি পয়েন্টের চারপাশের ব্যাসার্ধের উপর ভিত্তি করে অঞ্চল নির্ধারণের জন্য,
Regionরিসোর্সের মধ্যেRadiusAreaনামক একটি টাইপ চালু করেছে (প্রাথমিকভাবে যার ভিজিবিলিটিTRUST_TESTER)। - ব্যাচ মেথডগুলো —
BatchCreateRegions,BatchUpdateRegions,BatchDeleteRegions— উপলব্ধ আছে।
- মার্চেন্ট এপিআই, কোনো একটি পয়েন্টের চারপাশের ব্যাসার্ধের উপর ভিত্তি করে অঞ্চল নির্ধারণের জন্য,
- ত্রুটি ব্যবস্থাপনা: ত্রুটি কোড এবং বার্তা আরও সুনির্দিষ্ট প্রতিক্রিয়া প্রদান করে।
অনুরোধ
অনুরোধের ধরণ যেভাবে পরিবর্তিত হয় তা এখানে দেওয়া হলো:
| আইটেম | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|---|
| এন্ডপয়েন্ট | https://shoppingcontent.googleapis.com | https://merchantapi.googleapis.com | মূল ডোমেইন পরিবর্তিত হয়। |
| পথ পান | /content/v2.1/{merchant_id}/regions/{region_id} | /accounts/v1/{name=accounts/*/regions/*} | মার্চেন্ট এপিআই accounts সাব-এপিআই এবং একটি রিসোর্স name ব্যবহার করে। |
| তালিকার পথ | /content/v2.1/{merchant_id}/regions | /accounts/v1/{parent=accounts/*}/regions | মার্চেন্ট এপিআই অ্যাকাউন্ট নির্দিষ্ট করতে parent ব্যবহার করে। |
| পথ তৈরি করুন | /content/v2.1/{merchant_id}/regions | /accounts/v1/{parent=accounts/*}/regions | মার্চেন্ট এপিআই parent ব্যবহার করে। region_id হলো রিকোয়েস্ট বডির একটি ফিল্ড। |
| আপডেট পাথ | /content/v2.1/{merchant_id}/regions/{region_id} | /accounts/v1/{name=accounts/*/regions/*} | মার্চেন্ট এপিআই-এর রিসোর্স নামটি বডির মধ্যে থাকা region অবজেক্টের একটি অংশ। |
| পাথ মুছুন | /content/v2.1/{merchant_id}/regions/{region_id} | /accounts/v1/{name=accounts/*/regions/*} | রিসোর্সের name ব্যবহার করে। |
শনাক্তকারী
আপনার আইডেন্টিফায়ারের ব্যবহার নিম্নরূপে পরিবর্তন করুন:
| আইটেম | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|---|
| অ্যাকাউন্ট | merchant_id (পূর্ণসংখ্যা) | account (পূর্ণসংখ্যা, name অংশ অথবা parent স্ট্রিং) | রিসোর্স নেম স্ট্রিং-এর মধ্যে থাকা অ্যাকাউন্ট আইডিটি খুঁজুন, যেমন, accounts/{account} । |
| অঞ্চল | region_id (স্ট্রিং) | {region} (স্ট্রিং, name স্ট্রিং-এর অংশ) | রিসোর্স নামের স্ট্রিং-এর মধ্যে থাকা অঞ্চল আইডিটি খুঁজুন, উদাহরণস্বরূপ, accounts/{account}/regions/{region} । |
| সম্পদের নাম | শুধুমাত্র অনুরোধের জন্য ব্যবহৃত হয় না। | name : accounts/{account}/regions/{region} | Get/Update/Delete অনুরোধের জন্য প্রমিত শনাক্তকারী। |
| অভিভাবকের নাম | শুধুমাত্র অনুরোধের জন্য ব্যবহৃত হয় না। | parent : accounts/{account} | তালিকা/তৈরি অনুরোধের জন্য প্রমিত শনাক্তকারী। |
সম্পদ
Region সম্পদ কাঠামোতে সামান্য পরিবর্তন আনা হয়েছে:
| আইটেম | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|---|
| সম্পদ শনাক্তকারী | region_id (স্ট্রিং), merchant_id (পূর্ণসংখ্যা ৬৪) | name (স্ট্রিং): accounts/{account}/regions/{region} | মার্চেন্ট এপিআই রিসোর্স আইডেন্টিফায়ার হিসেবে একটিমাত্র name ফিল্ড ব্যবহার করে। |
display_name | google.protobuf.StringValue | optional string | মোড়ক প্রকার সরানো হয়েছে। |
radius_area | উপলব্ধ নয় (N/A) | RadiusArea | এই নতুন টাইপটি ব্যাসার্ধের মাধ্যমে অঞ্চল নির্ধারণ করে। এর অন্তর্ভুক্ত উপাদানগুলো হলো region_code , lat_lng , radius , radius_units । ডিফল্টরূপে, এর দৃশ্যমানতা সীমাবদ্ধ থাকে। |
regional_inventory_eligible | google.protobuf.BoolValue (শুধুমাত্র আউটপুট) | optional bool (শুধুমাত্র আউটপুট) | মোড়ক প্রকার সরানো হয়েছে। |
shipping_eligible | google.protobuf.BoolValue (শুধুমাত্র আউটপুট) | optional bool (শুধুমাত্র আউটপুট) | মোড়ক প্রকার সরানো হয়েছে। |
পদ্ধতি
আপনার পদ্ধতি ব্যবহারের ধরন নিম্নরূপে পরিবর্তন করুন:
| আইটেম | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|---|
| অঞ্চল পান | GetRegion | GetRegion | অনুরোধটিতে name ব্যবহার করা হয়েছে। |
| অঞ্চল তৈরি করুন | CreateRegion | CreateRegion | অনুরোধটি URL থেকে parent গ্রহণ করে, এবং অনুরোধের বডিতে region অবজেক্ট ও region_id অন্তর্ভুক্ত থাকে। |
| অঞ্চল আপডেট করুন | UpdateRegion | UpdateRegion | অনুরোধটিতে region (যার মধ্যে অবশ্যই region.name অন্তর্ভুক্ত থাকতে হবে) এবং update_mask ব্যবহৃত হয়। |
| অঞ্চল মুছুন | DeleteRegion | DeleteRegion | অনুরোধটিতে name ব্যবহার করা হয়েছে। |
| অঞ্চলগুলির তালিকা | ListRegions | ListRegions | অনুরোধটি parent ব্যবহার করে। page_size এবং page_token আচরণ সামঞ্জস্যপূর্ণ। |
| ব্যাচ তৈরি করুন | প্রযোজ্য নয় | BatchCreateRegions | এটি একটি নতুন পদ্ধতি। |
| ব্যাচ আপডেট | প্রযোজ্য নয় | BatchUpdateRegions | এটি একটি নতুন পদ্ধতি। |
| একসাথে অনেকগুলো মুছে ফেলা | প্রযোজ্য নয় | BatchDeleteRegions | এটি একটি নতুন পদ্ধতি। |
ক্ষেত্রগুলির নাম পরিবর্তন করুন
| আইটেম | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|---|
| অ্যাকাউন্ট আইডি | merchant_id | account ( name অংশ বা parent ) | রিসোর্স name স্ট্রিং-এর সাথে একীভূত করা হয়েছে। এটি Region (রেসপন্স) এবং API অনুরোধ করার জন্য ব্যবহৃত প্রোটোবাফ মেসেজগুলোকে প্রভাবিত করে, যেমন CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest এবং ListRegionsRequest । |
| অঞ্চল আইডি | region_id | region ( name অংশ), region_id | বেশিরভাগ ক্ষেত্রে name সাথে সমন্বিত, CreateRegionRequest এ একটি পৃথক region_id ফিল্ড থাকে। এটি Region (রেসপন্স) এবং CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest ও ListRegionsRequest মতো API অনুরোধ করার জন্য ব্যবহৃত প্রোটোবাফ মেসেজগুলোকে প্রভাবিত করে। |
| অঞ্চলের নাম (আউটপুট) | region_id | name | রেসপন্সের প্রাথমিক শনাক্তকারী ফিল্ডটি এখন সম্পূর্ণ রিসোর্স name । এটি Region প্রভাবিত করে। |
| প্রদর্শনের নাম | display_name | display_name | টাইপটি StringValue থেকে optional string এ পরিবর্তিত হয়। এটি Region প্রভাবিত করে। |
| যোগ্যতার ফ্ল্যাগ | ...eligible | ...eligible | টাইপটি BoolValue থেকে optional bool এ পরিবর্তিত হয়। এটি Region প্রভাবিত করে। |
| মাস্ক আপডেট করুন | update_mask | update_mask | Region ফিল্ডের পাথ। এটি UpdateRegionRequest প্রভাবিত করে। |