Method: accounts.productInputs.insert

ورودی محصول را در حساب Merchant Center شما آپلود می کند. اگر ورودی با همان contentLanguage، offerId و dataSource از قبل وجود داشته باشد، این روش جایگزین آن ورودی می شود.

پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول پردازش شده بازیابی شود.

درخواست HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. حسابی که این محصول در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

پارامترهای پرس و جو

مولفه های
dataSource

string

ضروری. نام منبع داده محصول اولیه یا تکمیلی. اگر محصول از قبل وجود داشته باشد و منبع داده ارائه شده متفاوت باشد، محصول به منبع داده جدیدی منتقل می شود. قالب: accounts/{account}/dataSources/{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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
زمینه های
name

string

مشخص کننده. نام ورودی محصول قالب: "{productinput.name=accounts/{account}/productInputs/{productinput}}"

product

string

فقط خروجی نام محصول فرآوری شده قالب: "{product.name=accounts/{account}/products/{product}}"

channel

enum ( ChannelEnum )

ضروری. تغییرناپذیر. کانال محصول

offerId

string

ضروری. تغییرناپذیر. شناسه منحصر به فرد شما برای محصول. این برای ورودی محصول و محصول فرآوری شده یکسان است. فضاهای سفید پیشرو و انتهایی حذف می شوند و پس از ارسال، چندین فاصله سفید با یک فضای خالی واحد جایگزین می شوند. برای جزئیات به مشخصات داده محصولات مراجعه کنید.

contentLanguage

string

ضروری. تغییرناپذیر. کد زبان دو حرفی ISO 639-1 برای محصول.

feedLabel

string

ضروری. تغییرناپذیر. برچسب خوراک برای محصول

attributes

object ( Attributes )

اختیاری. لیستی از ویژگی های محصول

customAttributes[]

object ( CustomAttribute )

اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین می‌توان از آن برای ارسال هر ویژگی از مشخصات داده‌ها به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به‌صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است. حداکثر تعداد مجاز کاراکتر برای هر ویژگی سفارشی 10240 است (نماینده مجموع کاراکترها برای نام و مقدار). حداکثر 2500 ویژگی سفارشی را می توان برای هر محصول با حجم کل 102.4 کیلوبایت تنظیم کرد. زیرخط در نام ویژگی های سفارشی پس از درج با فاصله جایگزین می شود.

versionNumber

string ( int64 format)

اختیاری. نشان دهنده نسخه موجود (تازه بودن) محصول است که می توان از آن برای حفظ نظم درست زمانی که به روز رسانی های متعدد به طور همزمان انجام می شود استفاده کرد.

در صورت تنظیم، زمانی که شماره نسخه کمتر از شماره نسخه فعلی محصول موجود باشد، از درج جلوگیری می شود. قرار دادن مجدد (به عنوان مثال، بازخوانی محصول پس از 30 روز) را می توان با versionNumber انجام داد.

فقط برای درج در منابع داده اولیه پشتیبانی می شود.

اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.