نمای کلی از 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 استفاده کنید.