نمای کلی از Merchant Data Sources API

این صفحه نحوه ایجاد و به روز رسانی منابع داده خود را که به شما امکان می دهد محصولات را درج کنید، به صورت برنامه نویسی نشان می دهد. منابع داده خودکار ارسال داده‌های محصول شما را به Google آسان‌تر می‌کنند. منابع داده خودکار اطمینان حاصل می کنند که به روزترین اطلاعات در مورد محصولات مرتبط از وب سایت شما به گوگل می رسد.

Content API for Shopping فقط به شما امکان می دهد منابع داده اولیه ایجاد کنید. با Merchant Data Sources API، می‌توانید انواع منابع داده زیر را ایجاد کنید:

• منابع داده اولیه محصول
• منابع اطلاعات تکمیلی محصول
• منابع داده موجودی محلی
• منابع داده موجودی منطقه ای
• منابع داده های تبلیغاتی

Content API for Shopping فقط اجازه مدیریت منابع داده با ورودی فایل را می داد. Merchant API به شما امکان می دهد منابع داده را با ورودی فایل و API مدیریت کنید.

با استفاده از Merchant Data Sources API، می‌توانید کارهای زیر را انجام دهید:

• یک منبع داده اولیه جدید با یک feedLabel و contentLanguage خاص ایجاد کنید.
• یک منبع داده wildcard ایجاد کنید. منبع داده با حروف عام فیلدهای feedLabel و contentLanguage تنظیم نشده است. منابع داده Wildcard به شما امکان می دهند محصولاتی با ترکیبات مختلف feedLabel و contentLanguage را در منبع داده قرار دهید.
• یک منبع داده تکمیلی برای پیوند به منبع داده اولیه موجود ایجاد کنید.
• یک برنامه زمانی برای منبع داده فایل تنظیم کنید.
• حساب خود را برای مدیریت خودکار منابع داده ثبت کنید.
• مدیریت منابع داده API
• قانون پیش فرض منابع داده را با استفاده از منابع داده محصول اولیه مدیریت کنید.
• از انواع دیگر منابع داده مانند تبلیغات استفاده کنید.

پیش نیازها

• حساب شما باید به فیدهای محلی منتقل شده باشد.

• برای تأیید اینکه حساب قبلاً به تقسیم هدف داده منتقل شده است، از فهرست منبع داده یا روش‌های دریافت استفاده کنید. در صورتی که واجد شرایط نباشید، پیام استثنایی زیر را دریافت خواهید کرد و باید با پشتیبانی تماس بگیرید.

  This account is in the data sources migration process and can't be used with
  this API yet. Contact support for more info on when this account will be able
  to use the data sources endpoint.
  

یک منبع داده جدید ایجاد کنید

برای ایجاد یک منبع داده اولیه جدید با یک feedLabel و contentLanguage خاص، فیلدهای feedLabel و contentLanguage را در پیکربندی نوع خاص تنظیم کنید. به عنوان مثال، PrimaryProductDataSource .

برای مشاهده منبع داده جدید ایجاد شده خود، یک درخواست GET یا LIST ایجاد کنید.

یک منبع داده اولیه با حروف عام ایجاد کنید

برای ایجاد یک فید اصلی جدید، منبع داده خود را با استفاده از PrimaryProductDataSource پیکربندی کنید و فیلدهای feedLabel و contentLanguage را تنظیم نکنید.

با استفاده از Content API برای خرید، تنها یک منبع داده API برای شما ایجاد شده است. با استفاده از Merchant Data Sources API، می‌توانید چندین منبع داده API داشته باشید، که برخی از آنها می‌توانند دارای حروف عام باشند.

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

یک منبع داده تکمیلی ایجاد کنید و آن را به منبع داده اولیه پیوند دهید

هنگام برقراری تماس با روش های accounts.productInputs.insert و accounts.productInputs.delete می توانید از منابع داده تکمیلی برای به روز رسانی جزئی داده های محصول با افزودن شناسه منحصر به فرد منبع داده به عنوان پارامتر جستجو استفاده کنید. شما فقط می توانید از منابع داده تکمیلی برای به روز رسانی محصولات موجود استفاده کنید.

برای ایجاد یک منبع داده تکمیلی، منبع داده خود را با استفاده از SupplementalProductDataSource پیکربندی کنید و سپس آن را با به روز رسانی فیلد defaultRule در منبع داده اصلی خود پیوند دهید.

منابع داده های فایل تکمیلی نمی توانند منابع داده های عام باشند. منابع داده API تکمیلی همیشه باید منابع داده های wildcard باشند.

یک برنامه زمانی برای منبع داده فایل خود تنظیم کنید

برای تنظیم زمانبندی برای فید فایل خود، منبع داده خود را با استفاده از فیلد FileInput پیکربندی کنید تا منبع داده فایل باشد و سپس fetchsettings با استفاده از فیلد FileInput.FetchSettings تنظیم کنید.

یک منبع داده را حذف کنید

برای حذف یک منبع داده موجود از حساب خود، از روش accounts.dataSources.delete استفاده کنید.

واکشی منبع داده

برای واکشی فایل پیکربندی شده در منبع داده، از روش accounts.dataSources.fetch استفاده کنید. این روش واکشی داده را فوراً در منبع داده از حساب شما انجام می دهد. این روش فقط روی منابع داده با مجموعه ورودی فایل کار می کند.

دریافت منبع داده

برای بازیابی پیکربندی منبع داده برای حساب خود، از روش accounts.dataSources.get استفاده کنید.

فهرست منبع داده

برای فهرست کردن تنظیمات منابع داده برای حساب خود، از روش accounts.dataSources.list استفاده کنید.

منبع داده پچ

برای به روز رسانی پیکربندی یک منبع داده موجود، از روش accounts.dataSources.patch استفاده کنید.

پیوند دادن منابع داده

منابع داده محصول اولیه به شما امکان می دهند قانون پیش فرض منابع داده را مدیریت کنید. قانون پیش‌فرض، قانونی است که برای همه ویژگی‌های منبع داده شما اعمال می‌شود. قانون پیش فرض را می توان در حین ایجاد منبع داده یا با به روز رسانی منبع داده موجود از طریق فیلد قانون پیش فرض تنظیم کرد.

پیکربندی نمونه زیر تضمین می کند که ابتدا همه ویژگی ها از منبع داده با شناسه منحصر به فرد 1001 گرفته شده است. سپس ویژگی های گمشده از منبع داده اولیه اضافه می شوند. در نهایت، اگر قبلاً در هیچ منبع داده دیگری ارائه نشده باشد، ویژگی های باقی مانده از منبع داده تکمیلی با شناسه منحصر به فرد 1002 گرفته می شود. اگر همان ویژگی در چندین منبع داده ارائه شود، مقدار بالاتر در لیست انتخاب می شود.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

توجه: قوانین سفارشی را نمی توان از طریق API تغییر داد.

مدیریت خودکار فیدها

برای ثبت نام حساب خود برای مدیریت خودکار منابع داده، باید موارد زیر را انجام دهید:

• با تماس با روش Accounts.AutofeedSettings.Get بررسی کنید که آیا حساب شما واجد شرایط ثبت نام است یا خیر.
• مطمئن شوید که حساب شما یک حساب بازار نیست.

پس از اینکه حساب شما واجد شرایط ثبت نام شد، می توانید از روش Accounts.AutofeedSettings.Update برای فعال کردن مدیریت خودکار منابع داده استفاده کنید. فعال کردن مدیریت خودکار منابع داده به Google اجازه می‌دهد به‌طور خودکار محصولات شما را از فروشگاه آنلاین شما اضافه کند و اطمینان حاصل کند که همیشه در پلتفرم‌های Google به‌روز هستند.

بازیابی وضعیت آپلود فایل

برای دریافت وضعیت منبع داده با فایل، واکشی یا صفحه گسترده، می‌توانید با روش GET سرویس FileUpload تماس بگیرید. برای به دست آوردن نتیجه آخرین بازیابی منبع داده محاسبه شده به صورت ناهمزمان پس از پایان پردازش منبع داده، latest شناسه نام استفاده کنید.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

وضعیت آپلود فایل ممکن است نمای دقیقی از محصولات شما، از جمله مشکلات احتمالی داشته باشد.

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