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)

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

string (Timestamp format)

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

string

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

string

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

object (HeadlineOfferInstallment)

تمثّل هذه السمة عدد الأقساط ومبلغها المطلوب دفعه مقابل سلعة.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

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

string

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

string (int64 format)

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

string

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

string

تمثّل هذه السمة عنوان السلعة.
description

string

وصف السلعة
brand

string

Product Related Attributes.[14-36] Brand of the item.
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)

السعر ممثَّلاً كرقم بوحدات ميكرو (مليون وحدة ميكرو تعادل وحدة واحدة من العملة العادية، على سبيل المثال، 1 دولار أمريكي = 1000000 وحدة ميكرو).
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.