ثبت نام اجباری توسعه‌دهنده برای الزامات API CSS تا ژوئن ۲۰۲۶. برای بهبود پایداری و امنیت API، ما یک ثبت نام اجباری و یک‌باره برای APIهای CSS معرفی می‌کنیم. اگر قبلاً این ثبت نام را برای پروژه‌های Google Cloud خود هنگام فعال کردن API Merchant انجام داده‌اید، نیازی به تکرار این مراحل نخواهید داشت. می‌توانید دستورالعمل‌های دقیق‌تر را در سایت توسعه‌دهنده API Merchant ما بیابید و در صورت نیاز به کمک بیشتر، تیم پشتیبانی API ما در دسترس است.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Package google.shopping.css.v1

فهرست

AccountLabelsService (رابط)
AccountsService (رابط کاربری)
رابط کاربری ( CssProductInputsService )
CssProductsService (رابط)
QuotaService (رابط)
Account (پیام)
Account.AccountType (شمارشی)
AccountLabel (پیام)
AccountLabel.LabelType (شمارشی)
Attributes (پیام)
Certification (پیام)
CreateAccountLabelRequest (پیام)
CssProduct (پیام)
CssProductInput (پیام)
CssProductStatus (پیام)
CssProductStatus.DestinationStatus (پیام)
مشکل سطح آیتم (پیام) CssProductStatus.ItemLevelIssue
DeleteAccountLabelRequest (پیام)
درخواست ورودی محصول (پیام) DeleteCssProductInputRequest
GetAccountRequest (پیام)
GetCssProductRequest (پیام)
HeadlineOfferInstallment (پیام)
HeadlineOfferSubscriptionCost (پیام)
درخواست ورودی محصول (پیام) InsertCssProductInputRequest
ListAccountLabelsRequest (پیام)
ListAccountLabelsResponse (پیام)
ListChildAccountsRequest (پیام)
ListChildAccountsResponse (پیام)
ListCssProductsRequest (پیام)
ListCssProductsResponse (پیام)
ListQuotaGroupsRequest (پیام)
ListQuotaGroupsResponse (پیام)
MethodDetails (پیام)
ProductDetail (پیام)
ProductDimension (پیام)
ProductWeight (پیام)
QuotaGroup (پیام)
SubscriptionPeriod (شمارشی)
UpdateAccountLabelRequest (پیام)
UpdateAccountLabelsRequest (پیام)
UpdateCssProductInputRequest (پیام)

سرویس برچسب‌های حساب

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

برچسب ایجاد حساب

برچسب ایجاد حساب
`rpc CreateAccountLabel( CreateAccountLabelRequest ) returns ( AccountLabel )` یک برچسب جدید ایجاد می‌کند که به هیچ حسابی اختصاص داده نشده است. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc CreateAccountLabel( CreateAccountLabelRequest ) returns ( AccountLabel )

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

دامنه‌های مجوز

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

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

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

برچسب حساب را حذف کنید

برچسب حساب را حذف کنید
`rpc DeleteAccountLabel( DeleteAccountLabelRequest ) returns ( Empty )` یک برچسب را حذف می‌کند و آن را از تمام حساب‌هایی که به آنها اختصاص داده شده است، حذف می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc DeleteAccountLabel( DeleteAccountLabelRequest ) returns ( Empty )

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

دامنه‌های مجوز

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

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

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

برچسب‌های حساب لیست

برچسب‌های حساب لیست
`rpc ListAccountLabels( ListAccountLabelsRequest ) returns ( ListAccountLabelsResponse )` برچسب‌های متعلق به یک حساب را فهرست می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc ListAccountLabels( ListAccountLabelsRequest ) returns ( ListAccountLabelsResponse )

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

دامنه‌های مجوز

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

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

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

برچسب حساب کاربری را به‌روزرسانی کنید

برچسب حساب کاربری را به‌روزرسانی کنید
`rpc UpdateAccountLabel( UpdateAccountLabelRequest ) returns ( AccountLabel )` یک برچسب را به‌روزرسانی می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc UpdateAccountLabel( UpdateAccountLabelRequest ) returns ( AccountLabel )

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

دامنه‌های مجوز

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

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

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

سرویس حساب‌ها

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

دریافت حساب کاربری

دریافت حساب کاربری
`rpc GetAccount( GetAccountRequest ) returns ( Account )` یک حساب CSS/MC واحد را بر اساس شناسه بازیابی می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc GetAccount( GetAccountRequest ) returns ( Account )

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

دامنه‌های مجوز

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

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

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

حساب‌های کاربری ListChild

حساب‌های کاربری ListChild
`rpc ListChildAccounts( ListChildAccountsRequest ) returns ( ListChildAccountsResponse )` تمام حساب‌ها را تحت شناسه حساب CSS مشخص شده فهرست می‌کند و به صورت اختیاری بر اساس شناسه برچسب و نام حساب فیلتر می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc ListChildAccounts( ListChildAccountsRequest ) returns ( ListChildAccountsResponse )

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

دامنه‌های مجوز

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

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

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

برچسب‌های به‌روزرسانی

برچسب‌های به‌روزرسانی
`rpc UpdateLabels( UpdateAccountLabelsRequest ) returns ( Account )` برچسب‌های اختصاص داده شده به حساب‌های CSS/MC توسط یک دامنه CSS را به‌روزرسانی می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc UpdateLabels( UpdateAccountLabelsRequest ) returns ( Account )

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

دامنه‌های مجوز

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

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

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

سرویس ورودی‌های CssProduct

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

ورودی محصول را حذف کنید

ورودی محصول را حذف کنید
`rpc DeleteCssProductInput( DeleteCssProductInputRequest ) returns ( Empty )` ورودی CSS Product را از حساب CSS Center شما حذف می‌کند. پس از حذف، ممکن است چند دقیقه طول بکشد تا ورودی دیگر در دسترس نباشد. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc DeleteCssProductInput( DeleteCssProductInputRequest ) returns ( Empty )

ورودی CSS Product را از حساب CSS Center شما حذف می‌کند.

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

دامنه‌های مجوز

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

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

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

ورودی محصول را وارد کنید

ورودی محصول را وارد کنید
`rpc InsertCssProductInput( InsertCssProductInputRequest ) returns ( CssProductInput )` یک ورودی CssProductInput را به حساب CSS Center شما آپلود می‌کند. اگر ورودی‌ای با همان contentLanguage، identity، feedLabel و feedId از قبل وجود داشته باشد، این متد آن ورودی را جایگزین می‌کند. پس از درج، به‌روزرسانی یا حذف ورودی CSS Product، ممکن است چند دقیقه طول بکشد تا CSS Product پردازش‌شده بازیابی شود. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc InsertCssProductInput( InsertCssProductInputRequest ) returns ( CssProductInput )

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

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

دامنه‌های مجوز

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

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

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

ورودی UpdateCssProduct

ورودی UpdateCssProduct
`rpc UpdateCssProductInput( UpdateCssProductInputRequest ) returns ( CssProductInput )` ورودی Css Product موجود در حساب CSS Center شما را به‌روزرسانی می‌کند. پس از درج، به‌روزرسانی یا حذف ورودی CSS Product، ممکن است چند دقیقه طول بکشد تا Css Product پردازش‌شده بازیابی شود. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc UpdateCssProductInput( UpdateCssProductInputRequest ) returns ( CssProductInput )

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

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

دامنه‌های مجوز

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

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

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

خدمات محصولات Css

سرویسی برای دریافت و فهرست کردن محصولات CSS (که به صورت داخلی با نام Aggregate Offers نیز شناخته می‌شود).

GetCssProduct

GetCssProduct
`rpc GetCssProduct( GetCssProductRequest ) returns ( CssProduct )` محصول CSS پردازش‌شده را از حساب CSS Center شما بازیابی می‌کند. پس از درج، به‌روزرسانی یا حذف ورودی محصول، ممکن است چند دقیقه طول بکشد تا محصول نهایی به‌روزرسانی‌شده بازیابی شود. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc GetCssProduct( GetCssProductRequest ) returns ( CssProduct )

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

دامنه‌های مجوز

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

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

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

محصولات ListCss

محصولات ListCss
`rpc ListCssProducts( ListCssProductsRequest ) returns ( ListCssProductsResponse )` محصولات CSS پردازش‌شده را در حساب CSS Center شما فهرست می‌کند. پاسخ ممکن است شامل موارد کمتری نسبت به آنچه توسط pageSize مشخص شده است، باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید. پس از درج، به‌روزرسانی یا حذف ورودی یک محصول CSS، ممکن است چند دقیقه طول بکشد تا محصول CSS پردازش‌شده‌ی به‌روزرسانی‌شده بازیابی شود. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc ListCssProducts( ListCssProductsRequest ) returns ( ListCssProductsResponse )

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

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

دامنه‌های مجوز

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

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

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

خدمات سهمیه‌ای

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

لیست سهمیه‌ها

لیست سهمیه‌ها
`rpc ListQuotaGroups( ListQuotaGroupsRequest ) returns ( ListQuotaGroupsResponse )` سهمیه تماس روزانه و میزان استفاده به ازای هر گروه را برای حساب CSS Center شما فهرست می‌کند. دامنه‌های مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc ListQuotaGroups( ListQuotaGroupsRequest ) returns ( ListQuotaGroupsResponse )

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

دامنه‌های مجوز

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

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

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

حساب کاربری

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

فیلدها
`name`	`string` نام منبع برچسب. قالب: accounts/{account}
`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 نیز هست، زیرا ما عملاً در حال مسطح کردن سلسله مراتب هستیم.

نوع حساب

نوع حساب.

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

برچسب حساب

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

فیلدها
`name`	`string` شناسه. نام منبع برچسب. قالب: accounts/{account}/labels/{label}
`label_id`	`int64` فقط خروجی. شناسه برچسب.
`account_id`	`int64` فقط خروجی. شناسه حسابی که این برچسب به آن تعلق دارد.
`label_type`	`LabelType` فقط خروجی. نوع این برچسب.
`display_name`	`string` نام نمایشی این برچسب.
`description`	`string` توضیحات این برچسب

نوع برچسب

نوع برچسب.

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

ویژگی‌ها

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

فیلدها
`low_price`	`Price` قیمت پایین محصول CSS.
`high_price`	`Price` قیمت بالای محصول CSS.
`headline_offer_price`	`Price` قیمت اصلی محصول CSS.
`headline_offer_shipping_price`	`Price` قیمت اصلی محصول CSS.
`additional_image_links[]`	`string` آدرس اینترنتی (URL) تصاویر اضافی کالا.
`product_types[]`	`string` دسته بندی های کالا (با فرمت مشخصات داده محصولات ).
`size_types[]`	`string` برش کالا. می‌توان از آن برای نمایش انواع سایزهای ترکیبی برای پوشاک استفاده کرد. حداکثر دو نوع سایز می‌تواند ارائه شود (به نوع سایز مراجعه کنید).
`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` خیلی دور باشد، ممکن است زودتر باشد. توجه: ممکن است حذف واقعی کالا بیش از ۲ روز از تاریخ انقضا طول بکشد.
`included_destinations[]`	`string` فهرست مقصدهایی که باید برای این هدف لحاظ شوند (مطابق با کادرهای انتخاب‌شده در مرکز فروشندگان). مقصدهای پیش‌فرض همیشه لحاظ می‌شوند، مگر اینکه در `excludedDestinations` ارائه شده باشند.
`excluded_destinations[]`	`string` فهرست مقاصدی که باید برای این هدف حذف شوند (مطابق با کادرهای انتخاب نشده در مرکز فروشندگان).
`headline_offer_installment`	`HeadlineOfferInstallment` تعداد و مبلغ اقساط برای پرداخت یک کالا.
`headline_offer_subscription_cost`	`HeadlineOfferSubscriptionCost` تعداد دوره‌ها (ماه‌ها یا سال‌ها) و مبلغ پرداختی در هر دوره برای یک کالا با قرارداد اشتراک مرتبط.
`cpp_link`	`string` آدرس اینترنتی (URL) که مستقیماً به صفحه جزئیات محصول شما در CSS لینک می‌دهد.
`cpp_mobile_link`	`string` آدرس اینترنتی نسخه بهینه شده برای موبایل صفحه جزئیات محصول در CSS.
`cpp_ads_redirect`	`string` به تبلیغ‌کنندگان اجازه می‌دهد تا هنگام نمایش محصول در متن تبلیغات محصول، URL کالا را نادیده بگیرند.
`number_of_offers`	`int64` تعداد محصولات CSS.
`headline_offer_condition`	`string` وضعیت پیشنهاد اصلی.
`headline_offer_link`	`string` لینک به پیشنهاد ویژه.
`headline_offer_mobile_link`	`string` لینک موبایل به پیشنهاد ویژه.
`title`	`string` عنوان کالا.
`image_link`	`string` آدرس اینترنتی (URL) تصویر کالا.
`description`	`string` شرح کالا.
`brand`	`string` ویژگی‌های مرتبط با محصول.[14-36] برند کالا.
`mpn`	`string` شماره قطعه سازنده ( MPN ) کالا.
`gtin`	`string` شماره جهانی قلم تجاری ( GTIN ) قلم.
`google_product_category`	`string` دسته‌بندی گوگل برای کالا (به دسته‌بندی محصولات گوگل مراجعه کنید). هنگام جستجوی محصولات، این فیلد حاوی مقداری خواهد بود که کاربر ارائه داده است. در حال حاضر هیچ راهی برای بازیابی دسته‌بندی‌های خودکار اختصاص داده شده به محصولات گوگل از طریق 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` برچسب سفارشی ۰ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.
`custom_label_1`	`string` برچسب سفارشی ۱ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.
`custom_label_2`	`string` برچسب سفارشی ۲ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.
`custom_label_3`	`string` برچسب سفارشی ۳ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.
`custom_label_4`	`string` برچسب سفارشی ۴ برای گروه‌بندی سفارشی اقلام در یک کمپین خرید.
`review_count`	`int64` تعداد نظرات مربوط به محصول. در صورت ارائه `rating` الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.
`min_rating`	`int64` حداقل امتیاز رتبه‌بندی محصول. در صورت ارائه `rating` الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.
`max_rating`	`int64` حداکثر امتیاز رتبه‌بندی محصول. در صورت ارائه `rating` الزامی است. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.
`rating`	`double` میانگین امتیاز رتبه‌بندی محصول. این مقدار باید در محدوده [ `min_rating` , `max_rating` ] باشد. این امتیاز هنگام نمایش در صفحه محصول، با یک رقم اعشار به مقیاس [1، 5] نرمال‌سازی می‌شود. در صورت وجود، `review_count` , `min_rating` و `max_rating` نیز الزامی هستند. این فیلد برای یک ویژگی جدید است و هنوز استفاده نشده است.

صدور گواهینامه

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

فیلدها

فیلدها
`name`	`string` نام گواهینامه. در حال حاضر، رایج‌ترین مقدار "EPREL" است که نشان‌دهنده گواهینامه‌های بهره‌وری انرژی در پایگاه داده ثبت اروپایی برچسب‌گذاری انرژی (EPREL) اتحادیه اروپا است.
`authority`	`string` مرجع یا نهاد صدور گواهینامه مسئول صدور گواهینامه. در حال حاضر، رایج‌ترین مقدار برای برچسب‌های انرژی در اتحادیه اروپا "EC" یا "European_Commission" است.
`code`	`string` کد گواهینامه. به عنوان مثال، برای گواهینامه EPREL با لینک https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 کد 123456 است. این کد برای برچسب‌های انرژی اروپایی الزامی است.

name

string

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

authority

string

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

code

string

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

درخواست ایجاد حساب کاربری

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

فیلدها

فیلدها
`parent`	`string` الزامی. حساب والد. فرمت: accounts/{account}
`account_label`	`AccountLabel` الزامی. برچسبی که باید ایجاد شود.

parent

string

الزامی. حساب والد. فرمت: accounts/{account}

account_label

AccountLabel

الزامی. برچسبی که باید ایجاد شود.

سی‌اس‌پرادکت

محصول 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 در معرض نمایش قرار نگرفته‌اند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در گوگل، مفید است.
`css_product_status`	`CssProductStatus` فقط خروجی. وضعیت یک محصول، مسائل اعتبارسنجی داده‌ها، یعنی اطلاعات مربوط به یک محصول که به صورت ناهمزمان محاسبه می‌شود.

ورودی CssProduct

این منبع نشان‌دهنده‌ی داده‌های ورودی است که شما برای یک محصول CSS ارسال می‌کنید، نه محصول CSS پردازش‌شده‌ای که در CSS Center، Shopping Ads یا در سطوح مختلف گوگل مشاهده می‌کنید.

فیلدها
`name`	`string` شناسه. نام ورودی CSS محصول. قالب: `accounts/{account}/cssProductInputs/{css_product_input}` ، که در آن بخش آخر `css_product_input` از ۳ بخش تشکیل شده است: 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` این کالا منسوخ شده است! منسوخ شده. به جای آن از expire_date استفاده کنید. نشان‌دهنده‌ی نسخه موجود (تازه بودن) محصول CSS است که می‌تواند برای حفظ ترتیب صحیح هنگام انجام چندین به‌روزرسانی همزمان استفاده شود. این فیلد نباید به زمان آینده تنظیم شود. اگر تنظیم شود، اگر نسخه جدیدتری از آیتم از قبل در سیستم ما وجود داشته باشد (یعنی آخرین زمان به‌روزرسانی محصولات CSS موجود دیرتر از زمان تازگی تنظیم‌شده در به‌روزرسانی باشد)، از به‌روزرسانی جلوگیری می‌شود. اگر به‌روزرسانی اتفاق بیفتد، آخرین زمان به‌روزرسانی روی این زمان تازگی تنظیم می‌شود. اگر تنظیم نشود، از به‌روزرسانی جلوگیری نمی‌شود و آخرین زمان به‌روزرسانی به‌طور پیش‌فرض به زمانی که این درخواست توسط CSS API دریافت شده است، تنظیم می‌شود. اگر از اجرای عملیات جلوگیری شود، خطای لغو شده (aborted exception) رخ خواهد داد.
`attributes`	`Attributes` فهرستی از ویژگی‌های محصول CSS.
`custom_attributes[]`	`CustomAttribute` فهرستی از ویژگی‌های سفارشی (ارائه شده توسط CSS). همچنین می‌تواند برای ارسال هر ویژگی از مشخصات فید به شکل عمومی آن استفاده شود (برای مثال: `{ "name": "size type", "value": "regular" }` ). این برای ارسال ویژگی‌هایی که به صراحت توسط API نمایش داده نمی‌شوند، مانند ویژگی‌های اضافی مورد استفاده برای خرید در گوگل، مفید است.

وضعیت محصول Css

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

فیلدها
`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 در آنها رد شده است.

شماره سطح آیتم

شماره آیتم سطح مربوط به وضعیت محصول.

فیلدها
`code`	`string` کد خطای مربوط به مشکل.
`servability`	`string` چگونه این مشکل بر ارائه محصول CSS تأثیر می‌گذارد.
`resolution`	`string` اینکه آیا مشکل توسط فروشنده قابل حل است یا خیر.
`attribute`	`string` نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.
`destination`	`string` مقصدی که مشکل به آن مربوط می‌شود.
`description`	`string` شرح مختصری از مشکل به زبان انگلیسی.
`detail`	`string` شرح مفصلی از مشکل به زبان انگلیسی.
`documentation`	`string` آدرس اینترنتی یک صفحه وب برای کمک به حل این مشکل.
`applicable_countries[]`	`string` فهرست کدهای کشور (ISO 3166-1 alpha-2) که در آن موضوع مربوط به محصول CSS است.

درخواست حذف برچسب حساب

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

فیلدها

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

name

string

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

درخواست ورودی محصول را حذف کنید

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

فیلدها

فیلدها
`name`	`string` الزامی. نام منبع ورودی محصول CSS برای حذف. قالب: accounts/{account}/cssProductInputs/{css_product_input}، که در آن بخش آخر `css_product_input` از ۳ بخش تشکیل شده است: contentLanguage~feedLabel~offerId. مثال: accounts/123/cssProductInputs/de~DE~rawProvidedId123
`supplemental_feed_id`	`int64` شناسه فید تکمیلی API محتوا. اگر اکشن به یک فید اصلی اعمال شود، فیلد نباید تنظیم شود. اگر فیلد تنظیم شود، اکشن محصول به جای فید API محتوای اصلی، به یک فید تکمیلی اعمال می‌شود.

name

string

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

supplemental_feed_id

int64

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

درخواست دریافت حساب

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

فیلدها

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

name

string

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

parent

string

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

درخواست GetCssProduct

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

فیلدها

فیلدها
`name`	`string` الزامی. نام محصول CSS برای بازیابی. قالب: `accounts/{account}/cssProducts/{css_product}`

name

string

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

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

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

فیلدها

فیلدها
`months`	`int64` تعداد اقساطی که خریدار باید پرداخت کند.
`amount`	`Price` مبلغی که خریدار باید ماهانه بپردازد.
`downpayment`	`Price` مبلغ پیش‌پرداختی که خریدار باید بپردازد.

months

int64

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

amount

Price

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

downpayment

Price

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

پیشنهاد ویژههزینه اشتراک

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

فیلدها

فیلدها
`period`	`SubscriptionPeriod` نوع دوره اشتراک. مقادیر پشتیبانی شده عبارتند از: * " `month` " * " `year` "
`period_length`	`int64` تعداد دوره‌های اشتراکی که خریدار باید پرداخت کند.
`amount`	`Price` مبلغی که خریدار باید برای هر دوره اشتراک بپردازد.

period

SubscriptionPeriod

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

period_length

int64

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

amount

Price

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

درخواست ورودی محصول را وارد کنید

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

فیلدها

فیلدها
`parent`	`string` الزامی. حسابی که این محصول CSS در آن درج خواهد شد. قالب: accounts/{account}
`css_product_input`	`CssProductInput` الزامی. ورودی CSS محصول برای درج.
`feed_id (deprecated)`	`int64` این کالا منسوخ شده است! اختیاری. منسوخ شده. شناسه فید برای محصولات CSS لازم نیست. شناسه فید اصلی یا تکمیلی. اگر محصول CSS از قبل وجود داشته باشد و شناسه فید ارائه شده متفاوت باشد، محصول CSS به یک فید جدید منتقل می‌شود. توجه: در حال حاضر، CSSها نیازی به ارائه شناسه فید ندارند زیرا ما فیدها را به صورت آنی ایجاد می‌کنیم. ما هنوز پشتیبانی از فید تکمیلی برای محصولات CSS نداریم.

parent

string

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

css_product_input

CssProductInput

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

feed_id
 (deprecated)

int64

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

درخواست برچسب‌های حساب ListAccount

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

فیلدها

فیلدها
`parent`	`string` الزامی. حساب والد. فرمت: accounts/{account}
`page_size`	`int32` حداکثر تعداد برچسب‌هایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۵۰ برچسب برگردانده خواهد شد. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند.
`page_token`	`string` یک توکن صفحه، که از فراخوانی قبلی `ListAccountLabels` دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به `ListAccountLabels` باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

parent

string

الزامی. حساب والد. فرمت: accounts/{account}

page_size

int32

حداکثر تعداد برچسب‌هایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۵۰ برچسب برگردانده خواهد شد. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند.

page_token

string

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

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

ListAccountLabelsResponse

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

فیلدها

فیلدها
`account_labels[]`	`AccountLabel` برچسب‌های حساب مشخص‌شده.
`next_page_token`	`string` یک توکن، که می‌تواند به عنوان `page_token` برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

account_labels[]

AccountLabel

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

next_page_token

string

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

درخواست حساب‌های کاربری ListChild

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

فیلدها
`parent`	`string` الزامی. حساب کاربری والد. باید یک گروه یا دامنه CSS باشد. فرمت: accounts/{account}
`page_size`	`int32` اختیاری. حداکثر تعداد حساب‌هایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. در صورت عدم تعیین، حداکثر ۵۰ حساب برگردانده خواهد شد. حداکثر مقدار ۱۰۰ است؛ مقادیر بالاتر از ۱۰۰ به ۱۰۰ کاهش داده می‌شوند.
`page_token`	`string` اختیاری. یک توکن صفحه که از فراخوانی قبلی `ListChildAccounts` دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به `ListChildAccounts` باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.
`label_id`	`int64` در صورت تنظیم، فقط حساب‌های MC با شناسه برچسب داده شده بازگردانده می‌شوند.
`full_name`	`string` در صورت تنظیم، فقط حساب‌های MC با نام داده شده (حساس به حروف بزرگ و کوچک) بازگردانده می‌شوند.

پاسخ ListChildAccounts

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

فیلدها

فیلدها
`accounts[]`	`Account` حساب‌های CSS/MC که برای حساب والد CSS مشخص‌شده برگردانده شده‌اند.
`next_page_token`	`string` یک توکن، که می‌تواند به عنوان `page_token` برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

accounts[]

Account

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

next_page_token

string

درخواست محصولات ListCss

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

فیلدها

فیلدها
`parent`	`string` الزامی. حساب/دامنه برای فهرست کردن محصولات CSS پردازش شده برای آن. فرمت: accounts/{account}
`page_size`	`int32` حداکثر تعداد محصولات CSS برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند. اگر مشخص نشود، حداکثر تعداد محصولات CSS برگردانده خواهد شد.
`page_token`	`string` یک توکن صفحه، که از فراخوانی قبلی `ListCssProducts` دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به `ListCssProducts` باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

parent

string

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

page_size

int32

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

page_token

string

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

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

پاسخ ListCssProducts

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

فیلدها

فیلدها
`css_products[]`	`CssProduct` محصولات CSS پردازش‌شده از حساب مشخص‌شده. اینها محصولات CSS پردازش‌شده شما پس از اعمال قوانین و فیدهای تکمیلی هستند.
`next_page_token`	`string` یک توکن، که می‌تواند به عنوان `page_token` برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

css_products[]

CssProduct

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

next_page_token

string

درخواست لیست سهمیه‌هاگروه‌ها

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

فیلدها

فیلدها
`parent`	`string` الزامی. حساب CSS که مالک مجموعه‌ای از سهمیه‌های متد و منابع است. در بیشتر موارد، این دامنه CSS است. قالب: accounts/{account}
`page_size`	`int32` اختیاری. حداکثر تعداد سهمیه‌هایی که باید در پاسخ برگردانده شود، برای صفحه‌بندی استفاده می‌شود. پیش‌فرض ۵۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند.
`page_token`	`string` اختیاری. توکن (در صورت ارائه) برای بازیابی صفحه بعدی. سایر پارامترها باید با فراخوانی اصلی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

parent

string

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

page_size

int32

اختیاری. حداکثر تعداد سهمیه‌هایی که باید در پاسخ برگردانده شود، برای صفحه‌بندی استفاده می‌شود. پیش‌فرض ۵۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود می‌شوند.

page_token

string

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

ListQuotaGroupsپاسخ

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

فیلدها

فیلدها
`quota_groups[]`	`QuotaGroup` روش‌ها، میزان استفاده فعلی از سهمیه و محدودیت‌های هر گروه. سهمیه بین تمام روش‌های گروه به اشتراک گذاشته می‌شود. گروه‌ها بر اساس `quota_usage` به ترتیب نزولی مرتب شده‌اند.
`next_page_token`	`string` یک توکن، که می‌تواند به عنوان `page_token` برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

quota_groups[]

QuotaGroup

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

next_page_token

string

جزئیات روش

جزئیات متد به ازای هر متد در CSS API.

فیلدها
`method`	`string` فقط خروجی. نام متد، برای مثال `cssproductsservice.listcssproducts` .
`version`	`string` فقط خروجی. نسخه API که متد به آن تعلق دارد.
`subapi`	`string` فقط خروجی. زیر-API که متد به آن تعلق دارد. در API CSS، این همیشه `css` است.
`path`	`string` فقط خروجی. مسیر متد مانند `v1/cssproductsservice.listcssproducts` .

جزئیات محصول

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

فیلدها

فیلدها
`section_name`	`string` سربرگ بخش برای گروه‌بندی مجموعه‌ای از جزئیات محصول استفاده می‌شود.
`attribute_name`	`string` نام جزئیات محصول.
`attribute_value`	`string` ارزش جزئیات محصول.

section_name

string

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

attribute_name

string

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

attribute_value

string

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

ابعاد محصول

ابعاد محصول.

فیلدها

فیلدها
`value`	`double` الزامی. مقدار بُعد که به صورت یک عدد نمایش داده می‌شود. این مقدار می‌تواند حداکثر دقت چهار رقم اعشار را داشته باشد.
`unit`	`string` الزامی. واحدهای ابعاد. مقادیر قابل قبول عبارتند از: * " `in` " * " `cm` "

value

double

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

unit

string

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

وزن محصول

وزن محصول.

فیلدها

فیلدها
`value`	`double` الزامی. وزن به صورت عدد نمایش داده می‌شود. حداکثر دقت وزن می‌تواند چهار رقم اعشار باشد.
`unit`	`string` الزامی. واحد وزن. مقادیر قابل قبول عبارتند از: * " `g` " * " `kg` " * " `oz` " * " `lb` "

value

double

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

unit

string

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

گروه سهمیه

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

فیلدها
`name`	`string` شناسه. نام منبع گروه سهمیه. قالب: accounts/{account}/quotas/{group} مثال: `accounts/12345678/quotas/css-products-insert` توجه: تضمین نمی‌شود که بخش {group} از الگوی خاصی پیروی کند.
`quota_usage`	`int64` فقط خروجی. میزان استفاده از سهمیه فعلی، به معنی تعداد فراخوانی‌هایی که در یک روز مشخص با متدهای موجود در گروه انجام شده است. محدودیت‌های سهمیه روزانه در ساعت ۱۲:۰۰ ظهر به وقت جهانی بازنشانی می‌شوند.
`quota_limit`	`int64` فقط خروجی. حداکثر تعداد تماس‌های مجاز در روز برای گروه.
`quota_minute_limit`	`int64` فقط خروجی. حداکثر تعداد تماس‌های مجاز در هر دقیقه برای گروه.
`method_details[]`	`MethodDetails` فقط خروجی. فهرست تمام روش‌هایی که سهمیه گروه به آنها اعمال می‌شود.

دوره اشتراک

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

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

درخواست برچسب حساب به‌روزرسانی

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

فیلدها

فیلدها
`account_label`	`AccountLabel` الزامی. برچسب به‌روزرسانی‌شده. همه فیلدها باید پر شوند.

account_label

AccountLabel

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

درخواست به‌روزرسانی برچسب‌های حساب

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

فیلدها

فیلدها
`name`	`string` الزامی. نام منبع برچسب. قالب: accounts/{account}
`label_ids[]`	`int64` فهرست شناسه‌های برچسب برای بازنویسی شناسه‌های برچسب حساب موجود. اگر فهرست خالی باشد، تمام شناسه‌های برچسب اختصاص داده شده فعلی حذف خواهند شد.
`parent`	`string` اختیاری. فقط هنگام به‌روزرسانی برچسب‌های حساب MC مورد نیاز است. دامنه CSS که منبع والد حساب MC است. قالب: accounts/{account}

name

string

الزامی. نام منبع برچسب. قالب: accounts/{account}

label_ids[]

int64

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

parent

string

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

درخواست ورودی UpdateCssProduct

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

فیلدها

فیلدها
`css_product_input`	`CssProductInput` الزامی. منبع ورودی محصول CSS برای به‌روزرسانی. اطلاعاتی که ارسال می‌کنید برای محصول CSS پردازش‌شده نیز اعمال خواهد شد.
`update_mask`	`FieldMask` فهرست ویژگی‌های CSS محصول که باید به‌روزرسانی شوند. اگر ماسک به‌روزرسانی حذف شود، به عنوان ماسک فیلد ضمنی معادل تمام فیلدهایی که پر شده‌اند (مقداری غیر خالی دارند) در نظر گرفته می‌شود. ویژگی‌هایی که در ماسک به‌روزرسانی مشخص شده‌اند و مقداری در بدنه ندارند، از محصول CSS حذف خواهند شد. ماسک به‌روزرسانی فقط می‌تواند برای فیلدهای سطح بالا در ویژگی‌ها و ویژگی‌های سفارشی مشخص شود. برای مشخص کردن ماسک به‌روزرسانی برای ویژگی‌های سفارشی، باید پیشوند `custom_attribute.` را اضافه کنید. ارائه مقدار ویژه "*" برای جایگزینی کامل محصول CSS پشتیبانی نمی‌شود.

css_product_input

CssProductInput

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

update_mask

FieldMask

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

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

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

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

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

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

Package google.shopping.css.v1 با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

فهرست

سرویس برچسب‌های حساب

سرویس حساب‌ها

سرویس ورودی‌های CssProduct

خدمات محصولات Css

خدمات سهمیه‌ای

حساب کاربری

نوع حساب

برچسب حساب

نوع برچسب

ویژگی‌ها

صدور گواهینامه

درخواست ایجاد حساب کاربری

سی‌اس‌پرادکت

ورودی CssProduct

وضعیت محصول Css

وضعیت مقصد

شماره سطح آیتم

درخواست حذف برچسب حساب

درخواست ورودی محصول را حذف کنید

درخواست دریافت حساب

درخواست GetCssProduct

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

پیشنهاد ویژههزینه اشتراک

درخواست ورودی محصول را وارد کنید

درخواست برچسب‌های حساب ListAccount

ListAccountLabelsResponse

درخواست حساب‌های کاربری ListChild

پاسخ ListChildAccounts

درخواست محصولات ListCss

پاسخ ListCssProducts

درخواست لیست سهمیه‌هاگروه‌ها

ListQuotaGroupsپاسخ

جزئیات روش

جزئیات محصول

ابعاد محصول

وزن محصول

گروه سهمیه

دوره اشتراک

درخواست برچسب حساب به‌روزرسانی

درخواست به‌روزرسانی برچسب‌های حساب

درخواست ورودی UpdateCssProduct

Package google.shopping.css.v1