REST Resource: accounts.dataSources

منبع: DataSource

منبع داده برای حساب Merchant Center.

نمایندگی JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
فیلدها
name

string

شناسه. نام منبع داده قالب: {datasource.name=accounts/{account}/dataSources/{datasource}}

dataSourceId

string ( int64 format)

فقط خروجی شناسه منبع داده

displayName

string

مورد نیاز. نام منبع داده نمایش داده شده در رابط کاربری Merchant Center.

input

enum ( Input )

فقط خروجی نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی ممکن است برخی از تنظیمات کار نکنند. فقط منابع داده عمومی را می توان از طریق API ایجاد کرد.

fileInput

object ( FileInput )

اختیاری. این فیلد فقط زمانی استفاده می شود که داده ها از طریق یک فایل مدیریت شوند.

Type فیلد اتحادیه نوع منبع داده Type می تواند تنها یکی از موارد زیر باشد:
primaryProductDataSource

object ( PrimaryProductDataSource )

مورد نیاز. منبع داده اولیه برای محصولات محلی و آنلاین.

supplementalProductDataSource

object ( SupplementalProductDataSource )

مورد نیاز. منبع داده تکمیلی برای محصولات محلی و آنلاین.

localInventoryDataSource

object ( LocalInventoryDataSource )

مورد نیاز. منبع داده موجودی محلی

regionalInventoryDataSource

object ( RegionalInventoryDataSource )

مورد نیاز. منبع داده های موجودی منطقه ای

promotionDataSource

object ( PromotionDataSource )

مورد نیاز. منبع داده های تبلیغاتی

PrimaryProductDataSource

منبع داده اولیه برای محصولات محلی و آنلاین.

نمایندگی JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
فیلدها
channel

enum ( Channel )

مورد نیاز. تغییرناپذیر. نوع کانال منبع داده را مشخص می کند.

countries[]

string

اختیاری. کشورهایی که ممکن است موارد نمایش داده شوند. به عنوان کد قلمرو CLDR نشان داده شده است.

defaultRule

object ( DefaultRule )

اختیاری. مدیریت قانون پیش فرض منبع داده. در صورت تنظیم، منابع داده مرتبط جایگزین خواهند شد.

feedLabel

string

اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است.

باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد.

همچنین مهاجرت به برچسب‌های خوراک را ببینید.

feedLabel و contentLanguage باید برای منابع داده با نوع محتوای محصول هر دو تنظیم یا تنظیم نشده باشند. آنها باید برای منابع داده با ورودی فایل تنظیم شوند.

در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد.

contentLanguage

string

اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده.

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

در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد.

کانال

کانال منبع داده.

کانال برای تمایز بین منابع داده برای عمودهای مختلف محصول استفاده می شود.

Enums
CHANNEL_UNSPECIFIED مشخص نشده است.
ONLINE_PRODUCTS محصول آنلاین.
LOCAL_PRODUCTS محصول محلی
PRODUCTS منبع داده یکپارچه برای محصولات محلی و آنلاین. توجه: مدیریت محصولات از طریق API برای این کانال امکان پذیر نیست.

DefaultRule

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

نمایندگی JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
فیلدها
takeFromDataSources[]

object ( DataSourceReference )

مورد نیاز. فهرست منابع داده‌ای که در قانون پیش‌فرض پیوند داده شده‌اند. این لیست بر اساس اولویت قانون پیش فرض برای پیوستن به داده ها مرتب شده است. ممکن است شامل هیچ یا چندین مرجع به منابع داده self و تکمیلی باشد.

لیست نباید خالی باشد.

برای پیوند دادن منبع داده به قانون پیش فرض، باید یک مرجع جدید به این لیست (به ترتیب متوالی) اضافه کنید.

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

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

به عنوان مثال، ارائه لیست زیر: [ 1001 , self ] مقادیر مشخصه را از منبع داده تکمیلی 1001 می گیرد و اگر ویژگی در 1001 تنظیم نشده باشد به self بازگشتی می دهد.

DataSourceReference

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

نمایندگی JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
فیلدها

فیلد اتحادیه data_source_id .

data_source_id می تواند تنها یکی از موارد زیر باشد:

self

boolean

Self باید برای ارجاع به خود منبع داده اولیه استفاده شود.

primaryDataSourceName

string

اختیاری. نام منبع داده اولیه. قالب: accounts/{account}/dataSources/{datasource}

supplementalDataSourceName

string

اختیاری. نام منبع داده تکمیلی. قالب: accounts/{account}/dataSources/{datasource}

منبع داده های تکمیلی محصول

منبع داده تکمیلی برای محصولات محلی و آنلاین.

نمایندگی JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
فیلدها
referencingPrimaryDataSources[]

object ( DataSourceReference )

فقط خروجی فهرست (نامرتب و حذف شده) از همه منابع داده اولیه مرتبط با این منبع داده در قوانین پیش‌فرض یا سفارشی. منبع داده های تکمیلی را نمی توان قبل از حذف همه پیوندها حذف کرد.

feedLabel

string

اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است.

باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد.

همچنین مهاجرت به برچسب‌های خوراک را ببینید.

feedLabel و contentLanguage باید برای منابع داده با نوع محتوای محصول هر دو تنظیم یا تنظیم نشده باشند. آنها باید برای منابع داده با ورودی فایل تنظیم شوند.

در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد.

contentLanguage

string

اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده.

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

در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد.

LocalInventoryDataSource

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

نمایندگی JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
فیلدها
feedLabel

string

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

باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد.

همچنین مهاجرت به برچسب‌های خوراک را ببینید.

contentLanguage

string

مورد نیاز. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی محلی به آنها ارائه می شود.

RegionalInventoryDataSource

منبع داده های موجودی منطقه ای

نمایندگی JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
فیلدها
feedLabel

string

مورد نیاز. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی منطقه ای به آنها ارائه می شود.

باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد.

همچنین مهاجرت به برچسب‌های خوراک را ببینید.

contentLanguage

string

مورد نیاز. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی منطقه ای به آنها ارائه می شود.

منبع داده های تبلیغاتی

منبع داده های تبلیغاتی

نمایندگی JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
فیلدها
targetCountry

string

مورد نیاز. تغییرناپذیر. کشور هدف که به عنوان بخشی از شناسه منحصر به فرد استفاده می شود. به عنوان کد قلمرو CLDR نشان داده شده است.

تبلیغات فقط در کشورهای منتخب موجود است.

contentLanguage

string

مورد نیاز. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده.

ورودی

نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی ممکن است برخی از تنظیمات پشتیبانی نشوند.

Enums
INPUT_UNSPECIFIED ورودی نامشخص است.
API نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق API ارائه می شوند.
FILE نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق ورودی فایل برای آنها ارائه می شود. داده ها همچنان می توانند از طریق API ارائه شوند.
UI

منبع داده برای محصولاتی که مستقیماً در Merchant Center اضافه شده است.

این نوع منبع داده را نمی توان از طریق این API ایجاد یا به روز کرد، فقط توسط Merchant Center UI.

این نوع منبع داده فقط خواندنی است.

AUTOFEED این همچنین به عنوان فیدهای خودکار شناخته می شود که برای ساخت خودکار داده های محصول شما استفاده می شود. این نوع منبع داده را می توان از طریق بسته حساب ها فعال یا غیرفعال کرد.

ورودی فایل

داده های خاص برای منابع داده فایل. این فیلد برای سایر ورودی های منبع داده خالی است.

نمایندگی JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
فیلدها
fetchSettings

object ( FetchSettings )

اختیاری. واکشی جزئیات برای ارائه منبع داده. این شامل تنظیماتی برای انواع ورودی فایل FETCH و GOOGLE_SHEETS است. فیلدهای مورد نیاز بر اساس تعداد دفعات واکشی متفاوت است.

fileName

string

اختیاری. نام فایل منبع داده. برای نوع ورودی فایل UPLOAD مورد نیاز است.

fileInputType

enum ( FileInputType )

فقط خروجی نوع فایل ورودی

FetchSettings

واکشی جزئیات برای ارائه منبع داده.

نمایندگی JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
فیلدها
enabled

boolean

اختیاری. برنامه واکشی را فعال یا متوقف می کند.

dayOfMonth

integer

اختیاری. روزی از ماه که فایل منبع داده باید واکشی شود (1-31). این قسمت را فقط می توان برای دفعات ماهانه تنظیم کرد.

timeOfDay

object ( TimeOfDay )

اختیاری. ساعتی از روز که فایل منبع داده باید واکشی شود. دقیقه و ثانیه پشتیبانی نمی شود و نادیده گرفته می شود.

dayOfWeek

enum ( DayOfWeek )

اختیاری. روزی از هفته که فایل منبع داده باید واکشی شود. این فیلد فقط برای دفعات هفتگی قابل تنظیم است.

timeZone

string

اختیاری. منطقه زمانی مورد استفاده برای برنامه UTC به صورت پیش فرض به عنوان مثال، "America/Los_Angeles".

frequency

enum ( Frequency )

مورد نیاز. فرکانس توصیف برنامه واکشی.

fetchUri

string

اختیاری. آدرس اینترنتی که فایل منبع داده را می توان واکشی کرد. Google Merchant Center از آپلودهای برنامه ریزی شده خودکار با استفاده از پروتکل های HTTP، HTTPS یا SFTP پشتیبانی می کند، بنابراین مقدار باید یک پیوند معتبر با استفاده از یکی از این سه پروتکل باشد. غیرقابل تغییر برای فایل‌های Google Sheets.

username

string

اختیاری. یک نام کاربری اختیاری برای [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. برای ارسال منابع داده از طریق SFTP استفاده می شود.

password

string

اختیاری. یک رمز عبور اختیاری برای [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. برای ارسال منابع داده از طریق SFTP استفاده می شود.

TimeOfDay

یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date و google.protobuf.Timestamp .

نمایندگی JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
فیلدها
hours

integer

ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند.

minutes

integer

دقیقه از ساعت روز. باید از 0 تا 59 باشد.

seconds

integer

ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند.

nanos

integer

کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد.

روز هفته

یک روز از هفته را نشان می دهد.

Enums
DAY_OF_WEEK_UNSPECIFIED روز هفته نامشخص است.
MONDAY دوشنبه
TUESDAY سه شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

فرکانس

فیلدهای مورد نیاز بر اساس تعداد دفعات واکشی متفاوت است. برای یک برنامه واکشی ماهانه، [روز از ماه][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] و [ساعت از روز][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day ] مورد نیاز است. برای یک برنامه واکشی هفتگی، [روز هفته][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] و [ساعت از روز][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day ] مورد نیاز است. برای برنامه واکشی روزانه، فقط یک [ساعت در روز][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] مورد نیاز است.

Enums
FREQUENCY_UNSPECIFIED فرکانس نامشخص
FREQUENCY_DAILY واکشی هر روز اتفاق می افتد.
FREQUENCY_WEEKLY واکشی هر هفته اتفاق می افتد.
FREQUENCY_MONTHLY واکشی هر ماه اتفاق می افتد.

FileInputType

روش تحویل پرونده

Enums
FILE_INPUT_TYPE_UNSPECIFIED نوع ورودی فایل مشخص نشده است.
UPLOAD فایل از طریق SFTP، Google Cloud Storage یا به صورت دستی در Merchant Center آپلود می شود.
FETCH فایل از [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] پیکربندی شده واکشی شده است.
GOOGLE_SHEETS فایل از Google Sheets مشخص شده در [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] واکشی شده است.

روش ها

create

 پیکربندی منبع داده جدید را برای حساب داده شده ایجاد می کند.

delete

 یک منبع داده را از حساب Merchant Center شما حذف می کند.

fetch

 واکشی داده را فوراً (حتی برنامه واکشی خارج از برنامه) در یک منبع داده از حساب Merchant Center شما انجام می دهد.

get

 پیکربندی منبع داده را برای حساب داده شده بازیابی می کند.

list

 تنظیمات منابع داده را برای حساب داده شده فهرست می کند.

patch

 پیکربندی منبع داده موجود را به روز می کند.