স্থানান্তর অঞ্চল ব্যবস্থাপনা

এই গাইডটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশন 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 বর্ণনা
শেষবিন্দু 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 কে প্রভাবিত করে।

আরও জানুন

পূর্ববর্তী
Migrate homepage management
পরবর্তী
Migrate inventory management