Package google.shopping.css.v1

شاخص

AccountLabelsService

برچسب‌های حساب‌های Merchant Center و CSS را مدیریت می‌کند.

CreateAccountLabel

rpc CreateAccountLabel( CreateAccountLabelRequest ) returns ( AccountLabel )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

DeleteAccountLabel

rpc DeleteAccountLabel( DeleteAccountLabelRequest ) returns ( Empty )

یک برچسب را حذف می کند و آن را از تمام حساب هایی که به آن اختصاص داده شده است حذف می کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ListAccountLabels

rpc ListAccountLabels( ListAccountLabelsRequest ) returns ( ListAccountLabelsResponse )

برچسب‌های متعلق به یک حساب را فهرست می‌کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

UpdateAccountLabel

rpc UpdateAccountLabel( UpdateAccountLabelRequest ) returns ( AccountLabel )

یک برچسب را به روز می کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

خدمات حسابداری

سرویس برای مدیریت اطلاعات حساب CSS/MC.

GetAccount

rpc GetAccount( GetAccountRequest ) returns ( Account )

یک حساب CSS/MC را با شناسه بازیابی می کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ListChildAccounts

rpc ListChildAccounts( ListChildAccountsRequest ) returns ( ListChildAccountsResponse )

همه حساب‌ها را تحت شناسه حساب CSS مشخص شده فهرست می‌کند و به صورت اختیاری بر اساس شناسه برچسب و نام حساب فیلتر می‌کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

UpdateLabels

rpc UpdateLabels( UpdateAccountLabelsRequest ) returns ( Account )

برچسب های اختصاص داده شده به حساب های CSS/MC توسط یک دامنه CSS را به روز می کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

CssProductInputsService

سرویس برای استفاده از منبع CssProductInput. این سرویس به درج/به‌روزرسانی/حذف محصولات CSS کمک می‌کند.

DeleteCssProductInput

rpc DeleteCssProductInput( DeleteCssProductInputRequest ) returns ( Empty )

ورودی محصول CSS را از حساب مرکز CSS شما حذف می کند.

پس از حذف ممکن است چند دقیقه طول بکشد تا ورودی دیگر در دسترس نباشد.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

InsertCssProductInput

rpc InsertCssProductInput( InsertCssProductInputRequest ) returns ( CssProductInput )

یک CssProductInput را در حساب مرکز CSS شما آپلود می کند. اگر ورودی با همان ContentLanguage، هویت، feedLabel و feedId از قبل وجود داشته باشد، این روش جایگزین آن ورودی می شود.

پس از درج، به‌روزرسانی یا حذف ورودی محصول CSS، ممکن است چند دقیقه طول بکشد تا محصول CSS پردازش شده بازیابی شود.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

UpdateCssProductInput

rpc UpdateCssProductInput( UpdateCssProductInputRequest ) returns ( CssProductInput )

ورودی محصول Css موجود در حساب CSS Center شما را به روز می کند.

پس از درج، به‌روزرسانی یا حذف ورودی محصول CSS، ممکن است چند دقیقه طول بکشد تا محصول Css پردازش شده بازیابی شود.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

CssProductsService

خدماتی برای دریافت و فهرست کردن در محصولات Css (معروف به پیشنهادات مجموع داخلی).

GetCssProduct

rpc GetCssProduct( GetCssProductRequest ) returns ( CssProduct )

محصول CSS پردازش شده را از حساب مرکز CSS شما بازیابی می کند. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول نهایی به‌روز شده بازیابی شود.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ListCssProducts

rpc ListCssProducts( ListCssProductsRequest ) returns ( ListCssProductsResponse )

محصولات CSS پردازش شده را در حساب مرکز CSS شما فهرست می کند. پاسخ ممکن است حاوی موارد کمتری نسبت به اندازه صفحه باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید.

پس از درج، به‌روزرسانی یا حذف ورودی محصول CSS، ممکن است چند دقیقه طول بکشد تا محصول CSS پردازش شده به‌روز شده بازیابی شود.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

QuotaService

سرویس برای دریافت اطلاعات سهمیه فراخوانی روش به ازای روش CSS API.

ListQuotaGroups

rpc ListQuotaGroups( ListQuotaGroupsRequest ) returns ( ListQuotaGroupsResponse )

سهمیه تماس روزانه و استفاده در هر گروه را برای حساب CSS Center شما فهرست می کند.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

حساب

اطلاعاتی درباره حساب CSS/MC.

فیلدها
name

string

نام منبع برچسب قالب: حساب‌ها/{حساب}

full_name

string

فقط خروجی تغییرناپذیر. نام کامل حساب CSS/MC.

label_ids[]

int64

شناسه‌های برچسب به صورت دستی ایجاد شده است که توسط یک حساب والدین CSS به حساب CSS/MC اختصاص داده شده است.

automatic_label_ids[]

int64

شناسه‌های برچسب به‌طور خودکار ایجاد شده است که توسط مرکز CSS به حساب MC اختصاص داده شده است.

account_type

AccountType

فقط خروجی نوع این حساب

display_name

string

نام نمایشی کوتاه حساب CSS/MC.

homepage_uri

string

فقط خروجی تغییرناپذیر. صفحه اصلی حساب CSS/MC.

parent

string

منبع والد حساب CSS/MC. گروه CSS برای دامنه های CSS. دامنه CSS برای حساب های MC. فقط در صورتی برگردانده می شود که کاربر به حساب والد دسترسی داشته باشد. توجه: برای حساب‌های فرعی MC، این نیز دامنه CSS است که منبع اصلی حساب MCA است، زیرا ما به طور موثر سلسله مراتب را صاف می‌کنیم."

نوع حساب

نوع حساب

Enums
ACCOUNT_TYPE_UNSPECIFIED نوع حساب نامشخص
CSS_GROUP حساب گروه CSS.
CSS_DOMAIN حساب دامنه CSS.
MC_PRIMARY_CSS_MCA حساب MCA CSS اولیه MC.
MC_CSS_MCA حساب MCA MC CSS.
MC_MARKETPLACE_MCA حساب MCA MC Marketplace.
MC_OTHER_MCA MC سایر حساب های MCA.
MC_STANDALONE حساب مستقل MC.
MC_MCA_SUBACCOUNT حساب فرعی MC MCA.

AccountLabel

برچسبی که دامنه CSS یا گروه CSS به یکی از حساب‌های فرعی آن اختصاص داده است.

فیلدها
name

string

شناسه. نام منبع برچسب. قالب: حساب‌ها/{account}/labels/{label}

label_id

int64

فقط خروجی شناسه برچسب

account_id

int64

فقط خروجی شناسه حسابی که این برچسب به آن تعلق دارد.

label_type

LabelType

فقط خروجی نوع این برچسب.

display_name

string

نام نمایشی این برچسب.

description

string

توضیحات این برچسب

نوع برچسب

نوع برچسب

Enums
LABEL_TYPE_UNSPECIFIED نوع برچسب نامشخص
MANUAL نشان می دهد که برچسب به صورت دستی ایجاد شده است.
AUTOMATIC نشان می دهد که برچسب به طور خودکار توسط مرکز CSS ایجاد شده است.

صفات

ویژگی های محصول CSS.

فیلدها
low_price

Price

قیمت پایین محصول CSS.

high_price

Price

قیمت بالای محصول CSS.

headline_offer_price

Price

قیمت سرفصل محصول CSS.

headline_offer_shipping_price

Price

قیمت سرفصل محصول CSS.

product_types[]

string

دسته بندی های مورد (قالب بندی شده مانند مشخصات داده های محصولات ).

size_types[]

string

برش مورد. می توان از آن برای نشان دادن انواع اندازه های ترکیبی برای اقلام پوشاک استفاده کرد. حداکثر دو نوع اندازه قابل ارائه است (به [https://support.google.com/merchants/answer/6324497](نوع اندازه) مراجعه کنید).

product_details[]

ProductDetail

مشخصات فنی یا جزئیات اضافی محصول.

product_weight

ProductWeight

وزن محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 2000 (شامل) باشد.

product_length

ProductDimension

طول محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.

product_width

ProductDimension

عرض محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.

product_height

ProductDimension

ارتفاع محصول در واحدهای ارائه شده مقدار باید بین 0 (انحصاری) و 3000 (شامل) باشد.

product_highlights[]

string

نقاط گلوله ای که مرتبط ترین نکات برجسته یک محصول را توصیف می کند.

certifications[]

Certification

فهرستی از گواهی‌های ادعا شده توسط CSS برای محصول داده شده.

expiration_date

Timestamp

تاریخی که در آن آیتم باید منقضی شود، همانطور که در هنگام درج مشخص شده است، در قالب ISO 8601 . تاریخ انقضای واقعی در productstatuses به عنوان googleExpirationDate نشان داده می شود و اگر expirationDate در آینده خیلی دور باشد، ممکن است زودتر باشد. توجه: ممکن است 2+ روز از تاریخ انقضا طول بکشد تا مورد واقعاً حذف شود.

included_destinations[]

string

فهرست مقصدهایی که باید برای این هدف درج شود (مطابق با کادرهای انتخاب شده در Merchant Center) است. مقاصد پیش‌فرض همیشه گنجانده می‌شوند مگر اینکه در excludedDestinations ارائه شده باشند.

excluded_destinations[]

string

فهرست مقاصدی که باید برای این هدف حذف شوند (مطابق با کادرهای انتخاب نشده در Merchant Center است).

headline_offer_installment

HeadlineOfferInstallment

تعداد و مبلغ اقساط برای پرداخت یک کالا.

headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

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

cpp_ads_redirect

string

به تبلیغ‌کنندگان اجازه می‌دهد تا زمانی که محصول در چارچوب تبلیغات محصول نشان داده می‌شود، نشانی وب مورد را لغو کنند.

number_of_offers

int64

تعداد محصولات CSS.

headline_offer_condition

string

شرایط پیشنهاد سرفصل.

title

string

عنوان مورد.

description

string

توضیحات مورد.

brand

string

ویژگی های مرتبط با محصول. [14-36] نام تجاری مورد.

mpn

string

شماره قطعه سازنده ( MPN ) مورد.

gtin

string

شماره کالای تجاری جهانی ( GTIN ) مورد.

google_product_category

string

دسته بندی مورد توسط Google (به طبقه بندی محصولات Google مراجعه کنید). هنگام پرس و جو از محصولات، این فیلد حاوی مقدار ارائه شده توسط کاربر خواهد بود. در حال حاضر هیچ راهی برای بازگرداندن دسته‌های محصولات Google اختصاص داده شده خودکار از طریق API وجود ندارد.

adult

bool

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

multipack

int64

تعداد محصولات یکسان در یک بسته چندگانه تعریف شده توسط فروشنده.

is_bundle

bool

اینکه آیا مورد بسته‌ای تعریف‌شده توسط تاجر است. باندل یک گروه بندی سفارشی از محصولات مختلف است که توسط یک تاجر به قیمت واحد فروخته می شود.

age_group

string

گروه سنی مورد نظر

color

string

رنگ مورد.

gender

string

جنسیت مورد نظر

material

string

ماده ای که مورد از آن ساخته شده است.

pattern

string

الگوی مورد (به عنوان مثال نقطه پولکا).

size

string

اندازه مورد. فقط یک مقدار مجاز است. برای انواع با اندازه‌های مختلف، یک محصول جداگانه برای هر اندازه با مقدار itemGroupId یکسان درج کنید (به [https://support.google.com/merchants/answer/6324492](تعریف اندازه) مراجعه کنید).

size_system

string

سیستمی که در آن اندازه مشخص شده است. برای اقلام پوشاک توصیه می شود.

item_group_id

string

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

pause

string

انتشار این مورد موقتاً متوقف خواهد شد.

custom_label_0

string

برچسب سفارشی 0 برای گروه بندی سفارشی اقلام در کمپین خرید.

custom_label_1

string

برچسب سفارشی 1 برای گروه بندی سفارشی اقلام در کمپین خرید.

custom_label_2

string

برچسب سفارشی 2 برای گروه بندی سفارشی اقلام در کمپین خرید.

custom_label_3

string

برچسب سفارشی 3 برای گروه بندی سفارشی اقلام در کمپین خرید.

custom_label_4

string

برچسب سفارشی 4 برای گروه بندی سفارشی اقلام در کمپین خرید.

گواهینامه

گواهینامه برای محصول از این ویژگی برای توصیف گواهینامه‌ها، مانند رتبه‌بندی‌های بهره‌وری انرژی، مرتبط با یک محصول استفاده کنید.

فیلدها
name

string

نام گواهینامه. در این زمان، رایج ترین مقدار "EPREL" است که نشان دهنده گواهینامه های بهره وری انرژی در پایگاه داده اتحادیه اروپا ثبت اروپایی برای برچسب گذاری انرژی (EPREL) است.

authority

string

مرجع یا مرجع صدور گواهینامه مسئول صدور گواهینامه. در این زمان، رایج‌ترین مقدار «EC» یا «European_Commission» برای برچسب‌های انرژی در اتحادیه اروپا است.

code

string

کد گواهینامه به عنوان مثال، برای گواهی EPREL با لینک https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 کد 123456 است. کد برای برچسب های انرژی اروپا مورد نیاز است.

CreateAccountLabelRequest

درخواست پیام برای روش "CreateAccountLanel".

فیلدها
parent

string

مورد نیاز. حساب والد. قالب: حساب‌ها/{حساب}

account_label

AccountLabel

مورد نیاز. برچسب برای ایجاد.

CssProduct

محصول CSS پردازش شده

فیلدها
name

string

نام محصول CSS. قالب: "accounts/{account}/cssProducts/{css_product}"

raw_provided_id

string

فقط خروجی شناسه خام منحصر به فرد شما برای محصول.

content_language

string

فقط خروجی کد زبان دو حرفی ISO 639-1 برای محصول.

feed_label

string

فقط خروجی برچسب خوراک برای محصول

attributes

Attributes

فقط خروجی لیستی از ویژگی های محصول

custom_attributes[]

CustomAttribute

فقط خروجی لیستی از ویژگی های سفارشی (ارائه شده توسط CSS). همچنین می توان از آن برای ارسال هر ویژگی از مشخصات فید به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به‌صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است.

css_product_status

CssProductStatus

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

CssProductInput

این منبع داده‌های ورودی را نشان می‌دهد که برای یک محصول CSS ارسال می‌کنید، نه محصول CSS پردازش‌شده‌ای که در مرکز CSS، در تبلیغات خرید یا در سطوح Google می‌بینید.

فیلدها
name

string

شناسه. نام ورودی محصول CSS. قالب: accounts/{account}/cssProductInputs/{css_product_input} ، که در آن آخرین بخش css_product_input از 3 بخش تشکیل شده است: contentLanguage~feedLabel~offerId. مثال: accounts/123/cssProductInputs/de~DE~rawProvidedId123

final_name

string

فقط خروجی نام محصول CSS پردازش شده. قالب: accounts/{account}/cssProducts/{css_product}

raw_provided_id

string

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

content_language

string

مورد نیاز. کد زبان دو حرفی ISO 639-1 برای محصول CSS.

feed_label

string

مورد نیاز. برچسب خوراک برای محصول CSS. برچسب فید مترادف با "کشور هدف" است و بنابراین همیشه باید یک کد منطقه معتبر باشد. به عنوان مثال: 'DE' برای آلمان، 'FR' برای فرانسه.

freshness_time
(deprecated)

Timestamp

منسوخ شده به جای آن از expiration_date استفاده کنید. نشان دهنده نسخه موجود (تازه بودن) محصول CSS است که می تواند برای حفظ نظم درست زمانی که چندین به روز رسانی به طور همزمان انجام می شود استفاده شود.

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

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

اگر تنظیم نشود، از به‌روزرسانی جلوگیری نمی‌شود و آخرین زمان به‌روزرسانی به‌طور پیش‌فرض زمانی است که این درخواست توسط CSS API دریافت شده است.

اگر از عمل جلوگیری شود، استثناء سقط شده پرتاب می شود.

attributes

Attributes

لیستی از ویژگی های محصول CSS.

custom_attributes[]

CustomAttribute

لیستی از ویژگی های سفارشی (ارائه شده توسط CSS). همچنین می توان از آن برای ارسال هر ویژگی از مشخصات فید به شکل عمومی آن استفاده کرد (به عنوان مثال: { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به‌صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در Google مفید است.

CssProductStatus

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

فیلدها
destination_statuses[]

DestinationStatus

مقاصد مورد نظر برای محصول

item_level_issues[]

ItemLevelIssue

لیستی از تمام مشکلات مرتبط با محصول.

creation_date

Timestamp

تاریخ ایجاد آیتم در قالب ISO 8601 .

last_update_date

Timestamp

تاریخ آخرین به روز رسانی مورد در قالب ISO 8601 .

google_expiration_date

Timestamp

تاریخ انقضای کالا در قالب ISO 8601 .

وضعیت مقصد

وضعیت مقصد وضعیت محصول.

فیلدها
destination

string

نام مقصد

approved_countries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که محصول CSS در آنها تأیید شده است.

pending_countries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) که محصول CSS در انتظار تأیید است.

disapproved_countries[]

string

فهرست کدهای کشوری (ISO 3166-1 alpha-2) که در آن محصول CSS تایید نشده است.

ItemLevelIssue

ItemLevelIssue وضعیت محصول.

فیلدها
code

string

کد خطای مشکل

servability

string

این موضوع چگونه بر ارائه محصول CSS تأثیر می گذارد.

resolution

string

اینکه آیا این موضوع توسط تاجر قابل حل است یا خیر.

attribute

string

نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.

destination

string

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

description

string

شرح مختصر موضوع به زبان انگلیسی.

detail

string

شرح مفصل موضوع به زبان انگلیسی.

documentation

string

URL یک صفحه وب برای کمک به حل این مشکل.

applicable_countries[]

string

فهرست کدهای کشور (ISO 3166-1 alpha-2) که در آن مشکل برای محصول CSS اعمال می شود.

DeleteAccountLabelRequest

درخواست پیام برای روش "DeleteAccountLabel".

فیلدها
name

string

مورد نیاز. نام برچسبی که باید حذف شود. قالب: حساب‌ها/{account}/labels/{label}

DeleteCssProductInputRequest

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

فیلدها
name

string

مورد نیاز. نام منبع ورودی محصول CSS برای حذف. قالب: accounts/{account}/cssProductInputs/{css_product_input}، که در آن آخرین بخش css_product_input از 3 بخش تشکیل شده است: contentLanguage~feedLabel~offerId. مثال: accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

شناسه فید تکمیلی Content API. اگر این عمل برای یک فید اصلی اعمال شود، فیلد نباید تنظیم شود. اگر فیلد تنظیم شده باشد، عملکرد محصول به جای فید Content API اولیه، برای فید تکمیلی اعمال می‌شود.

GetAccountRequest

پیام درخواست متد GetAccount .

فیلدها
name

string

مورد نیاز. نام حساب مدیریت شده CSS/MC. قالب: حساب‌ها/{حساب}

parent

string

اختیاری. فقط هنگام بازیابی اطلاعات حساب MC مورد نیاز است. دامنه CSS که منبع والد حساب MC است. قالب: حساب‌ها/{حساب}

GetCssProductRequest

پیام درخواست متد GetCssProduct .

فیلدها
name

string

مورد نیاز. نام محصول CSS برای بازیابی.

عنوان پیشنهاد قسط

پیامی که نشان دهنده قسط است.

فیلدها
months

int64

تعداد اقساطی که خریدار باید بپردازد.

amount

Price

مبلغی که خریدار باید در ماه پرداخت کند.

downpayment

Price

مبلغ پیش پرداختی که خریدار باید بپردازد.

HeadlineOfferSubscriptionCost

هزینه اشتراک محصول

فیلدها
period

SubscriptionPeriod

نوع دوره اشتراک. مقادیر پشتیبانی شده عبارتند از: * " month " * " year "

period_length

int64

تعداد دوره های اشتراکی که خریدار باید بپردازد.

amount

Price

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

InsertCssProductInputRequest

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

فیلدها
parent

string

مورد نیاز. حسابی که این محصول CSS در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

css_product_input

CssProductInput

مورد نیاز. ورودی محصول CSS برای درج.

feed_id
(deprecated)

int64

اختیاری. منسوخ شده شناسه فید برای محصولات CSS مورد نیاز نیست. شناسه خوراک اولیه یا تکمیلی. اگر محصول CSS از قبل وجود داشته باشد و شناسه فید ارائه شده متفاوت باشد، محصول CSS به یک فید جدید منتقل می شود. توجه: در حال حاضر، CSS ها نیازی به ارائه شناسه فید ندارند، زیرا ما در حال ساخت فیدها هستیم. ما هنوز پشتیبانی فید تکمیلی برای محصولات CSS نداریم.

ListAccountLabelsRequest

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

فیلدها
parent

string

مورد نیاز. حساب والد. قالب: حساب‌ها/{حساب}

page_size

int32

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

page_token

string

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

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

ListAccountLabelsResponse

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

فیلدها
account_labels[]

AccountLabel

برچسب ها از حساب مشخص شده.

next_page_token

string

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

ListChildAccountsRequest

پیام درخواست متد ListChildAccounts .

فیلدها
parent

string

مورد نیاز. حساب والد. باید یک گروه یا دامنه CSS باشد. قالب: حساب‌ها/{حساب}

page_size

int32

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

page_token

string

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

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

label_id

int64

در صورت تنظیم، فقط حساب‌های MC با شناسه برچسب داده شده برگردانده می‌شوند.

full_name

string

در صورت تنظیم، فقط حساب‌های MC با نام داده شده (حساس به حروف کوچک) بازگردانده می‌شوند.

ListChildAccountsResponse

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

فیلدها
accounts[]

Account

حساب‌های CSS/MC برای حساب اصلی CSS مشخص شده بازگردانده شده‌اند.

next_page_token

string

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

ListCssProductsRequest

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

فیلدها
parent

string

مورد نیاز. حساب/دامنه برای فهرست کردن محصولات CSS پردازش شده. قالب: حساب‌ها/{حساب}

page_size

int32

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

page_token

string

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

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

ListCssProductsResponse

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

فیلدها
css_products[]

CssProduct

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

next_page_token

string

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

ListQuotaGroupsRequest

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

فیلدها
parent

string

مورد نیاز. حساب CSS که مجموعه ای از سهمیه ها و منابع متد را در اختیار دارد. در بیشتر موارد، این دامنه CSS است. قالب: حساب‌ها/{حساب}

page_size

int32

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

page_token

string

اختیاری. رمز (در صورت ارائه) برای بازیابی صفحه بعدی. همه پارامترهای دیگر باید با فراخوانی اصلی که توکن صفحه را ارائه کرده است، مطابقت داشته باشند.

ListQuotaGroupsResponse

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

فیلدها
quota_groups[]

QuotaGroup

روش‌ها، استفاده از سهمیه فعلی و محدودیت‌های هر گروه. سهمیه بین همه روش های گروه به اشتراک گذاشته می شود. گروه ها بر اساس quota_usage به ترتیب نزولی مرتب شده اند.

next_page_token

string

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

جزئیات روش

جزئیات روش در هر روش در CSS API.

فیلدها
method

string

فقط خروجی نام روش برای مثال cssproductsservice.listcssproducts .

version

string

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

subapi

string

فقط خروجی API فرعی که متد به آن تعلق دارد. در CSS API، این همیشه css است.

path

string

فقط خروجی مسیر برای روشی مانند v1/cssproductsservice.listcssproducts .

جزئیات محصول

جزئیات محصول

فیلدها
section_name

string

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

attribute_name

string

نام جزئیات محصول.

attribute_value

string

ارزش جزئیات محصول

ابعاد محصول

ابعاد محصول.

فیلدها
value

double

مورد نیاز. مقدار بعد به عنوان یک عدد نشان داده می شود. مقدار می تواند حداکثر دقت چهار رقم اعشار داشته باشد.

unit

string

مورد نیاز. واحدهای بعد مقادیر قابل قبول عبارتند از: * " in " * " cm "

وزن محصول

وزن محصول.

فیلدها
value

double

مورد نیاز. وزن به عنوان یک عدد نشان داده شده است. وزن می تواند حداکثر دقت چهار رقم اعشار را داشته باشد.

unit

string

مورد نیاز. واحد وزن مقادیر قابل قبول عبارتند از: * " g " * " kg " * " oz " * " lb "

QuotaGroup

اطلاعات گروه برای متدها در CSS API. سهمیه بین همه روش های گروه به اشتراک گذاشته می شود. حتی اگر هیچ یک از متدهای درون گروه کاربرد نداشته باشد، اطلاعات گروه برگردانده می شود.

فیلدها
name

string

شناسه. نام منبع گروه سهمیه. قالب: accounts/{account}/quotas/{group} مثال: accounts/12345678/quotas/css-products-insert توجه: بخش {group} تضمینی برای پیروی از یک الگوی خاص نیست.

quota_usage

int64

فقط خروجی استفاده از سهمیه فعلی، به معنای تعداد تماس‌هایی است که قبلاً در یک روز معین با روش‌های موجود در گروه برقرار شده است. محدودیت های سهمیه روزانه در ساعت 12:00 ظهر UTC بازنشانی می شود.

quota_limit

int64

فقط خروجی حداکثر تعداد تماس مجاز در روز برای گروه.

quota_minute_limit

int64

فقط خروجی حداکثر تعداد تماس های مجاز در دقیقه برای گروه.

method_details[]

MethodDetails

فقط خروجی فهرست همه روش‌ها سهمیه گروه اعمال می‌شود.

دوره اشتراک

مدت زمان اشتراک محصول.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED نشان می دهد که دوره اشتراک نامشخص است.
MONTH نشان می دهد که دوره اشتراک یک ماه است.
YEAR نشان می دهد که دوره اشتراک سال است.

UpdateAccountLabelRequest

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

فیلدها
account_label

AccountLabel

مورد نیاز. برچسب به روز شده همه فیلدها باید ارائه شوند.

UpdateAccountLabelsRequest

پیام درخواست متد UpdateLabels .

فیلدها
name

string

مورد نیاز. نام منبع برچسب قالب: حساب‌ها/{حساب}

label_ids[]

int64

لیست شناسه های برچسب برای بازنویسی شناسه های برچسب حساب موجود. اگر لیست خالی باشد، همه شناسه‌های برچسب اختصاص داده شده در حال حاضر حذف خواهند شد.

parent

string

اختیاری. فقط هنگام به‌روزرسانی برچسب‌های حساب MC مورد نیاز است. دامنه CSS که منبع والد حساب MC است. قالب: حساب‌ها/{حساب}

UpdateCssProductInputRequest

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

فیلدها
css_product_input

CssProductInput

مورد نیاز. منبع ورودی محصول CSS برای به روز رسانی. اطلاعاتی که ارسال می کنید برای محصول CSS پردازش شده نیز اعمال می شود.

update_mask

FieldMask

لیست ویژگی های محصول CSS که باید به روز شود.

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

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

ماسک به‌روزرسانی را فقط می‌توان برای فیلدهای سطح بالا در ویژگی‌ها و ویژگی‌های سفارشی مشخص کرد.

برای تعیین ماسک به‌روزرسانی برای ویژگی‌های سفارشی، باید custom_attribute. پیشوند

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