Attributes

السمات

تمثيل JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "gtin": [
    string
  ],
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
الحقول
expirationDate

string (Timestamp format)

التاريخ الذي ستنتهي فيه صلاحية العنصر، كما هو محدّد عند الإدراج، بتنسيق ISO 8601 يتم عرض تاريخ انتهاء الصلاحية الفعلي في productstatuses على أنّه googleExpirationDate، وقد يكون أقرب إذا كان expirationDate في فترة بعيدة جدًا في المستقبل.
disclosureDate

string (Timestamp format)

التاريخ والوقت اللذان يظهر فيهما العرض الترويجي في نتائج البحث على مساحات عرض YouTube من Google، بتنسيق ISO 8601 يُرجى الاطّلاع على [تاريخ الإفصاح]( https://support.google.com/merchants/answer/13034208) للحصول على مزيد من المعلومات.
availabilityDate

string (Timestamp format)

تمثّل هذه السمة اليوم الذي يصبح فيه منتج الطلب المُسبق متوفّرًا للتسليم، بتنسيق ISO 8601.
gtin[]

string

الأرقام التجارية العالمية للسلع (GTIN) للسلعة يمكنك تقديم ما يصل إلى 10 أرقام GTIN.
price

object (Price)

سعر السلعة
installment

object (Installment)

عدد الأقساط ومبلغها المستحقّة لدفع ثمن سلعة معيّنة
subscriptionCost

object (SubscriptionCost)

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

object (LoyaltyPoints)

نقاط الولاء التي يحصل عليها المستخدمون بعد شراء السلعة اليابان فقط
loyaltyPrograms[]

object (LoyaltyProgram)

قائمة بمعلومات برنامج الولاء التي تُستخدَم لعرض مزايا الولاء (مثل الأسعار الأفضل والنقاط وما إلى ذلك) لمستخدم هذا المنتج
productTypes[]

string

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

object (Price)

السعر المخفَّض المُعلَن عنه للسلعة.
salePriceEffectiveDate

object (Interval)

النطاق الزمني الذي تُعرض فيه السلعة للبيع بأسعار مُخفَّضة (اطّلِع على مواصفات بيانات المنتج).
productHeight

object (ProductDimension)

ارتفاع المنتج بالوحدات المقدَّمة يجب أن تتراوح القيمة بين 0 (باستثناء) و3000 (بما في ذلك).
productLength

object (ProductDimension)

طول المنتج بالوحدات المقدَّمة يجب أن تتراوح القيمة بين 0 (باستثناء) و3000 (بما في ذلك).
productWidth

object (ProductDimension)

عرض المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (باستثناء) و3000 (بما في ذلك).
productWeight

object (ProductWeight)

وزن المنتج بالوحدات المقدَّمة يجب أن تتراوح القيمة بين 0 (باستثناء) و2000 (بما في ذلك).
shipping[]

object (Shipping)

قواعد الشحن
freeShippingThreshold[]

object (FreeShippingThreshold)

الشروط التي يجب استيفاؤها لكي يكون الشحن مجانيًا للمنتج
shippingWeight

object (ShippingWeight)

وزن السلعة المراد شحنها
shippingLength

object (ShippingDimension)

طول السلعة المراد شحنها
shippingWidth

object (ShippingDimension)

عرض السلعة المراد شحنها
shippingHeight

object (ShippingDimension)

ارتفاع السلعة المراد شحنها
sizeTypes[]

string

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

object (Tax)

معلومات الضرائب
unitPricingMeasure

object (UnitPricingMeasure)

مقياس السلعة وأبعادها
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

الإعداد المفضّل لمقام سعر الوحدة.
adsLabels[]

string

يشبه adsGrouping، ولكنّه لا يعمل إلا على تكلفة النقرة.
costOfGoodsSold

object (Price)

تكلفة السلع المُباعة تُستخدَم لإعداد تقارير الأرباح الإجمالية.
productDetails[]

object (ProductDetail)

المواصفات الفنية أو تفاصيل المنتج الإضافية
productHighlights[]

string

نقاط تعداد نقطي تصف أهم تفاصيل المنتج
displayAdsSimilarIds[]

string

الاقتراحات التي يحدّدها المعلِنون
promotionIds[]

string

المعرّف الفريد للعرض الترويجي.
includedDestinations[]

string

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

string

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

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) لاستبعاد العرض من وجهة إعلانات Shopping تتم إزالة البلدان من هذه القائمة من البلدان التي تم ضبطها في إعدادات مصدر البيانات.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

حقول إضافية للتصدير إلى برنامج Cloud Retail
certifications[]

object (Certification)

شهادات المنتجات، مثل تصنيف كفاءة استهلاك الطاقة للمنتجات المسجّلة في قاعدة بيانات EPREL الخاصة بالاتحاد الأوروبي يُرجى الاطّلاع على مقالة مركز المساعدة للحصول على مزيد من المعلومات.
autoPricingMinPrice

object (Price)

إجراء وقائي في مشروعَي "الخصومات المبرمَجة" (https://support.google.com/merchants/answer/10295759) و"العروض الترويجية الديناميكية" (https://support.google.com/merchants/answer/13949249)، يضمن عدم انخفاض الخصومات على عروض التجّار عن هذه القيمة، ما يحافظ على قيمة العرض ومربحيته.
identifierExists

boolean

اضبط هذه القيمة على false عندما لا يتضمّن السلعة معرّفات منتجات فريدة مناسبة لفئة السلعة، مثل رقم GTIN ورقم القطعة المحدّد من الشركة المصنّعة والعلامة التجارية. يتم ضبط القيمة تلقائيًا على true (صحيح) في حال عدم تقديمها.
isBundle

boolean

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

string

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

string

وصف السلعة
adult

boolean

اضبط القيمة على true إذا كان المنتج موجّهًا إلى البالغين.
ageGroup

string

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

string

تشير هذه السمة إلى حالة توفّر السلعة.
brand

string

العلامة التجارية للسلعة
color

string

لون السلعة
condition

string

حالة السلعة
gender

string

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

string

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

string

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

string

المادة التي يتكون منها المنتج
mpn

string

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

string

نمط السلعة (مثل المنقّط)
sellOnGoogleQuantity

string (int64 format)

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

string (int64 format)

الحد الأقصى لوقت المناولة للمنتج (بالأيام)
minHandlingTime

string (int64 format)

الحد الأدنى لوقت المناولة للمنتج (بالأيام)
shippingLabel

string

تصنيف الحزمة للمنتج، والذي يُستخدَم لتجميع المنتجات في قواعد الشحن على مستوى الحساب
transitTimeLabel

string

تصنيف مدة النقل للمنتج، والذي يُستخدَم لتجميع المنتجات في جداول مدة النقل على مستوى الحساب
size

string

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

string

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

string

فئة الضريبة للمنتج، المستخدَمة لضبط قاعدة الضريبة التفصيلية في إعدادات الضريبة على مستوى الحساب.
energyEfficiencyClass

string

فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU
minEnergyEfficiencyClass

string

فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU
maxEnergyEfficiencyClass

string

فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU
multipack

string (int64 format)

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

string

تُستخدَم هذه السمة لتجميع السلع بطريقة عشوائية. يُنصح باستخدامها فقط مع النسبة المئوية لتكلفة الإجراء، ولا يُنصح باستخدامها بخلاف ذلك.
adsRedirect

string

يسمح للمعلِنين بإلغاء عنوان URL الخاص بالعنصر عند عرض المنتج في سياق "إعلانات المنتجات".
displayAdsId

string

معرّف سلعة لحملات تجديد النشاط التسويقي الديناميكي
displayAdsTitle

string

عنوان سلعة لحملات تجديد النشاط التسويقي الديناميكي.
displayAdsValue

number

تحديد هامش لحملات تجديد النشاط التسويقي الديناميكي
pickupMethod

string

خيار استلام السلعة
pickupSla

string

المخطط الزمني لاستلام السلعة في المتجر
customLabel0

string

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

string

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

string

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

string

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

string

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

string

سمة مطلوبة للحسابات المتعددة البائعين استخدِم هذه السمة إذا كنت تدير سوقًا لتحميل منتجات لبائعين مختلفين في حسابك المتعدد البائعين.
pause

string

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

object (ProductStructuredTitle)

العنوان المنظَّم، للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (الذكاء الاصطناعي)
structuredDescription

object (ProductStructuredDescription)

الوصف المنظَّم، للأوصاف التي يتم إنشاؤها آليًا (باستخدام الذكاء الاصطناعي)

التقسيط

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

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

string (int64 format)

عدد الأقساط التي يجب أن يدفعها المشتري.
amount

object (Price)

المبلغ الذي يدفعه المشتري شهريًا.
downpayment

object (Price)

المبلغ المُستحَقّ دفعه مقدّمًا كدفعة أولى على المشتري.
creditType

string

نوع دفعات الأقساط القيم المسموح بها هي: * "finance" * "lease"

SubscriptionCost

تكلفة الاشتراك في المنتج.

تمثيل 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 يشير إلى أنّ مدة الاشتراك هي سنة.

LoyaltyPoints

رسالة تمثّل نقاط الولاء

تمثيل JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
الحقول
name

string

اسم برنامج نقاط الولاء يُنصح بأن يقتصر الاسم على 12 حرفًا بالعرض الكامل أو 24 حرفًا رومانيًا.
pointsValue

string (int64 format)

نقاط الولاء الخاصة ببائع التجزئة بالقيمة المطلقة
ratio

number

هي النسبة المستخدَمة لنقطة عند تحويلها إلى عملة. تفترض Google العملة استنادًا إلى إعدادات Merchant Center. في حال عدم إدخال نسبة، يتم ضبطها تلقائيًا على 1.0.

LoyaltyProgram

رسالة تمثّل برنامج الولاء

تمثيل JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string,
  "memberPriceEffectiveDate": {
    object (Interval)
  },
  "shippingLabel": string
}
الحقول
programLabel

string

تصنيف برنامج الولاء هذه علامة داخلية تحدِّد بشكل فريد العلاقة بين عنصر التاجر وعنصر برنامج الولاء. يجب تقديم التصنيف ليتمكّن النظام من ربط مواد العرض أدناه (مثل السعر والنقاط) بالتاجر. يجب ربط البرنامج المقابل بحساب التاجر.
tierLabel

string

تصنيف الفئة ضمن برنامج الولاء يجب أن تتطابق مع أحد التصنيفات ضمن البرنامج.
price

object (Price)

السعر المخصّص للمشتركين في المستوى المحدّد، أي سعر الخصم الفوري. يجب أن يكون السعر المخفَّض أقل من السعر العادي أو مساوياً له.
cashbackForFutureUse

object (Price)

الأموال التي تم ردّها والتي يمكن استخدامها في عمليات الشراء المستقبلية
loyaltyPoints

string (int64 format)

عدد نقاط الولاء التي يتم الحصول عليها عند إجراء عملية شراء.
memberPriceEffectiveDate

object (Interval)

نطاق زمني يكون فيه العنصر مؤهلاً للاستفادة من سعر الاشتراك. وفي حال عدم تحديد سعر، يتم تطبيق سعر الاشتراك دائمًا. يتم تمثيل النطاق الزمني من خلال زوج من تواريخ ISO 8601 مفصولة بمسافة أو فاصلة أو شرطة مائلة.
shippingLabel

string

تصنيف ميزة الشحن إذا كان الحقل يحتوي على قيمة، يعني ذلك أنّ هذا العرض يتضمّن مزايا خدمة الشحن المحدّدة في برنامج الولاء. في حال عدم تقديم قيمة الحقل، لن يكون المنتج مؤهلاً للاستفادة من خدمة الشحن في برنامج الولاء لمستوى الولاء المحدّد.

ProductDimension

سمة سمات المنتج

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

number

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

string

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

ProductWeight

وزن المنتج

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

number

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

string

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

الشحن

شحن المنتج

تمثيل JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
الحقول
price

object (Price)

سعر الشحن الثابت، ممثّلاً برقم.
country

string

رمز CLDR للأقاليم للبلد الذي سيتم شحن السلعة إليه
region

string

المنطقة الجغرافية التي ينطبق عليها تعرفة الشحن راجِع المنطقة للحصول على مزيد من المعلومات.
service

string

وصف بأسلوب حر لفئة الخدمة أو سرعة التسليم
locationId

string (int64 format)

المعرّف الرقمي لموقع جغرافي ينطبق عليه تعرفة الشحن كما هو محدّد في AdWords API.
locationGroupName

string

الموقع الجغرافي الذي ينطبق عليه الشحن، ممثّلاً باسم مجموعة مواقع جغرافية.
postalCode

string

نطاق الرمز البريدي الذي ينطبق عليه تعرفة الشحن، ويمثّله رمز بريدي أو بادئة رمز بريدي متبوعة بحرف البدل * أو نطاق بين رمزَي بريديَين أو بادئتَي رمزَي بريديَين متساويَين الطول
minHandlingTime

string (int64 format)

الحد الأدنى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه بأيام العمل. يشير الرقم 0 إلى أنّه تم شحن الطلب في اليوم نفسه الذي تم استلامه فيه إذا حدث ذلك قبل الموعد النهائي. لا يمكن استخدام minHandlingTime إلا مع maxHandlingTime، ولكن ليس مطلوبًا استخدامه في حال توفّر maxHandlingTime.
maxHandlingTime

string (int64 format)

الحدّ الأقصى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه بأيام العمل. يشير الرقم 0 إلى أنّه تم شحن الطلب في اليوم نفسه الذي تم استلامه فيه إذا حدث ذلك قبل الموعد النهائي. يجب إدخال كلّ من maxHandlingTime وmaxTransitTime في حال تقديم سرعات الشحن. يكون minHandlingTime اختياريًا في حال توفّر maxHandlingTime.
minTransitTime

string (int64 format)

الحد الأدنى لمدة النقل (شاملة) بين وقت شحن الطلب ووقت تسليمه بأيام العمل. تشير القيمة 0 إلى أنّه يتم تسليم الطلب في اليوم نفسه الذي يتم فيه شحنه. لا يمكن استخدام minTransitTime إلا مع maxTransitTime، ولكن ليس مطلوبًا استخدامه في حال توفّر maxTransitTime.
maxTransitTime

string (int64 format)

الحد الأقصى لمدة النقل (شاملة) بين وقت شحن الطلب ووقت تسليمه بأيام العمل. تشير القيمة 0 إلى أنّه يتم تسليم الطلب في اليوم نفسه الذي يتم فيه شحنه. يجب إدخال كلّ من maxHandlingTime وmaxTransitTime في حال تقديم سرعات الشحن. يكون minTransitTime اختياريًا في حال توفّر maxTransitTime.

FreeShippingThreshold

الشروط التي يجب استيفاؤها لكي يكون الشحن مجانيًا للمنتج

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

string

رمز CLDR للأقاليم للبلد الذي سيتم شحن السلعة إليه
priceThreshold

object (Price)

الحد الأدنى لسعر المنتج لكي تصبح تكلفة الشحن مجانية يتم تمثيلها كرقم.

ShippingWeight

سمة ShippingWeight للمنتج

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

number

وزن المنتج المستخدَم لاحتساب تكلفة شحن السلعة
unit

string

وحدة القيمة.

ShippingDimension

سمة ShippingDimension للمنتج.

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

number

سمة أبعاد المنتج المستخدَمة لاحتساب تكلفة شحن السلعة
unit

string

وحدة القيمة.

الضريبة

ضريبة المنتج

تمثيل JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
الحقول
rate

number

النسبة المئوية لمعدّل الضريبة الذي ينطبق على سعر السلعة.
country

string

البلد الذي يتم فيه فرض ضرائب على السلعة، ويتم تحديده على أنّه رمز منطقة CLDR.
region

string

المنطقة الجغرافية التي تسري عليها نسبة الضريبة
taxShip

boolean

اضبط القيمة على true إذا كانت الضريبة تُفرض على الشحن.
locationId

string (int64 format)

المعرّف الرقمي لموقع جغرافي ينطبق عليه معدّل الضريبة كما هو محدّد في AdWords API.
postalCode

string

نطاق الرمز البريدي الذي ينطبق عليه معدّل الضريبة، ويمثّله رمز بريدي أو بادئة رمز بريدي باستخدام حرف البدل * أو نطاق بين رمزَي بريديَين أو بادئتَي رمزَي بريديَين متساويَين الطول. أمثلة: 94114، 94*، 94002-95460، 94*-95*.

UnitPricingMeasure

مقياس UnitPricingMeasure للمنتج.

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

number

قياس السلعة
unit

string

وحدة القياس

UnitPricingBaseMeasure

القياس الأساسي لسعر الوحدة للمنتج.

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

string (int64 format)

مقام سعر الوحدة.
unit

string

وحدة الجزء السفلي

ProductDetail

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

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

string

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

string

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

string

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

CloudExportAdditionalProperties

سمة المنتج لواجهة برمجة تطبيقات Cloud Retail API على سبيل المثال، يمكن أن تكون سمات منتج تلفزيوني هي "دقة الشاشة" أو "حجم الشاشة".

تمثيل JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
الحقول
textValue[]

string

القيمة النصية للسمة المحدّدة على سبيل المثال، يمكن أن تكون "8K(UHD)" قيمة نصية لمنتج تلفزيون. الحد الأقصى لمرات تكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ولكن متّسق. الحد الأقصى لحجم السلسلة هو 256 حرفًا.
intValue[]

string (int64 format)

القيم الصحيحة للسمة المحدّدة على سبيل المثال، 1080 لدقة شاشة منتج تلفزيوني. الحد الأقصى لمرات تكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ولكن متّسق.
floatValue[]

number

القيم العائمة للسمة المحدّدة على سبيل المثال، بالنسبة إلى منتج تلفزيوني، يكون الرقم 1.2345. الحد الأقصى لمرات تكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ولكن متّسق.
propertyName

string

اسم السمة المحدّدة على سبيل المثال، "درجة دقة الشاشة" لمنتج تلفزيون. الحد الأقصى لحجم السلسلة هو 256 حرفًا.
boolValue

boolean

القيمة المنطقية للسمة المحدّدة على سبيل المثال، بالنسبة إلى منتج تلفزيون، "صحيح" أو "خطأ" إذا كانت الشاشة بدقة فائقة للغاية.
minValue

number

الحد الأدنى لقيمة عدد عشري للسمة المحدّدة. على سبيل المثال، بالنسبة إلى منتج تلفزيوني، يكون الرقم 1.00.
maxValue

number

الحد الأقصى للقيمة العائمة للسمة المحدّدة. على سبيل المثال، 100.00 لتلفزيون.
unitCode

string

وحدة الموقع المحدّد. على سبيل المثال، "وحدات البكسل" لمنتج تلفزيون. الحد الأقصى لحجم السلسلة هو 256 بايت.

الشهادة

شهادة اعتماد المنتج، التي تم تقديمها في البداية للامتثال لتصنيف كفاءة استهلاك الطاقة في الاتحاد الأوروبي باستخدام قاعدة بيانات EPREL في الاتحاد الأوروبي

تمثيل JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
الحقول
certificationAuthority

string

هيئة إصدار الشهادات، مثل "European_Commission" الحد الأقصى للطول هو 2000 حرف.
certificationName

string

اسم شهادة الاعتماد، مثل EPREL الحد الأقصى للطول هو 2000 حرف.
certificationCode

string

رقم شهادة الاعتماد الحد الأقصى للطول هو 2000 حرف.
certificationValue

string

قيمة شهادة الاعتماد (المعروفة أيضًا باسم الفئة أو المستوى أو الدرجة)، على سبيل المثال "A+" أو "C" أو "الذهبي" الحد الأقصى للطول هو 2000 حرف.

ProductStructuredTitle

العنوان المنظَّم، للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (الذكاء الاصطناعي)

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

string

نوع المصدر الرقمي، على سبيل المثال "trained_algorithmic_media" اتّباع معايير IPTC الحد الأقصى للطول هو 40 حرفًا.
content

string

الحد الأقصى لطول نص العنوان هو 150 حرفًا.

ProductStructuredDescription

الوصف المنظَّم، للأوصاف التي يتم إنشاؤها آليًا (باستخدام الذكاء الاصطناعي)

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

string

نوع المصدر الرقمي، على سبيل المثال "trained_algorithmic_media" اتّباع معايير IPTC الحد الأقصى للطول هو 40 حرفًا.
content

string

الحد الأقصى لطول نص الوصف هو 5000 حرف.