این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تماس با منابع محصولات

منبع products به انعطاف‌پذیری و کنترل زیادی روی بیش از 60 ویژگی محصول اجازه می‌دهد. تعدادی فیلد وجود دارد که اجباری هستند و باید برای تأیید برای نمایش در Google Shopping گنجانده شوند. تعدادی فیلد اختیاری وجود دارد که بر اساس شرایط مختلف مانند مکان، نوع محصول، انواع محصول و بسته‌های محصول می‌توانند اجباری شوند. برای جزئیات بیشتر در مورد بیش از 60 پارامتر اختیاری قابل پیکربندی برای محصولات، به مشخصات داده محصول مراجعه کنید.

منبع products به شما امکان می دهد هر بار یک محصول insert ، get ، update و delete و همه محصولات را در پایگاه داده مرکز تجاری list .

از منبع productstatuses می توان برای بررسی وضعیت تایید یا عدم تایید یک محصول خاص برای یک مقصد استفاده کرد. برای جزئیات بیشتر در مورد اینکه کدام محصولات ممکن است مشکلات کیفیت داده داشته باشند و این مشکلات ممکن است به راهنمای وضعیت محصول مراجعه کنید.

در نمونه های API خود، از سه محصول استفاده می کنیم: دو تی شرت گوگل و یک کلاه گوگل. ما از مجموعه حداقلی از داده‌های محصول که در جدول زیر نشان داده شده است استفاده می‌کنیم تا با منابع products تماس بگیرید تا محصولات و دسته‌ای از محصولات را درج، دریافت، به‌روزرسانی، فهرست‌بندی و حذف کنیم.

توصیه می کنیم اطلاعات حمل و نقل و مالیات در سطح حساب پیکربندی شود تا در سطح محصول.

برای حساب‌های فرعی چند فروشنده Marketplaces ، همه محصولات باید دارای فیلد external_seller_id باشند. برای جزئیات بیشتر به شناسه محصولات مراجعه کنید.


شناسه	online:fa:US:1111111111	online:fa:US:2222222222	online:fa:US:3333333333
شناسه پیشنهادی	1111111111	2222222222	3333333333
عنوان	تی سیاه گوگل	گوگل تی گرین	Google Twill Cap
توضیحات	تی سیاه گوگل	تیشرت 100% پنبه گوگل	کلاه کلاسیک گوگل
شناسه گروه آیتم	google_tee	google_tee
پیوند	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
وضعیت	جدید	جدید	جدید
قیمت	21.99 دلار	21.99 دلار	10.99 دلار
در دسترس بودن	موجود است	موجود است	موجود است
پیوند تصویر	https://shop.example.com/ store/20160512512/دارایی/اقلام/تصاویر/ GGOEGXXX1100.jpg	https://shop.example.com/ store/20160512512/دارایی/اقلام/تصاویر/ GGOEGXXX0906.jpg	https://shop.example.com/ store/20160512512/دارایی/اقلام/تصاویر/ GGOEGHPB071610.jpg
gtin	9504000059422	9504000059446	9504000059452
mpn	00638NIC	00638ANG	00638ABC
نام تجاری	گوگل	گوگل	گوگل
دسته بندی محصولات گوگل	پوشاک و لوازم جانبی > پوشاک	پوشاک و لوازم جانبی > پوشاک	پوشاک و لوازم جانبی > لوازم جانبی پوشاک > کلاه
رنگ	سیاه	سبز	سیاه
اندازه	L	م	م
گروه_سنی	بالغ	بالغ	بالغ
جنسیت	مرد	مرد	تک جنسیت
شامل_مقصد	اقدامات خرید، تبلیغات خرید	اقدامات خرید، تبلیغات خرید	اقدامات خرید

محصولات.درج

برای درج یک محصول واحد، از نشانی اینترنتی درخواست زیر استفاده کنید و شناسه فروشنده خود و نمونه بدنه JSON را مشخص کنید. یک درج محصول جدید را ایجاد می کند. اگر مقادیری برای ویژگی‌های channel ، contentLanguage ، offerId و feedLabel برای یک محصول مشخص وجود داشته باشد، این روش آن ورودی را به‌روزرسانی می‌کند و همه داده‌های فراخوانی‌های API قبلی را برای محصول داده شده جایگزین می‌کند.

محصولاتی که بیش از 7 روز از همه مقاصد حذف شده اند به طور خودکار حذف می شوند.

مثال نشان داده شده یک "سیاه گوگل سه راهی" جدید را در محصولات موجود درج می کند.

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 یک محدودیت خرید به ازای هر سفارش مشتری را برای تعریف محصول تعیین می‌کند و همچنین توسط فیدها پشتیبانی می‌شود. این ویژگی در حال حاضر در نسخه بتا است تا زمانی که API به طور کامل پشتیبانی کند. هر ویژگی سفارشی اضافی می تواند توسط یک تاجر اضافه شود، اما منجر به پردازش خاصی توسط API ها نمی شود.

یک تماس موفق یک کد 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"
}

محصولات.دریافت

برای دریافت اطلاعات یک محصول خاص در پایگاه داده Merchant Center، از products.get استفاده کنید. ممکن است چند دقیقه طول بکشد تا یک محصول جدید درج شده از طریق این تماس در دسترس قرار گیرد.

از URL درخواست HTTP و پارامترهای زیر، شناسه فروشنده و شناسه محصول (قالب ID REST) برای محصولی که می‌خواهید دریافت کنید استفاده کنید:

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 درخواست زیر با روش PATCH استفاده کنید و شناسه فروشنده، شناسه محصول و بدنه 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 Tee" موجود را با داده های محصول مربوطه ارائه شده در متن درخواست به روز می کند و همه فیلدهای دیگر از جمله 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 سه‌راهی» موجود را با استفاده از 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 با نمونه URL درخواست HTTP، شناسه فروشنده و شناسه محصول (در قالب ID REST مانند online:en:US:1111111111 ) برای محصولی که می‌خواهید حذف کنید، استفاده کنید:

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

یک پاسخ موفق HTTP Status 204 بدون بدنه پاسخ برمی گرداند.

لیست محصولات

products.list تمام محصولاتی را که یک تاجر در پایگاه داده مرکز تجاری دارد فهرست می کند. از 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"
   ]
  }
 ]
}