يجب على المطوّرين التسجيل لاستخدام CSS API بحلول يونيو 2026. لتحسين ثبات واجهات CSS API وأمانها، سنطرح عملية تسجيل إلزامية لمرة واحدة لواجهات CSS API. إذا سبق لك إكمال عملية التسجيل هذه لمشاريع Google Cloud أثناء تفعيل Merchant API، لن تحتاج إلى تكرار هذه الخطوات. يمكنك العثور على تعليمات أكثر تفصيلاً في موقع المطوّرين لواجهة Merchant API، ويمكنك التواصل مع فريق دعم واجهة API إذا كنت بحاجة إلى مزيد من المساعدة.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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 (رسالة)

AccountLabelsService

إدارة تصنيفات حسابات Merchant Center وCSS

CreateAccountLabel

CreateAccountLabel
`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.

DeleteAccountLabel

DeleteAccountLabel
`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.

ListAccountLabels

ListAccountLabels
`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.

UpdateAccountLabel

UpdateAccountLabel
`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.

AccountsService

خدمة لإدارة معلومات حساب CSS/MC

GetAccount

GetAccount
`rpc GetAccount(GetAccountRequest) returns (Account)` يستردّ هذا الإجراء حسابًا واحدًا على CSS أو حسابًا متعدّد العملاء حسب رقم التعريف. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/content` لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

rpc GetAccount(GetAccountRequest) returns (Account)

يستردّ هذا الإجراء حسابًا واحدًا على CSS أو حسابًا متعدّد العملاء حسب رقم التعريف.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ListChildAccounts

ListChildAccounts
`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.

UpdateLabels

UpdateLabels
`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.

CssProductInputsService

الخدمة التي سيتم استخدام مورد CssProductInput فيها. تساعد هذه الخدمة في إدراج منتجات CSS أو تعديلها أو حذفها.

DeleteCssProductInput

DeleteCssProductInput
`rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)` يحذف هذا الإجراء إدخال منتج CSS من حسابك على CSS Center. بعد الحذف، قد يستغرق الأمر عدّة دقائق إلى أن يصبح الإدخال غير متاح. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/content` لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

يحذف هذا الإجراء إدخال منتج CSS من حسابك على CSS Center.

بعد الحذف، قد يستغرق الأمر عدّة دقائق إلى أن يصبح الإدخال غير متاح.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

InsertCssProductInput

InsertCssProductInput
`rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)` تحميل CssProductInput إلى حسابك على CSS Center إذا كان هناك إدخال يتضمّن contentLanguage وidentity وfeedLabel وfeedId نفسها، تستبدل هذه الطريقة هذا الإدخال. بعد إدراج أو تعديل أو حذف إدخال "منتج CSS"، قد يستغرق استرداد "منتج CSS" الذي تمت معالجته عدة دقائق. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/content` لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

تحميل CssProductInput إلى حسابك على CSS Center إذا كان هناك إدخال يتضمّن contentLanguage وidentity وfeedLabel وfeedId نفسها، تستبدل هذه الطريقة هذا الإدخال.

بعد إدراج أو تعديل أو حذف إدخال "منتج CSS"، قد يستغرق استرداد "منتج CSS" الذي تمت معالجته عدة دقائق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

UpdateCssProductInput

UpdateCssProductInput
`rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)` تعديل إدخال "منتج CSS" الحالي في حسابك على CSS Center بعد إدراج أو تعديل أو حذف إدخال منتج CSS، قد يستغرق الأمر عدة دقائق قبل أن تتمكّن من استرداد منتج CSS الذي تمت معالجته. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/content` لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

تعديل إدخال "منتج CSS" الحالي في حسابك على CSS Center

بعد إدراج أو تعديل أو حذف إدخال منتج CSS، قد يستغرق الأمر عدة دقائق قبل أن تتمكّن من استرداد منتج CSS الذي تمت معالجته.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

CssProductsService

خدمة لإجراء عمليات get وlist على منتجات CSS(المعروفة أيضًا باسم "العروض التجميعية" داخليًا).

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.

ListCssProducts

ListCssProducts
`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.

QuotaService

خدمة للحصول على معلومات حصة طلبات إجراءات الواجهة البرمجية لكل طريقة في CSS API

ListQuotaGroups

ListQuotaGroups
`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.

Account

معلومات عن حساب CSS/MC

الحقول
`name`	`string` اسم مصدر التصنيف التنسيق: accounts/{account}
`full_name`	`string` النتائج فقط. غير قابل للتغيير الاسم الكامل لحساب CSS أو Merchant Center
`label_ids[]`	`int64` معرّفات التصنيفات التي تم إنشاؤها يدويًا والتي تم تعيينها لحساب خدمة مقارنة الأسعار (CSS) أو حساب Merchant Center ‫(MC) من خلال حساب رئيسي في خدمة مقارنة الأسعار (CSS)
`automatic_label_ids[]`	`int64` أرقام تعريف التصنيفات التي يتم إنشاؤها تلقائيًا وتعيينها لحساب Merchant Center من خلال CSS Center
`account_type`	`AccountType` النتائج فقط. نوع هذا الحساب
`display_name`	`string` الاسم المعروض المختصر لحساب CSS/MC
`homepage_uri`	`string` النتائج فقط. غير قابل للتغيير الصفحة الرئيسية لحساب CSS/MC
`parent`	`string` المصدر الرئيسي لحساب CSS أو حساب متعدّد العملاء مجموعة CSS لنطاقات CSS، ونطاق CSS لحسابات "متعددة العملاء" يتم عرض هذه السمة فقط إذا كان لدى المستخدم إذن بالوصول إلى الحساب الرئيسي. ملاحظة: بالنسبة إلى الحسابات الفرعية المتعدّدة العملاء، هذا هو أيضًا نطاق CSS الذي يمثّل المرجع الرئيسي لحساب MCA، لأنّنا نعمل فعليًا على تسوية التسلسل الهرمي."

AccountType

نوع الحساب

عمليات التعداد
`ACCOUNT_TYPE_UNSPECIFIED`	نوع الحساب غير معروف.
`CSS_GROUP`	حساب مجموعة CSS
`CSS_DOMAIN`	حساب نطاق CSS
`MC_PRIMARY_CSS_MCA`	حساب MCA الأساسي على CSS في Merchant Center
`MC_CSS_MCA`	حساب MCA على CSS في Merchant Center
`MC_MARKETPLACE_MCA`	حساب متعدّد العملاء في السوق على Merchant Center
`MC_OTHER_MCA`	حساب آخر على "حسابات متعدّدة العملاء" في Merchant Center
`MC_STANDALONE`	حساب Merchant Center مستقل
`MC_MCA_SUBACCOUNT`	حساب فرعي لحساب متعدّد العملاء في Merchant Center

AccountLabel

تصنيف يحدّده نطاق CSS أو مجموعة CSS لأحد حساباتها الفرعية.

الحقول
`name`	`string` المعرّف. تمثّل هذه السمة اسم مصدر التصنيف. التنسيق: accounts/{account}/labels/{label}
`label_id`	`int64` النتائج فقط. معرّف التصنيف
`account_id`	`int64` النتائج فقط. تمثّل هذه السمة معرّف الحساب الذي ينتمي إليه هذا التصنيف.
`label_type`	`LabelType` النتائج فقط. تمثّل هذه السمة نوع التصنيف.
`display_name`	`string` الاسم المعروض لهذا التصنيف.
`description`	`string` تمثّل هذه السمة وصف التصنيف.

LabelType

تمثّل هذه السمة نوع التصنيف.

عمليات التعداد
`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` قائمة الوجهات المطلوب تضمينها لهذا الاستهداف (تتطابق مع مربّعات الاختيار التي تم وضع علامة فيها في Merchant Center) يتم دائمًا تضمين الوجهات التلقائية ما لم تتم إضافتها ضمن `excludedDestinations`.
`excluded_destinations[]`	`string` قائمة الوجهات المطلوب استبعادها من هذا الاستهداف (تتطابق مع مربعات الاختيار التي لم يتم وضع علامة فيها في Merchant Center)
`headline_offer_installment`	`HeadlineOfferInstallment` تمثّل هذه السمة عدد الأقساط والمبلغ المطلوب دفعه مقابل سلعة.
`headline_offer_subscription_cost`	`HeadlineOfferSubscriptionCost` عدد الفترات (أشهر أو سنوات) ومبلغ الدفع لكل فترة لمنتج مرتبط بعقد اشتراك
`cpp_link`	`string` عنوان URL يربط مباشرةً بصفحة تفاصيل المنتج في CSS.
`cpp_mobile_link`	`string` تمثّل هذه السمة عنوان URL لنسخة من صفحة تفاصيل المنتج في 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` Product Related Attributes.[14-36] Brand of the item.
`mpn`	`string` MPN للسلعة
`gtin`	`string` تمثّل الرقم التجاري العالمي للسلعة (GTIN) الخاص بالمنتج.
`google_product_category`	`string` فئة المنتج في Google (راجِع تصنيف المنتجات من Google). عند البحث عن المنتجات، سيحتوي هذا الحقل على القيمة التي يقدّمها المستخدم. لا تتوفّر حاليًا طريقة لاستعادة فئات المنتجات من Google التي تم تحديدها تلقائيًا من خلال واجهة برمجة التطبيقات.
`adult`	`bool` اضبط القيمة على "صحيح" إذا كان المنتج يستهدف البالغين.
`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" لتجميع السلع بشكلٍ مخصّص في "حملة تسوّق"
`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. إنّ رقم الاعتماد مطلوب لتصنيفات الطاقة الأوروبية.

CreateAccountLabelRequest

رسالة الطلب للطريقة CreateAccountLanel.

الحقول

الحقول
`parent`	`string` الحقل مطلوب. حساب الأهل التنسيق: accounts/{account}
`account_label`	`AccountLabel` الحقل مطلوب. التصنيف المطلوب إنشاؤه

parent

string

الحقل مطلوب. حساب الأهل التنسيق: accounts/{account}

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` النتائج فقط. قائمة بالسمات المخصّصة (التي توفّرها خدمة مقارنة الأسعار) يمكن أيضًا استخدامها لإرسال أي سمة من مواصفات الخلاصة في شكلها العام (على سبيل المثال، `{ "name": "size type", "value": "regular" }`)، ما يفيد في إرسال السمات التي لا تعرضها واجهة برمجة التطبيقات بشكلٍ صريح، مثل السمات الإضافية المستخدَمة في برنامج "الشراء على Google".
`css_product_status`	`CssProductStatus` النتائج فقط. حالة المنتج ومشاكل التحقّق من صحة البيانات، أي المعلومات التي يتم احتسابها بشكل غير متزامن حول المنتج

CssProductInput

يمثّل هذا المرجع بيانات الإدخال التي ترسلها لمنتج CSS، وليس منتج CSS المعالج الذي يظهر لك في CSS Center أو "إعلانات Shopping" أو على مساحات عرض 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 ومعالجتها. نسمح فقط باستخدام المعرّفات التي تحتوي على أحرف أبجدية رقمية وشرطات سفلية وواصلات. لمزيد من التفاصيل، راجِع مواصفات خلاصة المنتجات.
`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` قائمة بالسمات المخصّصة (التي توفّرها خدمة مقارنة الأسعار) يمكن استخدامها أيضًا لإرسال أي سمة من مواصفات الخلاصة في شكلها العام (على سبيل المثال: `{ "name": "size type", "value": "regular" }`)، ما يفيد في إرسال السمات التي لا تعرضها واجهة برمجة التطبيقات بشكلٍ صريح، مثل السمات الإضافية المستخدَمة في برنامج "الشراء على 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.

DestinationStatus

حالة الوجهة لحالة المنتج.

الحقول
`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

تمثّل هذه السمة المشكلة على مستوى السلعة في حالة المنتج.

الحقول
`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` الحقل مطلوب. اسم التصنيف المطلوب حذفه. التنسيق: accounts/{account}/labels/{label}

name

string

الحقل مطلوب. اسم التصنيف المطلوب حذفه. التنسيق: accounts/{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 الأساسية.

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 المُدار التنسيق: accounts/{account}
`parent`	`string` اختياريّ. مطلوب فقط عند استرداد معلومات حساب Merchant Center ‫(MC). نطاق CSS الذي يمثّل المرجع الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

name

string

الحقل مطلوب. اسم حساب CSS/MC المُدار التنسيق: accounts/{account}

parent

string

اختياريّ. مطلوب فقط عند استرداد معلومات حساب Merchant Center ‫(MC). نطاق CSS الذي يمثّل المرجع الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

GetCssProductRequest

رسالة الطلب لطريقة GetCssProduct

الحقول

الحقول
`name`	`string` الحقل مطلوب. اسم منتج CSS المطلوب استرداده. التنسيق: `accounts/{account}/cssProducts/{css_product}`

name

string

الحقل مطلوب. اسم منتج CSS المطلوب استرداده. التنسيق: accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

رسالة تمثّل الدفعة.

الحقول

الحقول
`months`	`int64` تمثّل عدد الأقساط المترتّبة على المشتري.
`amount`	`Price` تمثّل المبلغ المترتّب على المشتري شهريًا.
`downpayment`	`Price` تمثّل هذه السمة مبلغ الدفعة الأولى الذي يجب أن يسدّده المشتري.

months

int64

تمثّل عدد الأقساط المترتّبة على المشتري.

amount

Price

تمثّل المبلغ المترتّب على المشتري شهريًا.

downpayment

Price

تمثّل هذه السمة مبلغ الدفعة الأولى الذي يجب أن يسدّده المشتري.

HeadlineOfferSubscriptionCost

تمثّل هذه السمة تكلفة الاشتراك في المنتج.

الحقول

الحقول
`period`	`SubscriptionPeriod` نوع فترة الاشتراك. القيمتان المسموح بهما هما: * "`month`" * "`year`"
`period_length`	`int64` تمثّل عدد فترات الاشتراك التي يجب أن يدفع المشتري مقابلها.
`amount`	`Price` المبلغ الذي على المشتري دفعه لكل فترة اشتراك

period

SubscriptionPeriod

نوع فترة الاشتراك. القيمتان المسموح بهما هما: * "month" * "year"

period_length

int64

تمثّل عدد فترات الاشتراك التي يجب أن يدفع المشتري مقابلها.

amount

Price

المبلغ الذي على المشتري دفعه لكل فترة اشتراك

InsertCssProductInputRequest

رسالة الطلب لطريقة 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.

ListAccountLabelsRequest

رسالة الطلب لطريقة ListAccountLabels

الحقول

الحقول
`parent`	`string` الحقل مطلوب. حساب الأهل التنسيق: accounts/{account}
`page_size`	`int32` الحد الأقصى لعدد التصنيفات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 تصنيفًا بحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
`page_token`	`string` رمز مميز للصفحة تم تلقّيه من طلب `ListAccountLabels` سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى `ListAccountLabels` مع الطلب الذي قدّم رمز الصفحة المميّز.

parent

string

الحقل مطلوب. حساب الأهل التنسيق: accounts/{account}

page_size

int32

الحد الأقصى لعدد التصنيفات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 تصنيفًا بحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.

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 لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListChildAccountsRequest

رسالة الطلب لطريقة ListChildAccounts

الحقول
`parent`	`string` الحقل مطلوب. حساب الأهل يجب أن تكون مجموعة CSS أو نطاقًا. التنسيق: accounts/{account}
`page_size`	`int32` اختياريّ. الحد الأقصى لعدد الحسابات المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 حسابًا على الأكثر. الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم التي تزيد عن 100.
`page_token`	`string` اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب `ListChildAccounts` سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى `ListChildAccounts` مع الطلب الذي قدّم رمز الصفحة المميّز.
`label_id`	`int64` في حال ضبط هذا الحقل، سيتم عرض حسابات Merchant Center (MC) التي تحمل رقم تعريف التصنيف المحدّد فقط.
`full_name`	`string` في حال ضبط هذا الحقل، سيتم عرض حسابات Merchant Center (MC) التي تحمل الاسم المحدّد فقط (حسّاسة لحالة الأحرف).

ListChildAccountsResponse

رسالة الرد لطريقة ListChildAccounts

الحقول

الحقول
`accounts[]`	`Account` حسابات CSS/MC التي تم عرضها لحساب CSS الرئيسي المحدّد
`next_page_token`	`string` رمز مميز يمكن إرساله كـ `page_token` لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

accounts[]

Account

حسابات CSS/MC التي تم عرضها لحساب CSS الرئيسي المحدّد

next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListCssProductsRequest

رسالة الطلب لطريقة ListCssProducts

الحقول

الحقول
`parent`	`string` الحقل مطلوب. الحساب أو النطاق الذي سيتم عرض منتجات CSS المعالَجة فيه. التنسيق: accounts/{account}
`page_size`	`int32` الحدّ الأقصى لعدد منتجات CSS التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000. في حال عدم تحديدها، سيتم عرض الحد الأقصى لعدد المنتجات في CSS.
`page_token`	`string` رمز مميز للصفحة تم تلقّيه من طلب `ListCssProducts` سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى `ListCssProducts` مع الطلب الذي قدّم رمز الصفحة المميّز.

parent

string

الحقل مطلوب. الحساب أو النطاق الذي سيتم عرض منتجات CSS المعالَجة فيه. التنسيق: accounts/{account}

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` لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

css_products[]

CssProduct

منتجات CSS التي تمت معالجتها من الحساب المحدّد هذه هي منتجات CSS المعالَجة بعد تطبيق القواعد والخلاصات التكميلية.

next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListQuotaGroupsRequest

رسالة الطلب لطريقة ListQuotaGroups.

الحقول

الحقول
`parent`	`string` الحقل مطلوب. حساب CSS الذي يملك مجموعة حصص وطرق الموارد في معظم الحالات، يكون هذا هو نطاق CSS. التنسيق: accounts/{account}
`page_size`	`int32` اختياريّ. الحدّ الأقصى لعدد الحصص المطلوب عرضها في الردّ، ويُستخدم هذا الحدّ في تقسيم النتائج إلى صفحات. القيمة التلقائية هي 500، وسيتم فرض القيمة 1000 على القيم التي تزيد عن 1000.
`page_token`	`string` اختياريّ. الرمز المميز (إذا تم توفيره) لاسترداد الصفحة التالية يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز الصفحة.

parent

string

الحقل مطلوب. حساب CSS الذي يملك مجموعة حصص وطرق الموارد في معظم الحالات، يكون هذا هو نطاق CSS. التنسيق: accounts/{account}

page_size

int32

اختياريّ. الحدّ الأقصى لعدد الحصص المطلوب عرضها في الردّ، ويُستخدم هذا الحدّ في تقسيم النتائج إلى صفحات. القيمة التلقائية هي 500، وسيتم فرض القيمة 1000 على القيم التي تزيد عن 1000.

page_token

string

اختياريّ. الرمز المميز (إذا تم توفيره) لاسترداد الصفحة التالية يجب أن تتطابق جميع المَعلمات الأخرى مع الطلب الأصلي الذي قدّم رمز الصفحة.

ListQuotaGroupsResponse

رسالة الردّ على طريقة ListMethodGroups

الحقول

الحقول
`quota_groups[]`	`QuotaGroup` الطُرق والاستخدام الحالي للحصة والحدود لكل مجموعة تتم مشاركة الحصة بين جميع الطرق في المجموعة. يتم ترتيب المجموعات تنازليًا استنادًا إلى `quota_usage`.
`next_page_token`	`string` رمز مميز يمكن إرساله كـ `page_token` لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

quota_groups[]

QuotaGroup

الطُرق والاستخدام الحالي للحصة والحدود لكل مجموعة تتم مشاركة الحصة بين جميع الطرق في المجموعة. يتم ترتيب المجموعات تنازليًا استنادًا إلى quota_usage.

next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

MethodDetails

تفاصيل الطريقة لكل طريقة في CSS API

الحقول
`method`	`string` النتائج فقط. اسم الطريقة، على سبيل المثال `cssproductsservice.listcssproducts`
`version`	`string` النتائج فقط. إصدار واجهة برمجة التطبيقات الذي تنتمي إليه الطريقة.
`subapi`	`string` النتائج فقط. تمثّل هذه السمة واجهة برمجة التطبيقات الفرعية التي تنتمي إليها الطريقة. في CSS API، تكون القيمة دائمًا `css`.
`path`	`string` النتائج فقط. مسار الطريقة، مثل `v1/cssproductsservice.listcssproducts`

ProductDetail

تفاصيل المنتج

الحقول

الحقول
`section_name`	`string` عنوان القسم المستخدَم لتجميع مجموعة من تفاصيل المنتجات
`attribute_name`	`string` اسم تفاصيل المنتج.
`attribute_value`	`string` تمثّل هذه السمة قيمة تفاصيل المنتج.

section_name

string

عنوان القسم المستخدَم لتجميع مجموعة من تفاصيل المنتجات

attribute_name

string

اسم تفاصيل المنتج.

attribute_value

string

تمثّل هذه السمة قيمة تفاصيل المنتج.

ProductDimension

تمثّل هذه السمة حجم المنتج.

الحقول

الحقول
`value`	`double` الحقل مطلوب. تمثّل هذه السمة قيمة السمة كعدد. يمكن أن تتضمّن القيمة أربع خانات عشرية كحدّ أقصى.
`unit`	`string` الحقل مطلوب. وحدات السمة القيم المقبولة هي: * "`in`" * "`cm`"

value

double

الحقل مطلوب. تمثّل هذه السمة قيمة السمة كعدد. يمكن أن تتضمّن القيمة أربع خانات عشرية كحدّ أقصى.

unit

string

الحقل مطلوب. وحدات السمة القيم المقبولة هي: * "in" * "cm"

ProductWeight

تمثّل هذه السمة وزن المنتج.

الحقول

الحقول
`value`	`double` الحقل مطلوب. تمثّل هذه السمة قيمة الترجيح كرقم. يمكن أن تبلغ دقة الوزن أربع خانات عشرية كحدّ أقصى.
`unit`	`string` الحقل مطلوب. تمثّل هذه السمة وحدة الوزن. القيم المقبولة هي: * "`g`" * "`kg`" * "`oz`" * "`lb`"

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 ظهرًا بالتوقيت العالمي المتفق عليه.
`quota_limit`	`int64` النتائج فقط. الحدّ الأقصى لعدد المكالمات المسموح بها يوميًا للمجموعة
`quota_minute_limit`	`int64` النتائج فقط. الحدّ الأقصى لعدد المكالمات المسموح بها في الدقيقة للمجموعة
`method_details[]`	`MethodDetails` النتائج فقط. قائمة بجميع الطرق التي ينطبق عليها حصة المجموعة.

SubscriptionPeriod

تمثّل هذه السمة مدة اشتراك المنتج.

عمليات التعداد
`SUBSCRIPTION_PERIOD_UNSPECIFIED`	تشير إلى أنّ مدة الاشتراك غير محدّدة.
`MONTH`	تشير إلى أنّ مدة الاشتراك هي شهر.
`YEAR`	تشير إلى أنّ فترة الاشتراك هي سنة.

UpdateAccountLabelRequest

رسالة الطلب لطريقة UpdateAccountLabel

الحقول

الحقول
`account_label`	`AccountLabel` الحقل مطلوب. التصنيف المعدَّل يجب توفير جميع الحقول.

account_label

AccountLabel

الحقل مطلوب. التصنيف المعدَّل يجب توفير جميع الحقول.

UpdateAccountLabelsRequest

رسالة الطلب لطريقة UpdateLabels

الحقول

الحقول
`name`	`string` الحقل مطلوب. اسم مصدر التصنيف التنسيق: accounts/{account}
`label_ids[]`	`int64` قائمة بمعرّفات التصنيفات التي سيتم استبدال معرّفات تصنيفات الحسابات الحالية بها إذا كانت القائمة فارغة، سيتم حذف جميع أرقام تعريف التصنيفات المُخصّصة حاليًا.
`parent`	`string` اختياريّ. مطلوب فقط عند تعديل تصنيفات حساب Merchant Center ‫(MC). نطاق CSS الذي يمثّل المرجع الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

name

string

الحقل مطلوب. اسم مصدر التصنيف التنسيق: accounts/{account}

label_ids[]

int64

قائمة بمعرّفات التصنيفات التي سيتم استبدال معرّفات تصنيفات الحسابات الحالية بها إذا كانت القائمة فارغة، سيتم حذف جميع أرقام تعريف التصنيفات المُخصّصة حاليًا.

parent

string

اختياريّ. مطلوب فقط عند تعديل تصنيفات حساب Merchant Center ‫(MC). نطاق CSS الذي يمثّل المرجع الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

UpdateCssProductInputRequest

رسالة الطلب لطريقة 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 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الفهرس

AccountLabelsService

AccountsService

CssProductInputsService

CssProductsService

QuotaService

Account

AccountType

AccountLabel

LabelType

السمات

الشهادة

CreateAccountLabelRequest

CssProduct

CssProductInput

CssProductStatus

DestinationStatus

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

Package google.shopping.css.v1