- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- آن را امتحان کنید!
ورودی محصول را در حساب Merchant Center شما آپلود می کند. اگر ورودی با همان contentLanguage، offerId و dataSource از قبل وجود داشته باشد، این روش جایگزین آن ورودی می شود.
پس از درج، بهروزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده بازیابی شود.
درخواست HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
parent | ضروری. حسابی که این محصول در آن درج خواهد شد. قالب: حسابها/{حساب} |
پارامترهای پرس و جو
مولفه های | |
---|---|
dataSource | ضروری. نام منبع داده محصول اولیه یا تکمیلی. اگر محصول از قبل وجود داشته باشد و منبع داده ارائه شده متفاوت باشد، محصول به منبع داده جدیدی منتقل می شود. قالب: |
درخواست بدن
بدنه درخواست شامل یک نمونه از ProductInput
است.
بدن پاسخگو
این منبع دادههای ورودی را نشان میدهد که برای یک محصول ارسال میکنید، نه محصول پردازششدهای را که در Merchant Center، در تبلیغات خرید یا در سطوح Google میبینید. ورودیهای محصول، قوانین و دادههای منبع داده تکمیلی برای ایجاد [product][google.shopping.content.bundles.Products.Product] پردازش شده ترکیب میشوند.
ویژگیهای ورودی محصول مورد نیاز برای بررسی اعتبار دادهها در اصل در مشخصات دادههای محصولات تعریف شدهاند.
ویژگیهای زیر مورد نیاز است: [feedLabel][google.shopping.content.bundles.Products.feed_label]، [contentLanguage][google.shopping.content.bundles.Products.content_language] و [offerId][google.shopping.content. bundles.Products.offer_id].
پس از درج، بهروزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده بازیابی شود.
همه فیلدها در ورودی محصول و پیامهای فرعی آن با نام انگلیسی ویژگی مربوطه خود در مشخصات عمودی با برخی استثناء مطابقت دارند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
زمینه های | |
---|---|
name | مشخص کننده. نام ورودی محصول قالب: |
product | فقط خروجی نام محصول فرآوری شده قالب: |
channel | ضروری. تغییرناپذیر. کانال محصول |
offerId | ضروری. تغییرناپذیر. شناسه منحصر به فرد شما برای محصول. این برای ورودی محصول و محصول فرآوری شده یکسان است. فضاهای سفید پیشرو و انتهایی حذف می شوند و پس از ارسال، چندین فاصله سفید با یک فضای خالی واحد جایگزین می شوند. برای جزئیات به مشخصات داده محصولات مراجعه کنید. |
contentLanguage | ضروری. تغییرناپذیر. کد زبان دو حرفی ISO 639-1 برای محصول. |
feedLabel | ضروری. تغییرناپذیر. برچسب خوراک برای محصول |
attributes | اختیاری. لیستی از ویژگی های محصول |
customAttributes[] | اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین میتوان از آن برای ارسال هر ویژگی از مشخصات دادهها به شکل عمومی آن استفاده کرد (به عنوان مثال، |
versionNumber | اختیاری. نشان دهنده نسخه موجود (تازه بودن) محصول است که می توان از آن برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده کرد. در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی محصول موجود باشد، از درج جلوگیری می شود. قرار دادن مجدد (به عنوان مثال، بازخوانی محصول پس از 30 روز) را می توان با فقط برای درج در منابع داده اولیه پشتیبانی می شود. اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/content
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.