Package google.shopping.css.v1

الفهرس

AccountLabelsService

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

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

تنشئ هذه الطريقة تصنيفًا جديدًا غير مخصّص لأي حساب.

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

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

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

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

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

يحذف تصنيفًا ويزيله من جميع الحسابات التي تمّ تعيينه لها.

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

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

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

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

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

تعرض هذه الطريقة قائمة بالتصنيفات التي يملكها حساب.

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

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

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

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

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

تعديل تصنيف

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

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

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

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

AccountsService

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

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

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

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

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

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

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

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

تعرض هذه الطريقة جميع الحسابات ضِمن رقم تعريف حساب CSS المحدّد، ويمكنها اختياريًا الفلترة حسب رقم تعريف التصنيف واسم الحساب.

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

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

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

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

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

تعديل التصنيفات المخصّصة لحسابات CSS/MC حسب نطاق CSS

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

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

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

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

CssProductInputsService

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

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
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.
UpdateCssProductInput

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

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

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

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

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

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

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

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
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_ads_redirect

string

تسمح هذه السمة للمعلِنين بتجاهل عنوان URL الخاص بالسلعة عندما يتم عرض المنتج في سياق "إعلانات المنتجات".
number_of_offers

int64

تمثّل هذه السمة عدد المنتجات في CSS.
headline_offer_condition

string

تمثّل هذه السمة حالة المنتج في العرض الرئيسي.
title

string

تمثّل هذه السمة عنوان السلعة.
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. إنّ رقم الاعتماد مطلوب لتصنيفات الطاقة الأوروبية.

CreateAccountLabelRequest

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

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

DeleteCssProductInputRequest

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

الحقول
name

string

الحقل مطلوب. اسم مورد إدخال منتج CSS المطلوب حذفه. التنسيق: accounts/{account}/cssProductInputs/{css_product_input}، حيث يتألف القسم الأخير css_product_input من 3 أجزاء: contentLanguage~feedLabel~offerId. مثال: accounts/123/cssProductInputs/de~DE~rawProvidedId123
supplemental_feed_id

int64

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

GetAccountRequest

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

الحقول
name

string

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

string

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

GetCssProductRequest

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

الحقول
name

string

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

HeadlineOfferInstallment

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

الحقول
months

int64

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

Price

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

Price

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

HeadlineOfferSubscriptionCost

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

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

ListAccountLabelsRequest

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

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

ListCssProductsRequest

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

ListQuotaGroupsRequest

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

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

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

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

ProductDimension

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

الحقول
value

double

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

string

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

ProductWeight

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

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

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

UpdateAccountLabelsRequest

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

الحقول
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) بالكامل غير متاح.