نقل البيانات والتوافق

إدارة نقل البيانات بين المناطق

يوضّح هذا الدليل كيفية نقل عملية الدمج من RegionsService في Content API for Shopping إلى RegionsService ضمن واجهة Accounts الفرعية لواجهة برمجة التطبيقات.

تتيح لك خدمة "المناطق" تحديد مناطق جغرافية مخصّصة لحالات استخدام مثل إلغاء الأسعار والشحن على مستوى منطقة معيّنة. يمكنك استخدام المناطق مع خدمات مثل RegionalInventory وShippingSettings.

الاختلافات الرئيسية

• بنية واجهة برمجة التطبيقات: أصبحت خدمة "المناطق" الآن جزءًا من واجهة برمجة التطبيقات الفرعية 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 أنماط اقتراح تحسين واجهة برمجة التطبيقات العادية (مثل استخدام parent في List/Create، وname في Get/Delete، والاستخدام العادي update_mask).
• أنواع الحاويات: الحقول التي كانت تستخدم 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	الوصف
نقطة النهاية	https://shoppingcontent.googleapis.com	https://merchantapi.googleapis.com	تغيير النطاق الأساسي
الحصول على المسار	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	تستخدم Merchant 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}	المعرّف العادي لطلبات القائمة/الإنشاء

الموارد

طرأت تغييرات بسيطة على بنية مورد Region:

السلعة	Content API for Shopping	Merchant API	الوصف
معرّف المرجع	region_id (string), merchant_id (int64)	name (سلسلة): accounts/{account}/regions/{region}	تستخدم Merchant API حقل 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 (الإخراج فقط)	تمت إزالة نوع الحزمة.

الطُرق

غيِّر استخدامك للطرق على النحو التالي:

السلعة	Content API for Shopping	Merchant API	الوصف
Get Region	GetRegion	GetRegion	يستخدم الطلب name.
إنشاء منطقة	CreateRegion	CreateRegion	يأخذ الطلب parent من عنوان URL، بينما يتضمّن نص الطلب العنصر region وregion_id.
تعديل المنطقة	UpdateRegion	UpdateRegion	يستخدم الطلب region (الذي يجب أن يتضمّن region.name) وupdate_mask.
حذف المنطقة	DeleteRegion	DeleteRegion	يستخدم الطلب name.
List Regions	ListRegions	ListRegions	يستخدم الطلب parent. يتشابه سلوك page_size وpage_token.
إنشاء مجموعة	لا ينطبق	BatchCreateRegions	هذه طريقة جديدة.
التعديل المجمّع	لا ينطبق	BatchUpdateRegions	هذه طريقة جديدة.
الحذف المجمّع	لا ينطبق	BatchDeleteRegions	هذه طريقة جديدة.

الحقول التي تمّت إعادة تسميتها

السلعة	Content API for Shopping	Merchant API	الوصف
رقم تعريف الحساب	merchant_id	‫account (جزء من name أو parent)	مدمَجة في سلاسل الموارد name يؤثّر ذلك في Region (الرد) ورسائل البروتوكول المخزَّنة مؤقتًا المستخدَمة لتقديم طلبات إلى واجهة برمجة التطبيقات، مثل CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest وListRegionsRequest.
معرّف المنطقة	region_id	‫region (جزء من name)، region_id	مدمَج في name لمعظم الحسابات، وحقل region_id منفصل في CreateRegionRequest يؤثّر ذلك في Region (الرد) ورسائل البروتوكول المخزَّنة مؤقتًا المستخدَمة لتقديم طلبات إلى واجهة برمجة التطبيقات، مثل 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
• دليل المناطق
• إعداد المناطق