ย้ายข้อมูลการจัดการภูมิภาค

คู่มือนี้อธิบายวิธีย้ายข้อมูลการผสานรวมจาก RegionsService ใน Content API for Shopping ไปยัง RegionsService ภายใน API ย่อยของบัญชี

บริการภูมิภาคช่วยให้คุณกำหนดพื้นที่ทางภูมิศาสตร์ที่กำหนดเองสำหรับกรณีการใช้งานต่างๆ เช่น การกำหนดราคาในระดับภูมิภาคและการลบล้างการจัดส่ง คุณสามารถใช้ภูมิภาคกับบริการต่างๆ เช่น RegionalInventory และ ShippingSettings

ความแตกต่างที่สำคัญ

• โครงสร้าง API: ตอนนี้บริการ Regions เป็นส่วนหนึ่งของ API ย่อย Accounts ใน Merchant API (เช่น merchantapi.googleapis.com/accounts/v1/...)
• ชื่อทรัพยากร: Merchant API ใช้ชื่อทรัพยากร (accounts/{account}/regions/{region}) แทนพารามิเตอร์ merchant_id และ region_id แยกกันในเส้นทาง URL สำหรับการดำเนินการ Get, Update และ Delete
• การปฏิบัติตามข้อกำหนดของ AIP: เมธอด Merchant API เป็นไปตามรูปแบบ API Improvement Proposal มาตรฐาน (เช่น การใช้ parent สำหรับ List/Create, name สำหรับ Get/Delete และการใช้ update_mask มาตรฐาน)
• ประเภท Wrapper: ฟิลด์ที่ก่อนหน้านี้ใช้ google.protobuf.StringValue หรือ google.protobuf.BoolValue ใน Content API ตอนนี้จะใช้ฟิลด์ optional มาตรฐานใน Merchant API
• ฟีเจอร์ใหม่
  • Merchant API จะเปิดตัวประเภท RadiusArea ภายในทรัพยากร Region เพื่อกำหนดภูมิภาคตามรัศมีรอบจุด (เริ่มแรกจะแสดงผลเป็น TRUST_TESTER)
  • เมธอดแบบกลุ่ม - BatchCreateRegions, BatchUpdateRegions, BatchDeleteRegions - พร้อมใช้งานแล้ว
• การจัดการข้อผิดพลาด: รหัสข้อผิดพลาดและข้อความจะให้ความคิดเห็นที่เจาะจงมากขึ้น

คำขอ

รูปแบบคำขอจะเปลี่ยนแปลงดังนี้

รายการ	Content API for Shopping	Merchant API	คำอธิบาย
Endpoint	https://shoppingcontent.googleapis.com	https://merchantapi.googleapis.com	โดเมนฐานมีการเปลี่ยนแปลง
รับเส้นทาง	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	Merchant API ใช้ API ย่อย accounts และทรัพยากร name
เส้นทางรายการ	/content/v2.1/{merchant_id}/regions	/accounts/v1/{parent=accounts/*}/regions	Merchant API ใช้ parent เพื่อระบุบัญชี
สร้างเส้นทาง	/content/v2.1/{merchant_id}/regions	/accounts/v1/{parent=accounts/*}/regions	Merchant API ใช้ parent region_id เป็นช่องในเนื้อความของคำขอ
เส้นทางการอัปเดต	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	ชื่อทรัพยากรใน Merchant API เป็นส่วนหนึ่งของออบเจ็กต์ region ในเนื้อหา
ลบเส้นทาง	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	ใช้ทรัพยากร name

รหัสระบุ

เปลี่ยนการใช้ตัวระบุดังนี้

รายการ	Content API for Shopping	Merchant 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}	ตัวระบุมาตรฐานสำหรับคำขอ List/Create

แหล่งข้อมูล

โครงสร้างทรัพยากร Region มีการเปลี่ยนแปลงเล็กน้อยดังนี้

รายการ	Content API for Shopping	Merchant API	คำอธิบาย
ตัวระบุทรัพยากร	region_id (สตริง), merchant_id (int64)	name (สตริง): accounts/{account}/regions/{region}	Merchant API ใช้ฟิลด์ name เดียวเป็นตัวระบุทรัพยากร
display_name	google.protobuf.StringValue	optional string	นำประเภท Wrapper ออกแล้ว
radius_area	ไม่มี (N/A)	RadiusArea	ประเภทใหม่นี้จะกำหนดภูมิภาคตามรัศมี รวมถึง region_code, lat_lng, radius, radius_units โดยค่าเริ่มต้น ระบบจะจำกัดระดับการเข้าถึง
regional_inventory_eligible	google.protobuf.BoolValue (เอาต์พุตเท่านั้น)	optional bool (เอาต์พุตเท่านั้น)	นำประเภท Wrapper ออกแล้ว
shipping_eligible	google.protobuf.BoolValue (เอาต์พุตเท่านั้น)	optional bool (เอาต์พุตเท่านั้น)	นำประเภท Wrapper ออกแล้ว

เมธอด

เปลี่ยนการใช้เมธอดดังนี้

รายการ	Content API for Shopping	Merchant API	คำอธิบาย
รับภูมิภาค	GetRegion	GetRegion	คำขอใช้ name
สร้างภูมิภาค	CreateRegion	CreateRegion	คำขอจะใช้ parent จาก URL ขณะที่เนื้อความของคำขอมีออบเจ็กต์ region และ region_id
อัปเดตภูมิภาค	UpdateRegion	UpdateRegion	คำขอใช้ region (ซึ่งต้องมี region.name) และ update_mask
ลบภูมิภาค	DeleteRegion	DeleteRegion	คำขอใช้ name
แสดงรายการภูมิภาค	ListRegions	ListRegions	คำขอใช้ parent ลักษณะการทำงานของ page_size และ page_token จะสอดคล้องกัน
สร้างแบบกลุ่ม	ไม่มี	BatchCreateRegions	นี่เป็นวิธีการใหม่
การอัปเดตเป็นกลุ่ม	ไม่มี	BatchUpdateRegions	นี่เป็นวิธีการใหม่
ลบเป็นกลุ่ม	ไม่มี	BatchDeleteRegions	นี่เป็นวิธีใหม่

ฟิลด์ที่เปลี่ยนชื่อ

รายการ	Content API for Shopping	Merchant API	คำอธิบาย
รหัสบัญชี	merchant_id	account (ส่วนหนึ่งของ name หรือ parent)	ผสานรวมเข้ากับสตริงทรัพยากร name รายการ ซึ่งจะส่งผลต่อ Region (การตอบกลับ) และข้อความ protobuf ที่ใช้ในการส่งคำขอ API เช่น CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest และ ListRegionsRequest
รหัสภูมิภาค	region_id	region (ส่วนหนึ่งของ name), region_id	ผสานรวมอยู่ใน name สำหรับส่วนใหญ่ ช่อง region_id แยกต่างหากใน CreateRegionRequest ซึ่งจะส่งผลต่อ 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

ดูข้อมูลเพิ่มเติม

• Rest Resource: accounts.regions สำหรับ Merchant API
• คู่มือเกี่ยวกับภูมิภาค
• ตั้งค่าภูมิภาค