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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
فیلدها
name

string

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

data Source Id

string ( int64 format)

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

display Name

string

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

input

enum ( Input )

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

file Input

object ( FileInput )

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

Type فیلد اتحادیه نوع منبع داده Type می تواند تنها یکی از موارد زیر باشد:
primary Product Data Source

object ( PrimaryProductDataSource )

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

supplemental Product Data Source

object ( SupplementalProductDataSource )

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

local Inventory Data Source

object ( LocalInventoryDataSource )

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

regional Inventory Data Source

object ( RegionalInventoryDataSource )

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

promotion Data Source

object ( PromotionDataSource )

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

product Review Data Source

object ( ProductReviewDataSource )

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

merchant Review Data Source

object ( MerchantReviewDataSource )

مورد نیاز. منبع داده بررسی بازرگان .

PrimaryProductDataSource

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

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

enum ( Channel )

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

countries[]

string

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

default Rule

object ( DefaultRule )

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

feed Label

string

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

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

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

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

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

content Language

string

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

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

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

کانال

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

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

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

DefaultRule

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

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

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 باید برای ارجاع به خود منبع داده اولیه استفاده شود.

primary Data Source Name

string

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

supplemental Data Source Name

string

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

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

منبع داده تکمیلی برای محصولات محلی و آنلاین. پس از ایجاد، باید مطمئن شوید که منبع داده تکمیلی محصول را به یک یا چند منبع داده اولیه محصول مرتبط کرده اید.

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

object ( DataSourceReference )

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

feed Label

string

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

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

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

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

آنها باید برای منابع داده با file input تنظیم شوند. فیلدها باید برای منابع داده بدون file input تنظیم نشده باشند.

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

content Language

string

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

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

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

LocalInventoryDataSource

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

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

string

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

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

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

content Language

string

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

RegionalInventoryDataSource

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

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

string

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

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

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

content Language

string

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

PromotionData Source

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

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

string

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

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

content Language

string

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

ProductReviewDataSource

این نوع هیچ فیلدی ندارد.

منبع داده بررسی محصول

MerchantReviewDataSource

این نوع هیچ فیلدی ندارد.

منبع داده بررسی بازرگان.

ورودی

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

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

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

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

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

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

ورودی فایل

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

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

object ( FetchSettings )

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

file Name

string

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

file Input Type

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

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

day Of Month

integer

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

time Of Day

object ( TimeOfDay )

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

day Of Week

enum ( DayOfWeek )

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

time Zone

string

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

frequency

enum ( Frequency )

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

fetch Uri

string

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

username

string

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

password

string

اختیاری. یک رمز عبور اختیاری برای fetchUri . برای ارسال منابع داده از طریق 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 و کوچکتر یا مساوی 999999999 باشد.

روز هفته

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

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_SHEETS فایل از Google Sheets مشخص شده در fetchUri واکشی شده است.

روش ها

create

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

delete

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

fetch

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

get

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

list

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

patch

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