شاخص
-
DataSourcesService
(رابط) -
FileUploadsService
(رابط) -
CreateDataSourceRequest
(پیام) -
DataSource
(پیام) -
DataSource.Input
(enum) -
DataSourceReference
(پیام) -
DeleteDataSourceRequest
(پیام) -
FetchDataSourceRequest
(پیام) -
FileInput
(پیام) -
FileInput.FetchSettings
(پیام) -
FileInput.FetchSettings.Frequency
(enum) -
FileInput.FileInputType
(enum) -
FileUpload
(پیام) -
FileUpload.Issue
(پیام) -
FileUpload.Issue.Severity
(تعدادی) -
FileUpload.ProcessingState
(enum) -
GetDataSourceRequest
(پیام) -
GetFileUploadRequest
(پیام) -
ListDataSourcesRequest
(پیام) -
ListDataSourcesResponse
(پیام) -
LocalInventoryDataSource
(پیام) -
PrimaryProductDataSource
(پیام) -
PrimaryProductDataSource.Channel
(عدد) -
PrimaryProductDataSource.DefaultRule
(پیام) -
PromotionDataSource
(پیام) -
RegionalInventoryDataSource
(پیام) -
SupplementalProductDataSource
(پیام) -
UpdateDataSourceRequest
(پیام)
DataSourcesService
خدماتی برای مدیریت منابع داده اولیه، تکمیلی، موجودی و سایر منابع. در مقاله راهنمای Merchant Center بیشتر ببینید.
CreateDataSource |
---|
پیکربندی منبع داده جدید را برای حساب داده شده ایجاد می کند.
|
DeleteDataSource |
---|
یک منبع داده را از حساب Merchant Center شما حذف می کند.
|
FetchDataSource |
---|
واکشی داده را فوراً (حتی برنامه واکشی خارج از برنامه) در یک منبع داده از حساب Merchant Center شما انجام می دهد. اگر نیاز دارید بیش از یک بار در روز با این روش تماس بگیرید، باید از سرویس محصولات برای بهروزرسانی اطلاعات محصول خود استفاده کنید. این روش فقط روی منابع داده با مجموعه ورودی فایل کار می کند.
|
GetDataSource |
---|
پیکربندی منبع داده را برای حساب داده شده بازیابی می کند.
|
ListDataSources |
---|
تنظیمات منابع داده را برای حساب داده شده فهرست می کند.
|
UpdateDataSource |
---|
پیکربندی منبع داده موجود را به روز می کند. فیلدهایی که در ماسک به روز رسانی تنظیم شده اند اما در منبع ارائه نشده اند حذف خواهند شد.
|
FileUploadsService
سرویس برای مدیریت بارگذاری فایل منبع داده.
GetFileUpload |
---|
آخرین آپلود فایل منبع داده را دریافت می کند. فقط
|
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 | این همچنین به عنوان فیدهای خودکار شناخته می شود که برای ساخت خودکار داده های محصول شما استفاده می شود. این نوع منبع داده را می توان از طریق بسته حساب ها فعال یا غیرفعال کرد. |
DataSourceReference
مرجع منبع داده می تواند برای مدیریت منابع داده مرتبط در سرویس منبع داده استفاده شود.
فیلدها | |
---|---|
فیلد اتحادیه | |
self | Self باید برای ارجاع به خود منبع داده اولیه استفاده شود. |
primary_data_source_name | اختیاری. نام منبع داده اولیه. قالب: |
supplemental_data_source_name | اختیاری. نام منبع داده تکمیلی. قالب: |
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 مشخص شده در [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] واکشی شده است. |
آپلود فایل
آپلود فایل یک منبع داده خاص، یعنی نتیجه بازیابی منبع داده در یک مُهر زمانی مشخص بهصورت ناهمزمان محاسبه میشود که پردازش منبع داده به پایان رسید. فقط برای منابع داده فایل قابل استفاده است.
فیلدها | |
---|---|
name | شناسه. نام آپلود فایل منبع داده. قالب: |
data_source_id | فقط خروجی شناسه منبع داده |
processing_state | فقط خروجی وضعیت پردازش منبع داده |
issues[] | فقط خروجی لیست مشکلاتی که در منبع داده رخ می دهد. |
items_total | فقط خروجی تعداد موارد موجود در منبع داده که پردازش شدند. |
items_created | فقط خروجی تعداد مواردی که در منبع داده ایجاد شده است. |
items_updated | فقط خروجی تعداد موارد موجود در منبع داده که بهروزرسانی شدند. |
upload_time | فقط خروجی تاریخی که در آن فایل منبع داده آپلود شده است. |
موضوع
خطایی در منبع داده رخ می دهد، مانند "قیمت نامعتبر".
فیلدها | |
---|---|
title | فقط خروجی عنوان شماره، به عنوان مثال، "مورد خیلی بزرگ است". |
description | فقط خروجی شرح خطا، به عنوان مثال، "منبع داده شما حاوی مواردی است که دارای ویژگی های بیش از حد هستند یا بسیار بزرگ هستند. این موارد حذف خواهند شد". |
code | فقط خروجی کد خطا، به عنوان مثال، "validation/invalid_value". "?" را برمی گرداند اگر کد ناشناخته باشد |
count | فقط خروجی تعداد بروز خطا در آپلود فایل. |
severity | فقط خروجی شدت موضوع. |
documentation_uri | فقط خروجی در صورت موجود بودن، به اسنادی پیوند دهید که مشکل را با جزئیات بیشتر توضیح می دهد. |
شدت
شدت موضوع.
Enums | |
---|---|
SEVERITY_UNSPECIFIED | شدت نامشخص |
WARNING | موضوع هشدار است. |
ERROR | موضوع یک خطا است. |
Processing State
وضعیت پردازش منبع داده
Enums | |
---|---|
PROCESSING_STATE_UNSPECIFIED | وضعیت پردازش نامشخص است. |
FAILED | منبع داده قابل پردازش نبود یا همه موارد دارای خطا بودند. |
IN_PROGRESS | منبع داده در حال پردازش است. |
SUCCEEDED | منبع داده با موفقیت پردازش شد، اگرچه برخی موارد ممکن است دارای خطا باشند. |
GetDataSourceRequest
درخواست پیام برای متد GetDataSource.
فیلدها | |
---|---|
name | مورد نیاز. نام منبع داده برای بازیابی. قالب: |
GetFileUploadRequest
درخواست پیام برای متد GetFileUploadRequest.
فیلدها | |
---|---|
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 نشان داده شده است. |
default_rule | اختیاری. مدیریت قانون پیش فرض منبع داده. در صورت تنظیم، منابع داده مرتبط جایگزین خواهند شد. |
feed_label | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
content_language | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
کانال
کانال منبع داده.
کانال برای تمایز بین منابع داده برای عمودهای مختلف محصول استفاده می شود.
Enums | |
---|---|
CHANNEL_UNSPECIFIED | مشخص نشده است. |
ONLINE_PRODUCTS | محصول آنلاین. |
LOCAL_PRODUCTS | محصول محلی |
PRODUCTS | منبع داده یکپارچه برای محصولات محلی و آنلاین. توجه: مدیریت محصولات از طریق API برای این کانال امکان پذیر نیست. |
DefaultRule
مدیریت قانون پیش فرض منبع داده.
فیلدها | |
---|---|
take_from_data_sources[] | مورد نیاز. فهرست منابع دادهای که در قانون پیشفرض پیوند داده شدهاند. این لیست بر اساس اولویت قانون پیش فرض برای پیوستن به داده ها مرتب شده است. این ممکن است شامل هیچ یا چندین ارجاع به منابع داده لیست نباید خالی باشد. برای پیوند دادن منبع داده به قانون پیش فرض، باید یک مرجع جدید به این لیست (به ترتیب متوالی) اضافه کنید. برای جدا کردن منبع داده از قانون پیش فرض، باید مرجع داده شده را از این لیست حذف کنید. تغییر ترتیب این لیست منجر به تغییر اولویت منابع داده در قانون پیش فرض می شود. به عنوان مثال، ارائه لیست زیر: [ |
PromotionData Source
منبع داده های تبلیغاتی
فیلدها | |
---|---|
target_country | مورد نیاز. تغییرناپذیر. کشور هدف که به عنوان بخشی از شناسه منحصر به فرد استفاده می شود. به عنوان کد قلمرو CLDR نشان داده شده است. تبلیغات فقط در کشورهای منتخب موجود است. |
content_language | مورد نیاز. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. |
RegionalInventoryDataSource
منبع داده های موجودی منطقه ای
فیلدها | |
---|---|
feed_label | مورد نیاز. تغییرناپذیر. برچسب خوراک پیشنهادهایی که موجودی منطقه ای به آنها ارائه می شود. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. |
content_language | مورد نیاز. تغییرناپذیر. زبان دو حرفی ISO 639-1 اقلامی که موجودی منطقه ای به آنها ارائه شده است. |
منبع داده های تکمیلی محصول
منبع داده تکمیلی برای محصولات محلی و آنلاین.
فیلدها | |
---|---|
referencing_primary_data_sources[] | فقط خروجی فهرست (نامرتب و بدون تکرار) همه منابع داده اولیه مرتبط با این منبع داده در قوانین پیشفرض یا سفارشی. منبع داده های تکمیلی را نمی توان قبل از حذف همه پیوندها حذف کرد. |
feed_label | اختیاری. تغییرناپذیر. برچسب فید که در سطح منبع داده مشخص شده است. باید کمتر یا مساوی 20 حرف بزرگ (AZ)، اعداد (0-9) و خط تیره (-) باشد. همچنین مهاجرت به برچسبهای خوراک را ببینید. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
content_language | اختیاری. تغییرناپذیر. زبان دو حرفی ISO 639-1 موارد موجود در منبع داده. در صورت تنظیم، منبع داده فقط محصولاتی را می پذیرد که با این ترکیب مطابقت داشته باشند. اگر تنظیم نشود، منبع داده محصولات را بدون آن محدودیت می پذیرد. |
UpdateDataSourceRequest
درخواست پیام برای متد UpdateDataSource.
فیلدها | |
---|---|
data_source | مورد نیاز. منبع منبع داده برای به روز رسانی. |
update_mask | مورد نیاز. لیست فیلدهای منبع داده که باید به روز شوند. فیلدهای مشخص شده در ماسک به روز رسانی بدون مقدار مشخص شده در بدنه از منبع داده حذف خواهند شد. ارائه مقدار "*" ویژه برای جایگزینی کامل منبع داده پشتیبانی نمی شود. |