REST Resource: accounts.cssProducts

المورد: CssProduct

المنتج في CSS الذي تمت معالجته

تمثيل JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
الحقول
name

string

اسم المنتج في CSS التنسيق: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

النتائج فقط. المعرّف الأولي الفريد للمنتج
contentLanguage

string

النتائج فقط. رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للمنتج.
feedLabel

string

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

object (Attributes)

النتائج فقط. قائمة بسمات المنتج
customAttributes[]

object (CustomAttribute)

النتائج فقط. قائمة بالسمات المخصّصة (التي توفّرها خدمة مقارنة الأسعار) ويمكن استخدامها أيضًا لإرسال أي سمة من مواصفات الخلاصة في شكلها العام (على سبيل المثال، { "name": "size type", "value": "regular" }). ويفيد ذلك في إرسال السمات التي لا تعرضها واجهة برمجة التطبيقات بشكل صريح، مثل السمات الإضافية المستخدَمة في برنامج "الشراء على Google".
cssProductStatus

object (CssProductStatus)

النتائج فقط. حالة المنتج ومشاكل التحقّق من البيانات، أي المعلومات حول منتج يتم احتسابها بشكل غير متزامن

السمات

سمات منتج CSS

تمثيل JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
الحقول
lowPrice

object (Price)

أدنى سعر للمنتج في CSS
highPrice

object (Price)

أعلى سعر للمنتج في CSS
headlineOfferPrice

object (Price)

السعر الرئيسي للمنتج في CSS
headlineOfferShippingPrice

object (Price)

السعر الرئيسي للمنتج في CSS
productTypes[]

string

فئات السلعة (يتم تنسيقها كما هو موضّح في مواصفات بيانات المنتجات).
sizeTypes[]

string

قصّة السلعة ويمكن استخدامها لتمثيل أنواع المقاسات المجمّعة لقطع الملابس. يمكن تقديم نوعَين من المقاسات كحدّ أقصى (يُرجى الاطّلاع على نوع المقاس).
productDetails[]

object (ProductDetail)

المواصفات الفنية أو تفاصيل المنتج الإضافية
productWeight

object (ProductWeight)

وزن المنتج بالوحدات المحدّدة يجب أن تتراوح القيمة بين 0 (غير شاملة) و2000 (شاملة).
productLength

object (ProductDimension)

طول المنتج بالوحدات المحدّدة يجب أن تتراوح القيمة بين 0 (غير شاملة) و3000 (شاملة).
productWidth

object (ProductDimension)

عرض المنتج بالوحدات المحدّدة يجب أن تتراوح القيمة بين 0 (غير شاملة) و3000 (شاملة).
productHeight

object (ProductDimension)

ارتفاع المنتج بالوحدات المحدّدة يجب أن تتراوح القيمة بين 0 (غير شاملة) و3000 (شاملة).
productHighlights[]

string

نقاط تعداد تصف أبرز اللمحات عن المنتج
certifications[]

object (Certification)

قائمة بالشهادات التي طلبتها خدمة مقارنة الأسعار للمنتج المحدّد
expirationDate

string (Timestamp format)

تاريخ انتهاء صلاحية السلعة، كما هو محدّد عند الإدراج، بتنسيق ISO 8601. يظهر تاريخ انتهاء الصلاحية الفعلي في productstatuses على أنّه googleExpirationDate وقد يكون في وقت سابق إذا كان expirationDate بعيدًا جدًا في المستقبل. ملاحظة: قد يستغرق حذف العنصر فعليًا يومَين أو أكثر من تاريخ انتهاء الصلاحية.
includedDestinations[]

string

قائمة الوجهات المطلوب تضمينها لهذا الهدف (تتطابق مع مربّعات الاختيار التي تم وضع علامة فيها في Merchant Center) يتم دائمًا تضمين الوجهات التلقائية ما لم تتم إضافتها ضمن excludedDestinations.

القيمتان المسموح بإدراجهما هما: - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

قائمة الوجهات المطلوب استبعادها من هذا الهدف (تتطابق مع مربّعات الاختيار التي لم يتم وضع علامة فيها في Merchant Center)

القيمتان المسموح بإدراجهما هما: - css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

عدد الأقساط ومبلغها مقابل سلعة معيّنة
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

عدد الفترات (بالأشهر أو السنوات) ومبلغ الدفعة لكل فترة لسلعة مرتبطة بعقد اشتراك
cppAdsRedirect

string

تسمح هذه السمة للمعلنين بإلغاء عنوان URL للسلعة عند عرض المنتج في سياق "إعلانات المنتجات".
numberOfOffers

string (int64 format)

عدد منتجات CSS
headlineOfferCondition

string

تشير هذه السمة إلى حالة المنتج في العرض الرئيسي.
title

string

عنوان السلعة
description

string

وصف السلعة
brand

string

سمات مرتبطة بالمنتج.[14-36] العلامة التجارية للسلعة.
mpn

string

رقم القطعة المحدّد من الشركة المصنّعة (MPN) للسلعة
gtin

string

الرقم التجاري العالمي للسلعة (GTIN)
googleProductCategory

string

فئة السلعة من Google (راجِع تصنيف المنتجات من Google). عند الاستعلام عن المنتجات، سيحتوي هذا الحقل على القيمة التي قدّمها المستخدم. لا تتوفّر حاليًا طريقة لاسترداد فئات المنتجات من Google التي تم تعيينها تلقائيًا من خلال واجهة برمجة التطبيقات.
adult

boolean

يجب ضبط هذه السمة على "صحيح" إذا كان المنتج يستهدف البالغين.
multipack

string (int64 format)

عدد المنتجات المتطابقة في حزمة من المنتج نفسه يحددها التاجر
isBundle

boolean

تشير إلى ما إذا كانت السلعة عبارة عن حزمة يحدّدها التاجر. الحزمة هي مجموعة مخصّصة من منتجات مختلفة يبيعها التاجر بسعر واحد.
ageGroup

string

الفئة العمرية التي تستهدفها السلعة
color

string

لون السلعة
gender

string

الجنس المستهدَف للسلعة
material

string

المادة التي تم صنع السلعة منها
pattern

string

تمثّل هذه السمة نمط السلعة (مثل منقّط).
size

string

مقاس السلعة يُسمح بقيمة واحدة فقط. بالنسبة إلى خيارات المنتج التي تختلف مقاساتها، أدرِج منتجًا منفصلاً لكل مقاس باستخدام قيمة itemGroupId نفسها (راجِع [https://support.google.com/merchants/answer/6324492](تعريف المقاس)).
sizeSystem

string

النظام الذي يتم فيه تحديد المقاس يُنصح باستخدامها لقطع الملابس.
itemGroupId

string

معرّف مشترك لكل خيارات المنتج نفسه
pause

string

سيتم إيقاف نشر هذا العنصر مؤقتًا.
customLabel0

string

التصنيف المخصّص 0 لتجميع السلع بشكل مخصّص في حملة تسوّق
customLabel1

string

التصنيف المخصّص 1 لتجميع السلع بشكل مخصّص في حملة تسوّق
customLabel2

string

التصنيف المخصّص 2 لتجميع السلع بشكل مخصّص في حملة تسوّق
customLabel3

string

التصنيف المخصّص 3 لتجميع السلع بشكل مخصّص في حملة تسوّق
customLabel4

string

التصنيف المخصّص 4 لتجميع السلع بشكل مخصّص في حملة تسوّق
reviewCount

string (int64 format)

عدد مراجعات المنتج مطلوبة في حال تقديم السمة rating.
minRating

string (int64 format)

الحدّ الأدنى لتقييم المنتج مطلوبة في حال تقديم السمة rating.
maxRating

string (int64 format)

الحد الأقصى لتقييم المنتج مطلوبة في حال تقديم السمة rating.
rating

number

متوسط تقييم المنتج يجب أن تكون القيمة ضمن النطاق [minRating, maxRating] (بما يشمل هذين الرقمَين). عند عرض هذا التقييم على صفحة المنتج، تتم تسويته إلى مقياس من [1 إلى 5] مع منزلة عشرية واحدة. في حال تقديم هذه السمة، يجب أيضًا تقديم سمات reviewCount وminRating وmaxRating.

السعر

السعر ممثَّل برقم وعملة

تمثيل JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
الحقول
amountMicros

string (int64 format)

السعر الممثَّل كرقم بوحدة Micro (مليون وحدة Micro تعادل وحدة العملة العادية، على سبيل المثال، دولار أمريكي واحد = 1, 000, 000 وحدة Micro).
currencyCode

string

تمثّل هذه السمة العملة المستخدمة للسعر باستخدام اختصارات مكوّنة من ثلاثة أحرف وفقًا للمعيار ISO 4217.

ProductDetail

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

تمثيل JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
الحقول
sectionName

string

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

string

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

string

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

ProductWeight

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

تمثيل JSON 
{
  "value": number,
  "unit": string
}
الحقول
value

number

الحقل مطلوب. الوزن ممثَّل كرقم. يمكن أن يكون للوزن دقة قصوى تبلغ أربع خانات عشرية.
unit

string

الحقل مطلوب. وحدة الوزن القيم المقبولة هي: * "g" * "kg" * "oz" * "lb"

ProductDimension

تمثّل هذه السمة أبعاد المنتج.

تمثيل JSON 
{
  "value": number,
  "unit": string
}
الحقول
value

number

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

string

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

الشهادة

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

تمثيل JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
الحقول
name

string

تمثّل هذه السمة اسم شهادة الاعتماد. في الوقت الحالي، القيمة الأكثر شيوعًا هي "EPREL"، وهي تمثّل شهادات اعتماد كفاءة استهلاك الطاقة في قاعدة بيانات تصنيف فئات استهلاك الطاقة (EPREL) الصادرة عن الاتحاد الأوروبي.
authority

string

تشير هذه السمة إلى الجهة أو الهيئة التي أصدرت شهادة الاعتماد. في الوقت الحالي، القيمة الأكثر شيوعًا هي "EC" أو "European_Commission" لتصنيفات استهلاك الطاقة في الاتحاد الأوروبي.
code

string

تمثّل هذه السمة رقم شهادة الاعتماد. على سبيل المثال، بالنسبة إلى شهادة EPREL التي تتضمّن الرابط https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456، يكون الرقم 123456. إنّ رقم الاعتماد مطلوب لتصنيفات استهلاك الطاقة الأوروبية.

HeadlineOfferInstallment

رسالة تمثّل قسطًا.

تمثيل JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
الحقول
months

string (int64 format)

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

object (Price)

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

object (Price)

المبلغ الذي يجب أن يسدّده المشتري مقدَّمًا كدفعة أولى

HeadlineOfferSubscriptionCost

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

تمثيل JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
الحقول
period

enum (SubscriptionPeriod)

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

string (int64 format)

عدد فترات الاشتراك التي يجب أن يدفع المشتري خلالها
amount

object (Price)

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

SubscriptionPeriod

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

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

CustomAttribute

رسالة تمثّل السمات المخصّصة يجب ألا تكون إحدى السمتَين value أو groupValues فارغة.

تمثيل JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
الحقول
groupValues[]

object (CustomAttribute)

السمات الفرعية ضمن مجموعة السمات هذه إذا لم يكن الحقل groupValues فارغًا، يجب أن يكون الحقل value فارغًا.
name

string

اسم السمة
value

string

قيمة السمة إذا لم يكن الحقل value فارغًا، يجب أن يكون الحقل groupValues فارغًا.

CssProductStatus

حالة منتج CSS ومشاكل التحقّق من صحة البيانات، أي معلومات حول منتج CSS التي يتم احتسابها بشكل غير متزامن

تمثيل JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
الحقول
destinationStatuses[]

object (DestinationStatus)

تمثّل هذه السمة الوجهات المقصودة للمنتج.
itemLevelIssues[]

object (ItemLevelIssue)

قائمة بجميع المشاكل المرتبطة بالمنتج
creationDate

string (Timestamp format)

تاريخ إنشاء السلعة، بتنسيق ISO 8601.
lastUpdateDate

string (Timestamp format)

تمثّل هذه السمة تاريخ آخر تعديل على السلعة، بتنسيق ISO 8601.
googleExpirationDate

string (Timestamp format)

تمثّل هذه السمة تاريخ انتهاء صلاحية السلعة، بتنسيق ISO 8601.

DestinationStatus

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

تمثيل JSON 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
الحقول
destination

string

اسم الوجهة
approvedCountries[]

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تمت الموافقة فيها على منتج CSS
pendingCountries[]

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) التي يكون فيها منتج CSS في انتظار الموافقة
disapprovedCountries[]

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تم فيها رفض منتج CSS

ItemLevelIssue

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

تمثيل JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
الحقول
code

string

رمز الخطأ الخاص بالمشكلة
servability

string

كيفية تأثير هذه المشكلة في عرض منتج CSS
resolution

string

ما إذا كان بإمكان التاجر حلّ المشكلة
attribute

string

اسم السمة، إذا كانت المشكلة ناتجة عن سمة واحدة
destination

string

الوجهة التي تنطبق عليها المشكلة
description

string

وصف موجز للمشكلة باللغة الإنجليزية
detail

string

وصف تفصيلي للمشكلة باللغة الإنجليزية
documentation

string

عنوان URL لصفحة ويب للمساعدة في حلّ هذه المشكلة
applicableCountries[]

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تنطبق فيها المشكلة على منتج CSS

الطُرق

get

 تستردّ هذه الطريقة منتج CSS الذي تمت معالجته من حسابك على CSS Center.

list

 تُدرج هذه الطريقة منتجات CSS التي تمت معالجتها في حسابك على CSS Center.