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 لحسابات CSS/MC.

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

يجب توفير نطاق 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 أو حساب Merchant Center (MC) مجموعة 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 حساب 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

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