- منبع: DataSource
- PrimaryProductDataSource
- کانال
- منبع داده های تکمیلی محصول
- LocalInventoryDataSource
- RegionalInventoryDataSource
- منبع داده های تبلیغاتی
- ورودی
- ورودی فایل
- FetchSettings
- TimeOfDay
- روز هفته
- فرکانس
- FileInputType
- مواد و روش ها
منبع: DataSource
منبع داده برای حساب Merchant Center.
نمایندگی JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
زمینه های | |
---|---|
name | مشخص کننده. نام منبع داده قالب: |
dataSourceId | فقط خروجی شناسه منبع داده |
displayName | ضروری. نام منبع داده نمایش داده شده در رابط کاربری Merchant Center. |
input | فقط خروجی نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی، برخی از تنظیمات ممکن است کار نکنند. فقط منابع داده عمومی را می توان از طریق API ایجاد کرد. |
fileInput | اختیاری. این فیلد فقط زمانی استفاده می شود که داده ها از طریق یک فایل مدیریت شوند. |
Type فیلد اتحادیه نوع منبع داده Type می تواند تنها یکی از موارد زیر باشد: | |
primaryProductDataSource | ضروری. منبع داده اولیه برای محصولات محلی و آنلاین. |
supplementalProductDataSource | ضروری. منبع داده تکمیلی برای محصولات محلی و آنلاین. |
localInventoryDataSource | ضروری. منبع داده موجودی محلی |
regionalInventoryDataSource | ضروری. منبع داده های موجودی منطقه ای |
promotionDataSource | ضروری. منبع داده های تبلیغاتی |
PrimaryProductDataSource
منبع داده اولیه برای محصولات محلی و آنلاین.
نمایندگی JSON |
---|
{
"channel": enum ( |
زمینه های | |
---|---|
channel | ضروری. تغییرناپذیر. نوع کانال منبع داده را مشخص می کند. |
countries[] | اختیاری. کشورهایی که ممکن است موارد نمایش داده شوند. به عنوان کد قلمرو CLDR نشان داده شده است. |
feedLabel | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
contentLanguage | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
کانال
کانال منبع داده.
کانال برای تمایز بین منابع داده برای عمودهای مختلف محصول استفاده می شود.
Enums | |
---|---|
CHANNEL_UNSPECIFIED | مشخص نشده است. |
ONLINE_PRODUCTS | محصول آنلاین. |
LOCAL_PRODUCTS | محصول محلی |
PRODUCTS | منبع داده یکپارچه برای محصولات محلی و آنلاین. |
منبع داده های تکمیلی محصول
منبع داده تکمیلی برای محصولات محلی و آنلاین.
نمایندگی JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
زمینه های | |
---|---|
feedLabel | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
contentLanguage | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
LocalInventoryDataSource
منبع داده موجودی محلی
نمایندگی JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
زمینه های | |
---|---|
feedLabel | ضروری. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی محلی به آنها ارائه می شود. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. |
contentLanguage | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی محلی به آنها ارائه می شود. |
RegionalInventoryDataSource
منبع داده های موجودی منطقه ای
نمایندگی JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
زمینه های | |
---|---|
feedLabel | ضروری. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی منطقه ای به آنها ارائه می شود. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. |
contentLanguage | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی منطقه ای به آنها ارائه می شود. |
منبع داده های تبلیغاتی
منبع داده های تبلیغاتی
نمایندگی JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
زمینه های | |
---|---|
targetCountry | ضروری. تغییرناپذیر. کشور هدف که به عنوان بخشی از شناسه منحصر به فرد استفاده می شود. به عنوان کد قلمرو CLDR نشان داده شده است. تبلیغات فقط در کشورهای منتخب موجود است. |
contentLanguage | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. |
ورودی
نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی ممکن است برخی از تنظیمات پشتیبانی نشوند.
Enums | |
---|---|
INPUT_UNSPECIFIED | ورودی نامشخص است. |
API | نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق API ارائه می شوند. |
FILE | نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق ورودی فایل برای آنها ارائه می شود. داده ها همچنان می توانند از طریق API ارائه شوند. |
UI | منبع داده برای محصولاتی که مستقیماً در Merchant Center اضافه شده است. این نوع منبع داده را نمی توان از طریق این API ایجاد یا به روز کرد، فقط توسط Merchant Center UI. این نوع منبع داده فقط خواندنی است. |
AUTOFEED | این همچنین به عنوان فیدهای خودکار شناخته می شود که برای ساخت خودکار داده های محصول شما استفاده می شود. این نوع منبع داده را می توان از طریق بسته حساب ها فعال یا غیرفعال کرد. |
ورودی فایل
داده های خاص برای منابع داده فایل. این فیلد برای سایر ورودی های منبع داده خالی است.
نمایندگی JSON |
---|
{ "fetchSettings": { object ( |
زمینه های | |
---|---|
fetchSettings | اختیاری. واکشی جزئیات برای ارائه منبع داده. این شامل تنظیماتی برای انواع ورودی فایل |
fileName | اختیاری. نام فایل منبع داده. برای نوع ورودی فایل |
fileInputType | فقط خروجی نوع فایل ورودی |
FetchSettings
واکشی جزئیات برای ارائه منبع داده.
نمایندگی JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
زمینه های | |
---|---|
enabled | اختیاری. برنامه واکشی را فعال یا متوقف می کند. |
dayOfMonth | اختیاری. روزی از ماه که فایل منبع داده باید واکشی شود (1-31). این قسمت را فقط می توان برای دفعات ماهانه تنظیم کرد. |
timeOfDay | اختیاری. ساعتی از روز که فایل منبع داده باید واکشی شود. دقیقه و ثانیه پشتیبانی نمی شود و نادیده گرفته می شود. |
dayOfWeek | اختیاری. روزی از هفته که فایل منبع داده باید واکشی شود. این فیلد فقط برای دفعات هفتگی قابل تنظیم است. |
timeZone | اختیاری. منطقه زمانی مورد استفاده برای برنامه UTC به صورت پیش فرض به عنوان مثال، "America/Los_Angeles". |
frequency | ضروری. فرکانس توصیف برنامه واکشی. |
fetchUri | اختیاری. آدرس اینترنتی که فایل منبع داده را می توان واکشی کرد. Google Merchant Center از آپلودهای برنامه ریزی شده خودکار با استفاده از پروتکل های HTTP، HTTPS یا SFTP پشتیبانی می کند، بنابراین مقدار باید یک پیوند معتبر با استفاده از یکی از این سه پروتکل باشد. غیرقابل تغییر برای فایلهای Google Sheets. |
username | اختیاری. یک نام کاربری اختیاری برای [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. برای ارسال منابع داده از طریق SFTP استفاده می شود. |
password | اختیاری. یک رمز عبور اختیاری برای [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 | ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند. |
minutes | دقیقه از ساعت روز. باید از 0 تا 59 باشد. |
seconds | ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند. |
nanos | کسری از ثانیه در نانوثانیه. باید از 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] واکشی شده است. |
مواد و روش ها | |
---|---|
| پیکربندی منبع داده جدید را برای حساب داده شده ایجاد می کند. |
| یک منبع داده را از حساب Merchant Center شما حذف می کند. |
| واکشی داده را بلافاصله (حتی برنامه واکشی خارج از برنامه) در منبع داده از حساب Merchant Center شما انجام می دهد. |
| پیکربندی منبع داده را برای حساب داده شده بازیابی می کند. |
| تنظیمات منابع داده را برای حساب داده شده فهرست می کند. |
| پیکربندی منبع داده موجود را به روز می کند. |