REST Resource: accounts.products

المرجع: المنتج

المنتج الذي تمت معالجته، والذي تم إنشاؤه من [إدخالات المنتجات][[google.shopping.content.bundles.Products.ProductInput] متعددة بعد تطبيق القواعد ومصادر البيانات التكميلية. يتطابق هذا المنتج الذي تمت معالجته مع ما يظهر في حسابك على Merchant Center وفي إعلانات Shopping ومنصات Google الأخرى. يتم إنشاء كل منتج من إدخال واحد فقط لمصدر البيانات الأساسي، بالإضافة إلى إدخالات متعدّدة لمصدر البيانات التكميلية. بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.

تتطابق جميع الحقول في المنتج الذي تمت معالجته ورسائله الفرعية مع اسم السمة المقابلة لها في مواصفات بيانات المنتج مع بعض الاستثناءات.

تمثيل JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
الحقول
name

string

اسم المنتج تنسيق الملف: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

النتائج فقط. قناة المنتج.
offerId

string

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

string

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

string

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

string

النتائج فقط. مصدر البيانات الأساسي للمنتج.
attributes

object (Attributes)

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

object (CustomAttribute)

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

object (ProductStatus)

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

string (int64 format)

النتائج فقط. تُمثِّل هذه السمة الإصدار الحالي (حداثة) المنتج، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدة تعديلات في الوقت نفسه.

وفي حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إعادة الإدراج (مثلاً، إعادة تحميل المنتج بعد 30 يومًا) باستخدام versionNumber الحالي.

لا يتاح إلا للإدراج في مصادر البيانات الأساسية.

في حال منع العملية، سيتم طرح استثناء تم إلغاؤه.

السمات

السمات.

تمثيل JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": 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,
  "gtin": 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.
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)

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

object (Price)

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

boolean

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

string

الرقم التجاري العالمي للسلعة (رقم GTIN)
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)

عنوان منظَّم للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (AI)
structuredDescription

object (ProductStructuredDescription)

وصف منسَّق للأوصاف التي يتم إنشاؤها باستخدام خوارزميات (AI)

الأقساط

تشير هذه السمة إلى رسالة تمثّل الأقساط.

تمثيل 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
}
الحقول
programLabel

string

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

string

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

object (Price)

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

object (Price)

يشير هذا المصطلح إلى الأموال التي يمكن استخدامها لإجراء عمليات شراء في المستقبل.
loyaltyPoints

string (int64 format)

يشير هذا المقياس إلى عدد نقاط الولاء التي تم الحصول عليها مقابل عملية شراء.

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][google.shopping.content.bundles.Products.Shipping.min_handling_time] إلا مع سمة [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]، ولكنّها غير مطلوبة في حال توفّر سمة [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
maxHandlingTime

string (int64 format)

الحدّ الأقصى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه في أيام العمل. 0 تعني أنّه سيتم شحن الطلب في اليوم نفسه الذي تم استلامه فيه إذا تم ذلك قبل الموعد النهائي لطلب المنتجات. يجب توفير كلّ من [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] و[maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] في حال تقديم سرعات الشحن. تكون قيمة [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] اختيارية في حال توفّر سمة [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
minTransitTime

string (int64 format)

تمثّل هذه السمة الحدّ الأدنى لمدة النقل (شاملاً) بين وقت شحن الطلب ووقت تسليمه خلال أيام العمل. وتعني القيمة 0 أنّه يتم تسليم الطلب في اليوم نفسه الذي يتم شحنه فيه. يمكن استخدام [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] فقط مع سمة [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]، ولكنّها ليست مطلوبة في حال استخدام سمة [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].
maxTransitTime

string (int64 format)

الحدّ الأقصى لمدة النقل (شامل) بين وقت شحن الطلب ووقت تسليمه في أيام العمل وتعني القيمة 0 أنّه يتم تسليم الطلب في اليوم نفسه الذي يتم شحنه فيه. يجب توفير كلّ من [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] و[maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] في حال تقديم سرعات الشحن. تكون قيمة [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] اختيارية في حال توفّر سمة [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

FreeShippingThreshold

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

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

string

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

object (Price)

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

ShippingWeight

تمثّل هذه السمة وزن صندوق الشحن الخاص بالمنتج.

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

number

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

string

وحدة القيمة.

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

اضبط القيمة على "صحيح" إذا تم تحصيل الضريبة على الشحن.
locationId

string (int64 format)

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

string

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

UnitPricingMeasure

تمثّل هذه السمة طريقة تسعير الوحدات للمنتج.

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

number

تمثّل هذه السمة مقياسًا لعنصر.
unit

string

وحدة القياس.

UnitPricingBaseMeasure

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

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

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

number

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

number

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

string

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

شهادة الاعتماد

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

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

string

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

string

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

string

رقم الاعتماد. الحد الأقصى للطول هو 2,000 حرف.
certificationValue

string

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

ProductStructuredTitle

عنوان منظَّم للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (AI)

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

string

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

string

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

ProductStructuredDescription

وصف منسَّق للأوصاف التي يتم إنشاؤها باستخدام خوارزميات (AI)

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

string

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

string

الحد الأقصى للطول في نص الوصف هو 5,000 حرف.

ProductStatus

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

تمثيل 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 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
الحقول
reportingContext

enum (ReportingContextEnum)

اسم سياق الإبلاغ
approvedCountries[]

string

تمثّل هذه السمة قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تتم الموافقة على العرض فيها.
pendingCountries[]

string

قائمة برموز البلدان (ISO 3166-1 alpha-2) التي في انتظار الموافقة على العرض.
disapprovedCountries[]

string

تمثّل هذه السمة قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تم رفض العرض فيها.

ItemLevelIssue

تمثّل هذه السمة قيمة ItemLevelISSUE لحالة المنتج.

تمثيل JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
الحقول
code

string

رمز الخطأ للمشكلة
severity

enum (Severity)

كيفية تأثير هذه المشكلة في تقديم العرض
resolution

string

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

string

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

enum (ReportingContextEnum)

سياق إعداد التقارير الذي تنطبق عليه المشكلة
description

string

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

string

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

string

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

string

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

درجة الخطورة

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

عمليات التعداد
SEVERITY_UNSPECIFIED لم يتم تحديده.
NOT_IMPACTED تشير هذه المشكلة إلى تحذير وليس لها تأثير مباشر على المنتج.
DEMOTED يتم خفض ترتيب المنتج، ومن المرجّح أن يكون أداؤه محدودًا في نتائج البحث.
DISAPPROVED تؤدي المشكلة إلى رفض المنتج.

الطُرق

get

 يسترجع المنتج الذي تمت معالجته من حسابك في Merchant Center.

list

 يسرد المنتجات التي تمت معالجتها في حسابك على Merchant Center.