فهرست مطالب
-
DataSourcesService
(رابط) -
CreateDataSourceRequest
(پیام) -
DataSource
(پیام) -
DataSource.Input
(enum) -
DeleteDataSourceRequest
(پیام) -
FetchDataSourceRequest
(پیام) -
FileInput
(پیام) -
FileInput.FetchSettings
(پیام) -
FileInput.FetchSettings.Frequency
(enum) -
FileInput.FileInputType
(enum) -
GetDataSourceRequest
(پیام) -
ListDataSourcesRequest
(پیام) -
ListDataSourcesResponse
(پیام) -
LocalInventoryDataSource
(پیام) -
PrimaryProductDataSource
(پیام) -
PrimaryProductDataSource.Channel
(عدد) -
PromotionDataSource
(پیام) -
RegionalInventoryDataSource
(پیام) -
SupplementalProductDataSource
(پیام) -
UpdateDataSourceRequest
(پیام)
DataSourcesService
خدماتی برای مدیریت منابع داده اولیه، تکمیلی، موجودی و سایر منابع. در مقاله راهنمای Merchant Center بیشتر ببینید.
CreateDataSource |
---|
پیکربندی منبع داده جدید را برای حساب داده شده ایجاد می کند.
|
DeleteDataSource |
---|
یک منبع داده را از حساب Merchant Center شما حذف می کند.
|
FetchDataSource |
---|
واکشی داده را فوراً (حتی برنامه واکشی خارج از برنامه) در یک منبع داده از حساب Merchant Center شما انجام می دهد. اگر نیاز دارید بیش از یک بار در روز با این روش تماس بگیرید، باید از سرویس محصولات برای بهروزرسانی اطلاعات محصول خود استفاده کنید. این روش فقط روی منابع داده با مجموعه ورودی فایل کار می کند.
|
GetDataSource |
---|
پیکربندی منبع داده را برای حساب داده شده بازیابی می کند.
|
ListDataSources |
---|
تنظیمات منابع داده را برای حساب داده شده فهرست می کند.
|
UpdateDataSource |
---|
پیکربندی منبع داده موجود را به روز می کند. فیلدهایی که در ماسک به روز رسانی تنظیم شده اند اما در منبع ارائه نشده اند حذف خواهند شد.
|
CreateDataSourceRequest
درخواست پیام برای متد CreateDataSource.
زمینه های | |
---|---|
parent | ضروری. حسابی که این منبع داده در آن ایجاد خواهد شد. قالب: |
data_source | ضروری. منبع داده برای ایجاد |
منبع اطلاعات
منبع داده برای حساب Merchant Center.
زمینه های | |
---|---|
name | مشخص کننده. نام منبع داده قالب: |
data_source_id | فقط خروجی شناسه منبع داده |
display_name | ضروری. نام منبع داده نمایش داده شده در رابط کاربری Merchant Center. |
input | فقط خروجی نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی، برخی از تنظیمات ممکن است کار نکنند. فقط منابع داده عمومی را می توان از طریق API ایجاد کرد. |
file_input | اختیاری. این فیلد فقط زمانی استفاده می شود که داده ها از طریق یک فایل مدیریت شوند. |
Type فیلد اتحادیه نوع منبع داده Type می تواند تنها یکی از موارد زیر باشد: | |
primary_product_data_source | ضروری. منبع داده اولیه برای محصولات محلی و آنلاین. |
supplemental_product_data_source | ضروری. منبع داده تکمیلی برای محصولات محلی و آنلاین. |
local_inventory_data_source | ضروری. منبع داده موجودی محلی |
regional_inventory_data_source | ضروری. منبع داده های موجودی منطقه ای |
promotion_data_source | ضروری. منبع داده های تبلیغاتی |
ورودی
نوع ورودی به منبع داده را تعیین می کند. بر اساس ورودی ممکن است برخی از تنظیمات پشتیبانی نشوند.
Enums | |
---|---|
INPUT_UNSPECIFIED | ورودی نامشخص است. |
API | نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق API ارائه می شوند. |
FILE | نشان دهنده منابع داده ای است که داده ها عمدتاً از طریق ورودی فایل برای آنها ارائه می شود. داده ها همچنان می توانند از طریق API ارائه شوند. |
UI | منبع داده برای محصولاتی که مستقیماً در Merchant Center اضافه شده است. این نوع منبع داده را نمی توان از طریق این API ایجاد یا به روز کرد، فقط توسط Merchant Center UI. این نوع منبع داده فقط خواندنی است. |
AUTOFEED | این همچنین به عنوان فیدهای خودکار شناخته می شود که برای ساخت خودکار داده های محصول شما استفاده می شود. این نوع منبع داده را می توان از طریق بسته حساب ها فعال یا غیرفعال کرد. |
DeleteDataSourceRequest
درخواست پیام برای متد DeleteDataSource.
زمینه های | |
---|---|
name | ضروری. نام منبع داده برای حذف. قالب: |
FetchDataSourceRequest
درخواست پیام برای متد FetchDataSource.
زمینه های | |
---|---|
name | ضروری. نام منبع منبع داده برای واکشی. قالب: |
ورودی فایل
داده های خاص برای منابع داده فایل. این فیلد برای سایر ورودی های منبع داده خالی است.
زمینه های | |
---|---|
fetch_settings | اختیاری. واکشی جزئیات برای ارائه منبع داده. این شامل تنظیماتی برای انواع ورودی فایل |
file_name | اختیاری. نام فایل منبع داده. برای نوع ورودی فایل |
file_input_type | فقط خروجی نوع فایل ورودی |
FetchSettings
واکشی جزئیات برای ارائه منبع داده.
زمینه های | |
---|---|
enabled | اختیاری. برنامه واکشی را فعال یا متوقف می کند. |
day_of_month | اختیاری. روزی از ماه که فایل منبع داده باید واکشی شود (1-31). این قسمت را فقط می توان برای دفعات ماهانه تنظیم کرد. |
time_of_day | اختیاری. ساعتی از روز که فایل منبع داده باید واکشی شود. دقیقه و ثانیه پشتیبانی نمی شود و نادیده گرفته می شود. |
day_of_week | اختیاری. روزی از هفته که فایل منبع داده باید واکشی شود. این فیلد فقط برای دفعات هفتگی قابل تنظیم است. |
time_zone | اختیاری. منطقه زمانی مورد استفاده برای برنامه UTC به صورت پیش فرض به عنوان مثال، "America/Los_Angeles". |
frequency | ضروری. فرکانس توصیف برنامه واکشی. |
fetch_uri | اختیاری. آدرس اینترنتی که فایل منبع داده را می توان واکشی کرد. 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 استفاده می شود. |
فرکانس
فیلدهای مورد نیاز بر اساس تعداد دفعات واکشی متفاوت است. برای یک برنامه واکشی ماهانه، [روز از ماه][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 | فایل از [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] پیکربندی شده واکشی شده است. |
GOOGLE_SHEETS | فایل از Google Sheets مشخص شده در [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] واکشی شده است. |
GetDataSourceRequest
درخواست پیام برای متد GetDataSource.
زمینه های | |
---|---|
name | ضروری. نام منبع داده برای بازیابی. قالب: |
ListDataSourcesRequest
درخواست پیام برای متد ListDataSources.
زمینه های | |
---|---|
parent | ضروری. حسابی برای فهرست کردن منابع داده. قالب: |
page_size | اختیاری. حداکثر تعداد منابع داده برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 تبدیل می شوند. اگر مشخص نباشد، حداکثر تعداد منابع داده برگردانده می شود. |
page_token | اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به |
ListDataSourcesResponse
پیام پاسخ برای متد ListDataSources.
زمینه های | |
---|---|
data_sources[] | منابع داده از حساب مشخص شده |
next_page_token | یک نشانه، که می تواند به عنوان |
LocalInventoryDataSource
منبع داده موجودی محلی
زمینه های | |
---|---|
feed_label | ضروری. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی محلی به آنها ارائه می شود. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. |
content_language | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی محلی به آنها ارائه می شود. |
PrimaryProductDataSource
منبع داده اولیه برای محصولات محلی و آنلاین.
زمینه های | |
---|---|
channel | ضروری. تغییرناپذیر. نوع کانال منبع داده را مشخص می کند. |
countries[] | اختیاری. کشورهایی که ممکن است موارد نمایش داده شوند. به عنوان کد قلمرو CLDR نشان داده شده است. |
feed_label | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
content_language | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
کانال
کانال منبع داده.
کانال برای تمایز بین منابع داده برای عمودهای مختلف محصول استفاده می شود.
Enums | |
---|---|
CHANNEL_UNSPECIFIED | مشخص نشده است. |
ONLINE_PRODUCTS | محصول آنلاین. |
LOCAL_PRODUCTS | محصول محلی |
PRODUCTS | منبع داده یکپارچه برای محصولات محلی و آنلاین. |
PromotionData Source
منبع داده های تبلیغاتی
زمینه های | |
---|---|
target_country | ضروری. تغییرناپذیر. کشور هدف که به عنوان بخشی از شناسه منحصر به فرد استفاده می شود. به عنوان کد قلمرو CLDR نشان داده شده است. تبلیغات فقط در کشورهای منتخب موجود است. |
content_language | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. |
RegionalInventoryDataSource
منبع داده های موجودی منطقه ای
زمینه های | |
---|---|
feed_label | ضروری. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی منطقه ای به آنها ارائه می شود. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. |
content_language | ضروری. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی منطقه ای به آنها ارائه می شود. |
منبع داده های تکمیلی محصول
منبع داده تکمیلی برای محصولات محلی و آنلاین.
زمینه های | |
---|---|
feed_label | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
content_language | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
UpdateDataSourceRequest
درخواست پیام برای متد UpdateDataSource.
زمینه های | |
---|---|
data_source | ضروری. منبع منبع داده برای به روز رسانی. |
update_mask | ضروری. لیست فیلدهای منبع داده که باید به روز شوند. فیلدهای مشخص شده در ماسک به روز رسانی بدون مقدار مشخص شده در بدنه از منبع داده حذف خواهند شد. ارائه مقدار "*" ویژه برای جایگزینی کامل منبع داده پشتیبانی نمی شود. |