Package google.shopping.merchant.datasources.v1beta

فهرست مطالب

DataSourcesService

خدماتی برای مدیریت منابع داده اولیه، تکمیلی، موجودی و سایر منابع. در مقاله راهنمای Merchant Center بیشتر ببینید.

CreateDataSource

rpc CreateDataSource( CreateDataSourceRequest ) returns ( DataSource )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

DeleteDataSource

rpc DeleteDataSource( DeleteDataSourceRequest ) returns ( Empty )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

FetchDataSource

rpc FetchDataSource( FetchDataSourceRequest ) returns ( Empty )

واکشی داده را فوراً (حتی برنامه واکشی خارج از برنامه) در یک منبع داده از حساب Merchant Center شما انجام می دهد. اگر نیاز دارید بیش از یک بار در روز با این روش تماس بگیرید، باید از سرویس محصولات برای به‌روزرسانی اطلاعات محصول خود استفاده کنید. این روش فقط روی منابع داده با مجموعه ورودی فایل کار می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

GetDataSource

rpc GetDataSource( GetDataSourceRequest ) returns ( DataSource )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ListDataSources

rpc ListDataSources( ListDataSourcesRequest ) returns ( ListDataSourcesResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

UpdateDataSource

rpc UpdateDataSource( UpdateDataSourceRequest ) returns ( DataSource )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

CreateDataSourceRequest

درخواست پیام برای متد CreateDataSource.

زمینه های
parent

string

ضروری. حسابی که این منبع داده در آن ایجاد خواهد شد. قالب: accounts/{account}

data_source

DataSource

ضروری. منبع داده برای ایجاد

منبع اطلاعات

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

زمینه های
name

string

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

data_source_id

int64

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

display_name

string

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

input

Input

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

file_input

FileInput

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

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

PrimaryProductDataSource

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

supplemental_product_data_source

SupplementalProductDataSource

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

local_inventory_data_source

LocalInventoryDataSource

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

regional_inventory_data_source

RegionalInventoryDataSource

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

promotion_data_source

PromotionDataSource

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

ورودی

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

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

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

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

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

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

DeleteDataSourceRequest

درخواست پیام برای متد DeleteDataSource.

زمینه های
name

string

ضروری. نام منبع داده برای حذف. قالب: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

درخواست پیام برای متد FetchDataSource.

زمینه های
name

string

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

ورودی فایل

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

زمینه های
fetch_settings

FetchSettings

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

file_name

string

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

file_input_type

FileInputType

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

FetchSettings

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

زمینه های
enabled

bool

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

day_of_month

int32

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

time_of_day

TimeOfDay

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

day_of_week

DayOfWeek

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

time_zone

string

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

frequency

Frequency

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

fetch_uri

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 استفاده می شود.

فرکانس

فیلدهای مورد نیاز بر اساس تعداد دفعات واکشی متفاوت است. برای یک برنامه واکشی ماهانه، [روز از ماه][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

string

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

ListDataSourcesRequest

درخواست پیام برای متد ListDataSources.

زمینه های
parent

string

ضروری. حسابی برای فهرست کردن منابع داده. قالب: accounts/{account}

page_size

int32

اختیاری. حداکثر تعداد منابع داده برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 تبدیل می شوند. اگر مشخص نباشد، حداکثر تعداد منابع داده برگردانده می شود.

page_token

string

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

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListDataSources باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListDataSourcesResponse

پیام پاسخ برای متد ListDataSources.

زمینه های
data_sources[]

DataSource

منابع داده از حساب مشخص شده

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

LocalInventoryDataSource

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

زمینه های
feed_label

string

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

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

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

content_language

string

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

PrimaryProductDataSource

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

زمینه های
channel

Channel

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

countries[]

string

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

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 منبع داده یکپارچه برای محصولات محلی و آنلاین.

PromotionData Source

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

زمینه های
target_country

string

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

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

content_language

string

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

RegionalInventoryDataSource

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

زمینه های
feed_label

string

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

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

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

content_language

string

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

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

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

زمینه های
feed_label

string

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

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

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

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

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

content_language

string

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

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

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

UpdateDataSourceRequest

درخواست پیام برای متد UpdateDataSource.

زمینه های
data_source

DataSource

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

update_mask

FieldMask

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

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

ارائه مقدار "*" ویژه برای جایگزینی کامل منبع داده پشتیبانی نمی شود.