نمای کلی از 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 خاص ایجاد کنید.
  • منبع داده ای ایجاد کنید که فیلدهای feedLabel و contentLanguage تنظیم نشده باشد. با استفاده از این نوع منبع داده، می‌توانید چندین کشور را برای محصولات خود هدف قرار دهید، زیرا می‌توانید محصولات با ترکیب‌های مختلف feedLabel و contentLanguage را در یک منبع داده قرار دهید.
  • یک منبع داده تکمیلی برای پیوند به منبع داده اولیه موجود ایجاد کنید.
  • یک برنامه زمانی برای منبع داده فایل تنظیم کنید.
  • حساب خود را برای مدیریت خودکار منابع داده ثبت کنید.
  • مدیریت منابع داده API
  • قانون پیش فرض منابع داده را با استفاده از منابع داده محصول اولیه مدیریت کنید.
  • از انواع دیگر منابع داده مانند تبلیغات استفاده کنید.

نمی‌توانید از Merchant 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.

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

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

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

نمونه درخواست زیر نشان می دهد که چگونه می توانید منبع داده محصول اولیه ایجاد کنید:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

موارد زیر را جایگزین کنید:

  • {ACCOUNT_ID} : شناسه منحصر به فرد حساب Merchant Center شما.
  • {DISPLAY_NAME} : نام نمایشی منبع داده.
  • {CONTENT_LANGUAGE} : کد زبان ISO 639-1 دو حرفی محصولات موجود در منبع داده.
  • {FEED_LABEL} : برچسب فید منبع داده.
  • {COUNTRY} : کد قلمرو CLDR کشور هدف محصولاتی که با استفاده از منبع داده آپلود خواهند شد.

پس از اجرای موفقیت آمیز درخواست، پاسخ زیر را مشاهده می کنید:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

برای اطلاعات بیشتر در مورد ایجاد منبع داده، به روش accounts.dataSources.create مراجعه کنید.

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

یک منبع داده اولیه جدید ایجاد کنید که به هدف قرار دادن چندین کشور کمک می کند

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

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

فقط منابع داده با ورودی API می توانند بدون تنظیم فیلدهای feedLabel و contentLanguage باشند. این نوع از منابع داده برای ورودی فایل پشتیبانی نمی شود.

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

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

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

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

منابع داده فایل تکمیلی باید دارای فیلدهای feedLabel و contentLanguage باشند. منابع داده API تکمیلی باید همیشه دارای فیلدهای feedLabel و contentLanguage تنظیم نشده باشند.

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

برای تنظیم زمانبندی برای فید فایل خود، منبع داده خود را با استفاده از فیلد 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
 ]
}

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

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

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

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

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

GET https://merchantapi.googleapis.com/accounts/v1beta/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

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

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