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

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে আপনার ইন্টিগ্রেশনকে RegionsService in Content API for Shopping থেকে Accounts সাব-API-এর মধ্যে RegionsService এ স্থানান্তর করবেন।

অঞ্চল পরিষেবা আপনাকে আঞ্চলিক মূল্য নির্ধারণ এবং শিপিং ওভাররাইডের মতো ব্যবহারের ক্ষেত্রে কাস্টম ভৌগোলিক অঞ্চলগুলি সংজ্ঞায়িত করতে দেয়। আপনি অঞ্চলগুলি RegionalInventory এবং ShippingSettings মতো পরিষেবা সহ ব্যবহার করতে পারেন।

মূল পার্থক্য

  • API কাঠামো: অঞ্চল পরিষেবা এখন মার্চেন্ট API-তে Accounts সাব-API-এর অংশ (উদাহরণস্বরূপ, merchantapi.googleapis.com/accounts/v1/... )।
  • রিসোর্সের নাম: Merchant API Get, Update এবং Delete অপারেশনের জন্য URL পাথে পৃথক merchant_id এবং region_id প্যারামিটারের পরিবর্তে রিসোর্সের নাম ( accounts/{account}/regions/{region} ) ব্যবহার করে।
  • AIP সম্মতি: মার্চেন্ট API পদ্ধতিগুলি স্ট্যান্ডার্ড API উন্নতি প্রস্তাবের ধরণ অনুসরণ করে (যেমন তালিকা/তৈরির জন্য parent ব্যবহার, Get/Delete এর জন্য name এবং স্ট্যান্ডার্ড update_mask ব্যবহার)।
  • র‍্যাপারের ধরণ: যেসব ক্ষেত্র পূর্বে কন্টেন্ট API-তে google.protobuf.StringValue বা google.protobuf.BoolValue ব্যবহার করত, এখন Merchant API-তে স্ট্যান্ডার্ড optional ক্ষেত্র ব্যবহার করে।
  • নতুন বৈশিষ্ট্য:
    • মার্চেন্ট API একটি বিন্দুর চারপাশের ব্যাসার্ধের উপর ভিত্তি করে অঞ্চলগুলিকে সংজ্ঞায়িত করার জন্য Region সম্পদের মধ্যে একটি RadiusArea টাইপ প্রবর্তন করে (প্রাথমিকভাবে TRUST_TESTER দৃশ্যমানতার সাথে)।
    • ব্যাচ পদ্ধতি - BatchCreateRegions , BatchUpdateRegions , BatchDeleteRegions - উপলব্ধ।
  • ত্রুটি পরিচালনা: ত্রুটি কোড এবং বার্তাগুলি আরও নির্দিষ্ট প্রতিক্রিয়া প্রদান করে।

অনুরোধ

অনুরোধের ধরণগুলি কীভাবে পরিবর্তিত হয় তা এখানে:

আইটেম কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই বিবরণ
শেষবিন্দু https://shoppingcontent.googleapis.com https://merchantapi.googleapis.com বেস ডোমেইন পরিবর্তন হয়।
পথ পান /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} মার্চেন্ট API accounts সাব-API এবং একটি রিসোর্স name ব্যবহার করে।
তালিকার পথ /content/v2.1/{merchant_id}/regions /accounts/v1/{parent=accounts/*}/regions মার্চেন্ট এপিআই অ্যাকাউন্ট নির্দিষ্ট করার জন্য 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 মার্চেন্ট এপিআই বিবরণ
হিসাব 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 সম্পদ কাঠামোতে সামান্য পরিবর্তন রয়েছে:

আইটেম কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই বিবরণ
রিসোর্স আইডেন্টিফায়ার region_id (স্ট্রিং), merchant_id (int64) name (স্ট্রিং): accounts/{account}/regions/{region} মার্চেন্ট এপিআই রিসোর্স আইডেন্টিফায়ার হিসেবে একটি একক name ক্ষেত্র ব্যবহার করে।
display_name google.protobuf.StringValue optional string র‍্যাপারের ধরণ সরানো হয়েছে।
radius_area উপলব্ধ নয় (প্রযোজ্য নয়) RadiusArea এই নতুন ধরণটি ব্যাসার্ধ অনুসারে অঞ্চলগুলিকে সংজ্ঞায়িত করে। এতে অন্তর্ভুক্ত রয়েছে region_code , lat_lng , radius , radius_units । ডিফল্টরূপে, দৃশ্যমানতা সীমাবদ্ধ।
regional_inventory_eligible google.protobuf.BoolValue (শুধুমাত্র আউটপুট) optional bool (শুধুমাত্র আউটপুট) র‍্যাপারের ধরণ সরানো হয়েছে।
shipping_eligible google.protobuf.BoolValue (শুধুমাত্র আউটপুট) optional bool (শুধুমাত্র আউটপুট) র‍্যাপারের ধরণ সরানো হয়েছে।

পদ্ধতি

আপনার পদ্ধতির ব্যবহার নিম্নরূপ পরিবর্তন করুন:

আইটেম কেনাকাটার জন্য কন্টেন্ট 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 আচরণ সামঞ্জস্যপূর্ণ।
ব্যাচ তৈরি করুন নিষিদ্ধ BatchCreateRegions এটি একটি নতুন পদ্ধতি।
ব্যাচ আপডেট নিষিদ্ধ BatchUpdateRegions এটি একটি নতুন পদ্ধতি।
ব্যাচ মুছে ফেলা নিষিদ্ধ BatchDeleteRegions এটি একটি নতুন পদ্ধতি।

পুনঃনামকরণ করা ক্ষেত্রগুলি

আইটেম কেনাকাটার জন্য কন্টেন্ট API মার্চেন্ট এপিআই বিবরণ
অ্যাকাউন্ট আইডি merchant_id account ( name বা parent অংশ) রিসোর্স name স্ট্রিং-এ ইন্টিগ্রেটেড। এটি Region (প্রতিক্রিয়া) এবং protobuf বার্তাগুলিকে প্রভাবিত করে যা API অনুরোধ করতে ব্যবহৃত হয়, যেমন CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest এবং ListRegionsRequest ।
অঞ্চল আইডি region_id region ( name অংশ), region_id বেশিরভাগের name সাথে একীভূত, CreateRegionRequest এ পৃথক region_id ক্ষেত্র। এটি Region (প্রতিক্রিয়া) এবং protobuf বার্তাগুলিকে প্রভাবিত করে যা 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