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

يمكنك استخدام Merchant API لتحميل منتجاتك وإدارتها برمجيًا. يتيح لك المرجع accounts.products إنشاء كتالوج متجر على الإنترنت، وهو قائمة بالمنتجات والعروض الترويجية. لمزيد من المعلومات عن تحميل منتجاتك وإدارتها باستخدام Merchant API، اطّلِع على نظرة عامة على Merchant Products API.

تغييرات الموارد

تم استبدال مرجعَي products و productstatuses في Content API بمرجعَي productInputs وproducts.

يمكنك استخدام مرجع productInputs لـ Merchant API لتحميل معلومات منتجاتك. يمكن استخدام المرجع product في Merchant API لاسترداد منتجاتك التي تمت معالجتها بما في ذلك الحالات.

متطلبات مصدر البيانات

في Merchant API، يجب تحديد مصدر البيانات المستهدَف عند تحميل المنتجات. يمكن أن يكون مصدر بيانات أساسيًا أو مصدر بيانات تكميليًا. يمكنك استرداد مصادر البيانات الحالية باستخدام dataSources.list أو إنشاء مصدر بيانات جديد باستخدام dataSources.create.

بدلاً من ذلك، يمكنك استخدام واجهة مستخدم Merchant Center لإدارة مصادر بياناتك.

لمزيد من المعلومات عن مصادر البيانات وكيفية إنشائها وإدارتها، اطّلِع على نظرة عامة على Merchant Data sources API.

تغييرات المعرّفات

تستخدِم Merchant API سمة name لتحديد المنتج. يجب أن يكون اسم المنتج بالتنسيق accounts/{account}/products/{product}، حيث يكون {product} بالتنسيق channel~language~feedLabel~offerId.

كانت موارد Content API تستخدِم : بدلاً من ~ بين كل قيمة في رقم التعريف: channel:language:feedLabel:offerId.

تعرض جميع طلبات البيانات من Merchant API التنسيق الجديد مع ~ بين قيم ID. ننصحك بتخزين الحقل الجديد name من الاستجابة واستخدامه في طلباتك المستقبلية.

الطُرق

في ما يلي مقارنة بين طرق المنتجات في Content API for Shopping و Merchant Products API:

واجهة برمجة تطبيقات المحتوى في Shopping	Merchant Products API
products.custombatch	غير متوفر
products.insert	productInputs.insert
products.update	غير متاح بعد
products.delete	productInputs.delete
products.get	products.get
products.list	products.list
productstatuses.custombatch	غير متوفر
productstatuses.get	products.get
productstatuses.list	products.list

الطلبات

طريقة Content API	عنوان URL في Content API for Shopping	عنوان URL في Merchant Products API	المعرّف في Content API	المعرّف في Merchant Products API
products.insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
products.update	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	غير متوفر
products.delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	"MERCHANT_ID" و"PRODUCT_ID"	NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	"MERCHANT_ID" و"PRODUCT_ID"	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
productstatuses.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	"MERCHANT_ID" و"PRODUCT_ID"	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
productstatuses.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}