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

تمثّل هذه السمة المشكلة على مستوى السلعة في حالة المنتج.

تمثيل 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.