মাইগ্রেশন, সামঞ্জস্য
স্থানান্তর অঞ্চল ব্যবস্থাপনা
এই গাইডটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশন RegionsService এ Content API থেকে কেনাকাটার জন্য অ্যাকাউন্ট সাব-API-এর মধ্যে RegionsService এ স্থানান্তর করা যায়।
অঞ্চল পরিষেবা আপনাকে আঞ্চলিক মূল্য এবং শিপিং ওভাররাইডের মতো ব্যবহারের ক্ষেত্রে কাস্টম ভৌগলিক অঞ্চলগুলিকে সংজ্ঞায়িত করতে দেয়৷ আপনি RegionalInventory এবং ShippingSettings এর মতো পরিষেবা সহ অঞ্চলগুলি ব্যবহার করতে পারেন৷
মূল পার্থক্য
- API গঠন: অঞ্চল পরিষেবা এখন বণিক API (উদাহরণস্বরূপ,
merchantapi.googleapis.com/accounts/v1/...)Accountsসাব-এপিআই-এর অংশ। - রিসোর্সের নাম: মার্চেন্ট এপিআই রিসোর্স নাম ব্যবহার করে (
accounts/{account}/regions/{region}) এর পরিবর্তে আলাদাmerchant_idএবংregion_idপ্যারামিটারের URL পাথে গেট, আপডেট এবং ডিলিট অপারেশনের জন্য। - AIP সম্মতি: মার্চেন্ট API পদ্ধতিগুলি আদর্শ API উন্নতি প্রস্তাবের প্যাটার্নগুলি অনুসরণ করে (যেমন তালিকা/তৈরি করার জন্য
parentব্যবহার করা, Get/Delete-এর জন্যnameএবং মানকupdate_maskব্যবহার)। - মোড়কের ধরন: যে ক্ষেত্রগুলি পূর্বে Content API-এ
google.protobuf.StringValueবাgoogle.protobuf.BoolValueব্যবহার করে সেগুলি এখন মার্চেন্ট API-এ স্ট্যান্ডার্ডoptionalক্ষেত্রগুলি ব্যবহার করে৷ - নতুন বৈশিষ্ট্য:
- বণিক API একটি বিন্দুর চারপাশের ব্যাসার্ধের উপর ভিত্তি করে অঞ্চলগুলিকে সংজ্ঞায়িত করতে
Regionসংস্থানের মধ্যে একটিRadiusAreaঅঞ্চল প্রবর্তন করে (প্রাথমিকভাবেTRUST_TESTERদৃশ্যমানতার সাথে)। - ব্যাচ পদ্ধতি -
BatchCreateRegions,BatchUpdateRegions,BatchDeleteRegions- উপলব্ধ।
- বণিক API একটি বিন্দুর চারপাশের ব্যাসার্ধের উপর ভিত্তি করে অঞ্চলগুলিকে সংজ্ঞায়িত করতে
- ত্রুটি পরিচালনা: ত্রুটি কোড এবং বার্তা আরও নির্দিষ্ট প্রতিক্রিয়া প্রদান করে।
অনুরোধ
অনুরোধের ধরণগুলি কীভাবে পরিবর্তন হয় তা এখানে:
| আইটেম | কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|---|
| শেষবিন্দু | 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 | বণিক API অ্যাকাউন্ট নির্দিষ্ট করতে parent ব্যবহার করে। |
| পথ তৈরি করুন | /content/v2.1/{merchant_id}/regions | /accounts/v1/{parent=accounts/*}/regions | মার্চেন্ট API 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 ব্যবহার করে। |
শনাক্তকারী
নিম্নলিখিত হিসাবে আপনার শনাক্তকারীর ব্যবহার পরিবর্তন করুন:
| আইটেম | কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|---|
| হিসাব | merchant_id (পূর্ণসংখ্যা) | account (পূর্ণসংখ্যা, name অংশ বা parent স্ট্রিং) | রিসোর্স নামের স্ট্রিং এ এমবেড করা অ্যাকাউন্ট আইডি খুঁজুন, উদাহরণস্বরূপ, accounts/{account} । |
| অঞ্চল | region_id (স্ট্রিং) | {region} (স্ট্রিং, name স্ট্রিংয়ের অংশ) | রিসোর্স নামের স্ট্রিং এ এমবেড করা অঞ্চল আইডি খুঁজুন, উদাহরণস্বরূপ, accounts/{account}/regions/{region} । |
| সম্পদের নাম | অনুরোধের জন্য কঠোরভাবে ব্যবহার করা হয় না। | name : accounts/{account}/regions/{region} | পাওয়ার/আপডেট/ডিলিট রিকোয়েস্টের জন্য স্ট্যান্ডার্ড আইডেন্টিফায়ার। |
| পিতামাতার নাম | অনুরোধের জন্য কঠোরভাবে ব্যবহার করা হয় না। | parent : accounts/{account} | তালিকা/তৈরি অনুরোধের জন্য স্ট্যান্ডার্ড শনাক্তকারী। |
সম্পদ
Region সম্পদ কাঠামোতে ছোটখাটো পরিবর্তন রয়েছে:
| আইটেম | কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|---|
| সম্পদ শনাক্তকারী | region_id (স্ট্রিং), merchant_id (int64) | name (স্ট্রিং): accounts/{account}/regions/{region} | বণিক API সম্পদ শনাক্তকারী হিসাবে একটি একক 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 (শুধুমাত্র আউটপুট) | মোড়কের ধরন সরানো হয়েছে। |
পদ্ধতি
নিম্নলিখিত পদ্ধতির আপনার ব্যবহার পরিবর্তন করুন:
| আইটেম | কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|---|
| অঞ্চল পান | 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 আচরণ সামঞ্জস্যপূর্ণ। |
| ব্যাচ তৈরি করুন | N/A | BatchCreateRegions | এটি একটি নতুন পদ্ধতি। |
| ব্যাচ আপডেট | N/A | BatchUpdateRegions | এটি একটি নতুন পদ্ধতি। |
| ব্যাচ মুছে ফেলুন | N/A | BatchDeleteRegions | এটি একটি নতুন পদ্ধতি। |
পুনঃনামকরণ করা ক্ষেত্র
| আইটেম | কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|---|
| অ্যাকাউন্ট আইডি | merchant_id | account ( name অংশ বা parent ) | সম্পদ name স্ট্রিং একত্রিত. এটি Region (প্রতিক্রিয়া) এবং API অনুরোধ করতে ব্যবহৃত প্রোটোবাফ বার্তাগুলিকে প্রভাবিত করে, যেমন CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest এবং ListRegionsRequest । |
| অঞ্চল আইডি | region_id | region ( name অংশ), region_id | CreateRegionRequest এ বেশিরভাগের জন্য name সাথে একত্রিত, পৃথক region_id ক্ষেত্র। এটি Region (প্রতিক্রিয়া) এবং API অনুরোধ করতে ব্যবহৃত প্রোটোবাফ বার্তাগুলিকে প্রভাবিত করে, যেমন CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest এবং ListRegionsRequest । |
| অঞ্চলের নাম (আউটপুট) | 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 কে প্রভাবিত করে। |