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)

النتائج فقط. قائمة بالسمات المخصّصة (التي يوفّرها CSS) ويمكن استخدامه أيضًا لإرسال أي سمة من مواصفات الخلاصة بصورتها العامة (على سبيل المثال، { "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
}
الحقول
lowPrice

object (Price)

السعر المنخفض للمنتج في CSS
highPrice

object (Price)

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

object (Price)

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

object (Price)

سعر المنتج الرئيسي في خدمة مقارنة الأسعار (CSS).
productTypes[]

string

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

string

قصة المنتج ويمكن استخدامها لتمثيل أنواع مقاسات مدمجة لملابس. يمكن تقديم نوعَين من أنواع المقاس بحد أقصى (راجِع [https://support.google.com/merchants/answer/6324497](نوع المقاس)).
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.
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

السمات ذات الصلة بالمنتج:‏[14-36] العلامة التجارية للسلعة
mpn

string

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

string

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

string

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

boolean

اضبط القيمة على true إذا كان المنتج موجّهًا إلى البالغين.
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 لتجميع العناصر مخصّصةً في "حملة Shopping"
customLabel1

string

التصنيف المخصّص 1 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
customLabel2

string

التصنيف المخصّص 2 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
customLabel3

string

التصنيف المخصّص 3 لتجميع العناصر بشكل مخصّص في "حملة Shopping"
customLabel4

string

التصنيف المخصّص 4 لتجميع العناصر في مجموعة مخصّصة في "حملة Shopping"

السعر

السعر ممثّلًا كرقم وعملة

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

string (int64 format)

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