تمت ترجمة هذه الصفحة بواسطة 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 (رسالة)

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/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.

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 إذا كان هناك إدخال يتضمّن محتوى اللغة والهوية وlabel الخلاصة ومعرّف الخلاصة نفسه، ستحلّ هذه الطريقة محلّ هذا الإدخال. بعد إدخال بيانات منتج في CSS أو تعديلها أو حذفها، قد يستغرق الأمر عدة دقائق قبل أن تتمكّن من استرداد منتج CSS الذي تمت معالجته. نطاقات التفويض يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/content` لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

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

بعد إدخال بيانات منتج في 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

نطاقات التفويض

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

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

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

CssProductsService

خدمة للحصول على منتجات 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/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/MC مجموعة CSS لنطاقات CSS، ونطاق CSS لحسابات Merchant Center لا يتم عرض هذا الحقل إلّا إذا كان لدى المستخدم إذن الوصول إلى الحساب الرئيسي. ملاحظة: بالنسبة إلى الحسابات الفرعية على Merchant Center، هذا هو أيضًا نطاق 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`	حساب MCA آخر في Merchant Center
`MC_STANDALONE`	حساب مستقل على Merchant Center
`MC_MCA_SUBACCOUNT`	الحساب الفرعي لحساب MCA في 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` قصة المنتج ويمكن استخدامها لتمثيل أنواع مقاسات مدمجة لملابس. يمكن تقديم نوعَين من أنواع المقاس بحد أقصى (راجِع [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` قائمة بالشهادات التي طالبت بها خدمة مقارنة الأسعار للمنتج المحدّد
`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` السمات ذات الصلة بالمنتج:‏[14-36] العلامة التجارية للسلعة
`mpn`	`string` رقم القطعة المحدّد من الشركة المصنّعة (MPN) للسلعة
`gtin`	`string` الرقم التجاري العالمي للسلعة (GTIN)
`google_product_category`	`string` فئة السلعة لدى Google (راجِع تصنيف المنتجات من Google). عند طلب البحث عن المنتجات، سيحتوي هذا الحقل على القيمة التي قدّمها المستخدم. لا تتوفّر حاليًا طريقة لاسترداد فئات منتجات Google المحدّدة تلقائيًا من خلال واجهة برمجة التطبيقات.
`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 لتجميع العناصر مخصّصةً في "حملة Shopping"
`custom_label_1`	`string` التصنيف المخصّص 1 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
`custom_label_2`	`string` التصنيف المخصّص 2 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
`custom_label_3`	`string` التصنيف المخصّص 3 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
`custom_label_4`	`string` التصنيف المخصّص 4 لتجميع العناصر في مجموعة مخصّصة في "حملة Shopping"

الشهادة

شهادة اعتماد المنتج استخدِم هذه السمة لوصف شهادات الاعتماد المرتبطة بمنتج معيَّن، مثل تقييمات كفاءة استهلاك الطاقة.

الحقول

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

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. نطاق CSS الذي يمثّل المورد الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

name

string

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

parent

string

اختياريّ. لا يكون مطلوبًا إلا عند استرداد معلومات حساب Merchant Center. نطاق CSS الذي يمثّل المورد الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

GetCssProductRequest

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

الحقول

الحقول
`name`	`string` مطلوب. اسم منتج CSS المطلوب استرجاعه

name

string

مطلوب. اسم منتج CSS المطلوب استرجاعه

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` في حال ضبط هذا الخيار، سيتم عرض حسابات MC التي تحمل معرّف التصنيف المحدّد فقط.
`full_name`	`string` في حال ضبطها، سيتم عرض حسابات MC التي تحمل الاسم المحدّد فقط (حساسة لحالة الأحرف).

ListChildAccountsResponse

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

الحقول

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

accounts[]

Account

حسابات CSS/Merchant Center التي تم عرضها للحساب الرئيسي المحدّد لخدمة 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` اختياريّ. يكون مطلوبًا فقط عند تعديل تصنيفات حسابات "مركز عملائي". نطاق CSS الذي يمثّل المورد الرئيسي لحساب Merchant Center. التنسيق: accounts/{account}

name

string

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

label_ids[]

int64

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

parent

string

اختياريّ. يكون مطلوبًا فقط عند تعديل تصنيفات حسابات "مركز عملائي". نطاق 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