این صفحه توضیح می دهد که چگونه می توانید محصولات خود را به صورت برنامه ای آپلود و مدیریت کنید. با استفاده از Merchant Products API، می‌توانید محصولی را در منبع داده درج یا به‌روزرسانی کنید، محصولی را از حساب خود بازیابی کنید و محصولی را از منبع داده حذف کنید.
Merchant Products API شامل دو منبع است.
-
productInputsقسمت های ورودی محصولات شما را نشان می دهد. -
productsنشان دهنده محصولات فرآوری شده است که از قطعات ورودی شما ساخته شده است.
productInputs بسته به اینکه در یک منبع داده اولیه یا یک منبع داده تکمیلی آپلود شود، می تواند اولیه و تکمیلی باشد. هر product از یک productInput اولیه و هر تعداد productInputs تکمیلی ساخته خواهد شد.
می‌توانید از Merchant Products API برای ایجاد کاتالوگ‌های فروشگاه آنلاین یا محلی استفاده کنید، اینها محصولاتی هستند که می‌توانند در چندین مقصد خرید ظاهر شوند. زمانی که حساب Merchant Center خود را ایجاد کردید، اولین منبع داده خود را راه اندازی کردید و آماده آپلود مجموعه اولیه محصولات از طریق API هستید، می توانید از منبع productInputs استفاده کنید.
اگرچه تاجران توانایی آپلود محصولات را با استفاده از فایلی به نام PrimaryProductDataSource دارند، ایجاد و حذف محصولات با استفاده از Merchant API مزایای متعددی دارد. این مزایا شامل زمان پاسخگویی سریعتر و امکان به روز رسانی محصولات در زمان واقعی، بدون نیاز به مدیریت فایل های حجیم است. ممکن است چندین ساعت طول بکشد تا تغییرات محصول ایجاد شده توسط تماس‌های API در پایگاه داده خرید نشان داده شود.
پیش نیازها
اگر منبع داده ندارید، با استفاده از Merchant DataSources API یا Merchant Center یک منبع داده ایجاد کنید .
اگر قبلاً منبع داده ای دارید که با استفاده از Merchant Center UI یا با استفاده از API ایجاد کرده اید، می توانید از Merchant Products API برای افزودن محصولات خود استفاده کنید. اگر از Content API برای خرید برای افزودن محصولات استفاده می‌کنید، به راهنمای انتقال مراجعه کنید تا بدانید چگونه می‌توانید با Merchant Products API شروع کنید.
شما مسئول رعایت سیاست‌های تبلیغات خرید و فهرست‌های رایگان هستید. تبلیغات خرید این حق را برای خود محفوظ می‌دارد که این خط‌مشی‌ها را اجرا کند و در صورت مشاهده محتوا یا رفتاری که این خط‌مشی‌ها را نقض می‌کند، به آن پاسخ مناسب بدهد.
منابع
منبع products به شما امکان می دهد اطلاعات محصول را از پایگاه داده خرید بازیابی کنید.
منبع productInput نشان دهنده داده های ورودی شما برای یک محصول است. همچنین روش‌هایی را ارائه می‌کند که به شما امکان می‌دهد اطلاعات محصول را یکی یکی یا چند بار در حالت دسته‌ای به‌روزرسانی یا حذف کنید. یک منبع productInput باید دارای فیلدهای زیر باشد:
-
channel: کانال محصول. -
offerId: شناسه منحصر به فرد محصول. -
contentLanguage: کد زبان دو حرفی ISO 639-1 برای محصول. -
feedLabel: برچسب خوراک برای محصول.
ورودی محصول را در حساب خود آپلود کنید
برای آپلود ورودی محصول در حساب خود، از روش accounts.productInputs.insert استفاده کنید. شما باید شناسه منحصر به فرد منبع داده اولیه یا تکمیلی را ارسال کنید.
یک محصول پردازش شده را از حساب خود بازیابی کنید
برای بازیابی یک محصول پردازش شده از حساب خود، از روش accounts.products.get استفاده کنید. ممکن است چند دقیقه طول بکشد تا محصول فرآوری شده پس از قرار دادن ظاهر شود.
می توانید نام منبع محصول پردازش شده را از قسمت product در پاسخ accounts.productInputs.insert دریافت کنید.
یک ورودی محصول را از حساب خود حذف کنید
برای حذف ورودی محصول از حساب خود، از روش accounts.productInputs.delete استفاده کنید. برای حذف یک محصول با استفاده از Merchant Products API، باید شناسه منحصر به فرد منبع داده اصلی یا تکمیلی را که محصول به آن تعلق دارد، ارسال کنید.
محصولات را از حساب خود فهرست کنید
برای فهرست کردن محصولات پردازش شده در حساب خود، از روش accounts.products.list استفاده کنید.