مكالمات موارد المنتجات

products يوفر قدرًا كبيرًا من المرونة والتحكم في المزيد أكثر من 60 سمة للمنتج.وهناك عدد من الحقول الإلزامية، ويجب تضمينه حتى تتم الموافقة على عرضه على Google Shopping. هناك عدد من الحقول الاختيارية التي يمكن أن تصبح إلزامية استنادًا إلى تنوّعها شروط مثل الموقع الجغرافي ونوع المنتج وخيارات المنتج والمنتج حِزم. لمعرفة المزيد من التفاصيل حول أكثر من 60 معلمة اختيارية يمكن تم إعداده للمنتجات، راجِع بيانات المنتج. المواصفات:

يتيح لك مورد "products" إمكانية إضافة "insert" و"get" و"update" و"delete" منتج واحد في الوقت نفسه، وlist كل المنتجات في قاعدة بيانات Merchant Center.

تشير رسالة الأشكال البيانية productstatuses يمكن استخدام المصدر للتحقق من حالة الموافقة أو الرفض على مستوى معين لمنتج وجهة ما. راجِع حالة المنتج. للحصول على مزيد من التفاصيل حول قد تتضمن المنتجات مشاكل في جودة البيانات وما قد تكون عليه.

في أمثلة واجهة برمجة التطبيقات، نستخدم ثلاثة منتجات: اثنين من قمصان Google الحد الأقصى لعدد المشتركين في Google نستخدم الحد الأدنى من مجموعة بيانات المنتجات الموضحة في الجدول أدناه من أجل: إجراء products طلب للحصول على موارد لإدراجها والحصول عليها وتعديلها وإدراجها في قوائم وحذفها المنتجات الفردية ودُفعات المنتجات.

ننصحك بضبط معلومات الشحن والضرائب على الحساب المستوى بدلاً من على مستوى المنتج.

بالنسبة إلى الحسابات الفرعية المتعددة البائعين في الأسواق، يجب أن تكون كل المنتجات تضمين الحقل external_seller_id. عرض معرّفات المنتجات لمزيد من التفاصيل.

id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
title	قميص Google الرياضي الأسود	أخضر تي شيرت من Google	قبعة Google Twill
الوصف	قميص Google الرياضي الأسود	قميص Google من القطن 100%	قبعة Google الكلاسيكية
معرّف مجموعة السلع	google_tee	google_tee
رابط	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
الشرط	جديد	New	جديد
السعر	SAR 21.99	SAR 21.99	10.99 SAR
مدى التوفّر	متوفر	متوفر	متوفر
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
رقم GTIN	9504000059422	9504000059446	9504000059452
رقم القطعة بحسب الشركة المصنّعة	00638NIC	00638ANG	00638ABC
العلامة التجارية	Google	Google	Google
فئة المنتجات من Google	الملابس الملحقات > الملابس	الملابس الملحقات > الملابس	الملابس الملحقات > إكسسوارات ملابس > قبّعات
اللون	أسود	أخضر	أسود
الحجم	L	M	M
age_group	للبالغين	للبالغين	للبالغين
الجنس	ذكر	ذكر	للجنسَين
included_destination	Shopping Actions و"إعلانات Shopping"	Shopping Actions و"إعلانات Shopping"	Shopping Actions

products.insert

لإدراج منتج واحد، استخدِم عنوان URL التالي للطلب مع تحديد معرّف التاجر ونموذج JSON للنص الأساسي يؤدي الإدخال إلى إنشاء المنتج الجديد. إذا كانت القيم هذه السمة متوفرة للسمات channel وcontentLanguage وofferId و feedLabel لمنتج معيّن، تؤدي هذه الطريقة إلى تعديل الإدخال واستبداله. جميع البيانات من طلبات البيانات من واجهة برمجة التطبيقات السابقة للمنتج المعني.

المنتجات التي يتم استبعادها من جميع الوجهات لأكثر من 7 أيام تلقائيًا.

يُدرج المثال المعروض "قميص Google أسود" جديد. للمنتجات المتاحة.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

نموذج لطلب نص طلب في "products.insert":

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

يمكن أيضًا أن يتضمّن المنتج سمات مخصّصة تمّ ضبطها داخل نص JSON. على سبيل المثال: يمكننا ضبط purchase_quantity_limit لمنتج واحد من أجل الحد عدد العناصر التي يمكن للعميل طلبها:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

يُرجى العلم أنّ السمة المخصّصة purchase_quantity_limit تضبط حدًا أقصى على عمليات الشراء. لكل طلب إلى تعريف المنتج كما تتوافق مع الخلاصات أيضًا. تشير رسالة الأشكال البيانية حاليًا في إصدار تجريبي إلى أن تتوافق بشكل كامل مع واجهة برمجة التطبيقات. أي تقييم يمكن للتاجر إضافة سمة مخصصة إضافية ولكن لن يؤدي ذلك إلى أي معالجة محددة بواسطة واجهات برمجة التطبيقات.

تؤدي المكالمة الناجحة إلى عرض رمز HTTP 200 ونص استجابة يحتوي على مورد المنتج المدرج مع id وofferId وcontentLanguage فقط تمت تعبئة feedLabel وchannel:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

للحصول على معلومات حول منتج معيّن في قاعدة بيانات Merchant Center، استخدم products.get يمكن أن تستغرق عملية إدراج منتج حديث بضع دقائق. المتاحة من خلال هذه المكالمة.

استخدِم المَعلمات وعنوان URL التالي لطلب HTTP ومعرّف التاجر معرّف المنتج (تنسيق معرّف RST) للمنتج الذي تريد الحصول عليه:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

تؤدي المكالمة الناجحة إلى عرض HTTP 200 و"مورد المنتج" في نص الاستجابة. في ما يلي نموذج لبيانات المنتج المأخوذة من منتج يحمل المعرّف. online:en:US:1111111111:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

لتعديل منتج واحد، استخدِم عنوان URL للطلب التالي مع طريقة التصحيح، لتحديد معرّف التاجر ومعرّف المنتج ونص JSON يحتوي على البيانات التي تريد تحديثه للمنتج. على عكس products.insert، يتطلب ذلك تقديم جميع الحقول القابلة للتطبيق، إلا أن products.update تتطلب منك فقط ما يلي: تحديد الحقول التي تريد تغييرها.

لإضافة سمة أو تعديلها، حدِّد الحقل بالقيمة الجديدة في ملف JSON جسم. سيعدّل المثال المعروض title وdescription من قائمة حالية. "أسود Google Tee" مع بيانات المنتج المقدّمة في نص الطلب، مع الاحتفاظ جميع الحقول الأخرى دون المساس.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

نموذج لطلب نص طلب في "products.update":

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

يمكن تعديل الحقول ذات المستوى الأعلى فقط من خلال طلب products.update. إذا كنت تريد تعديل الحقول المتداخلة، عليك تقديم عنصر المستوى الأعلى بأكمله.

سيعدّل المثال المعروض كائن salePrice ذي المستوى الأعلى، بما في ذلك العنصر المُدمج. الخاصة بمنتج موجود، مع بيانات المنتج المقدمة في نص الطلب، مع ترك جميع الحقول الأخرى دون تغيير.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

لاختيار حقول معيّنة لتعديلها بدون إجراء تغييرات على الحقول الأخرى المدرَجة في نص الطلب، يمكنك تحديد updateMask. سلسلة طلب البحث هذه عبارة عن قائمة مفصولة بفواصل بالحقول المراد تعديلها. يكون updateMask مفيدًا عندما تريد التأكيد على أنّ الحقول المُسمّاة فقط سيتم تحديث. إن عدم تحديد updateMask يساوي وضع علامة على جميع الحقول في طلب التحديث كما هو موضح في المثال أعلاه.

سيؤدي المثال المعروض إلى تعديل description وavailability فقط. من "قميص Google الأسود" الحالي مع بيانات المنتجات المعنيّة المقدَّمة في نص الطلب، مع ترك جميع الحقول الأخرى، بما في ذلك title، بدون تغيير.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

نموذج لطلب نص طلب في "products.update":

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

في حال توفير حقل في قائمة "updateMask" ولكن ليس في نص الطلب: سيتم حذف هذا الحقل من مورد Product، إذا كان متوفرًا.

سيستخدم المثال المعروض updateMask لإزالة قيمة الحقل. salePrice

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

يجب ألا يتضمن نص طلب النموذج الحقل salePrice من أجل حذفها. ولا يمكنك أيضًا إدخال نص أو نص فارغ. ستكون الحقول الأخرى تظل كما هي طالما أنها لا تظهر في updateMask.

لاستخدام updateMask ضمن طلب products.custombatch، يجب ضبط updateMask. في نص الطلب.

سيعدّل المثال المعروض price وavailability من قائمة حالية. "أسود Google Tee" باستخدام products.custombatch مع بيانات المنتج المقدَّمة في الإدخال المجمّع، مع ترك جميع الحقول الأخرى بما فيها title وdescription بدون لمسها.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

لحذف منتج واحد، استخدِم products.delete مع نموذج طلب HTTP. عنوان URL ومعرّف التاجر ومعرّف المنتج (بتنسيق REST ID مثل online:en:US:1111111111) للمنتج الذي تريد حذفه:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

تؤدي الاستجابة الناجحة إلى عرض علامة HTTP Status 204 بدون نص للاستجابة.

products.list

تتضمّن السمة products.list كل المنتجات التي يملكها التاجر في Merchant Center. قاعدة البيانات. استخدِم عنوان URL الخاص بالطلب التالي:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

تؤدي المكالمة الناجحة إلى عرض بيانات HTTP 200 وJSON للمنتجات في "الموارد" المفتاح.

يتمّ إرجاع المنتجات الثلاثة التالية:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}