الفهرس
ProductInputsService
(واجهة)ProductsService
(واجهة)Attributes
(رسالة)Certification
(رسالة)CloudExportAdditionalProperties
(رسالة)DeleteProductInputRequest
(رسالة)FreeShippingThreshold
(رسالة)GetProductRequest
(رسالة)InsertProductInputRequest
(رسالة)Installment
(رسالة)ListProductsRequest
(رسالة)ListProductsResponse
(رسالة)LoyaltyPoints
(رسالة)LoyaltyProgram
(رسالة)Product
(رسالة)ProductDetail
(رسالة)ProductDimension
(رسالة)ProductInput
(رسالة)ProductStatus
(رسالة)ProductStatus.DestinationStatus
(رسالة)ProductStatus.ItemLevelIssue
(رسالة)ProductStatus.ItemLevelIssue.Severity
(تعداد)ProductStructuredDescription
(رسالة)ProductStructuredTitle
(رسالة)ProductWeight
(رسالة)Shipping
(رسالة)ShippingDimension
(رسالة)ShippingWeight
(رسالة)SubscriptionCost
(رسالة)SubscriptionPeriod
(تعداد)Tax
(رسالة)UnitPricingBaseMeasure
(رسالة)UnitPricingMeasure
(رسالة)
ProductInputsService
خدمة لاستخدام مورد ProductInput. هذه الخدمة متاحة فقط للمنتجات المتوفّرة على الإنترنت.
DeleteProductInput |
---|
يتم حذف إدخال منتج من حسابك على Merchant Center. بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
|
InsertProductInput |
---|
تحمّل إدخال منتج إلى حسابك على Merchant Center. في حال توفُّر مُدخل يتضمّن contentLanguage و offerId وdataSource نفسهما، ستحلّ هذه الطريقة محلّ هذا الإدخال. بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
|
ProductsService
خدمة لاستخدام مورد المنتج. هذه الخدمة متاحة فقط للمنتجات المتوفّرة على الإنترنت.
GetProduct |
---|
يسترجع المنتج الذي تمت معالجته من حسابك في Merchant Center. بعد إدخال بيانات منتج أو تعديلها أو حذفها، قد يستغرق استرداد المنتج النهائي عدّة دقائق.
|
ListProducts |
---|
يسرد المنتجات التي تمت معالجتها في حسابك على Merchant Center. قد تحتوي الاستجابة على عناصر أقل مما هو محدّد حسب pageSize. اعتمِد على pageToken لتحديد ما إذا كان هناك المزيد من العناصر المطلوبة. بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
|
السمات
السمات.
الحقول | |
---|---|
additional_image_links[] |
عناوين URL إضافية لصور السلعة |
expiration_date |
تمثّل هذه السمة تاريخ انتهاء صلاحية السلعة، على النحو المحدّد عند الإدراج، بالتنسيق ISO 8601. يتم عرض تاريخ انتهاء الصلاحية الفعلي في |
disclosure_date |
تمثّل هذه السمة التاريخ والوقت الذي يظهر فيه العرض في نتائج البحث على مساحات عرض YouTube في Google، بالتنسيق ISO 8601. يمكنك الاطّلاع على [تاريخ الإفصاح]( https://support.google.com/merchants/answer/13034208) لمزيد من المعلومات. |
availability_date |
تمثّل هذه السمة اليوم الذي يصبح فيه المنتج الذي تم طلبه مسبقًا متوفرًا للتسليم بتنسيق ISO 8601. |
price |
سعر السلعة |
installment |
تمثّل هذه السمة عدد الأقساط والمبلغ المطلوب دفعه مقابل سلعة. |
subscription_cost |
عدد المُدد (الأشهر أو السنوات) ومبلغ الدفع لكل فترة مقابل سلعة مرتبطة بعقد اشتراك |
loyalty_points |
نقاط الولاء التي يحصل عليها المستخدمون بعد شراء السلعة. في اليابان فقط. |
loyalty_programs[] |
هي قائمة بمعلومات برنامج الولاء تُستخدَم لعرض مزايا برنامج الولاء (على سبيل المثال، تحسين الأسعار والنقاط وغير ذلك) لمستخدم هذه السلعة. |
product_types[] |
فئات السلعة (بتنسيق مواصفات بيانات المنتج) |
sale_price |
السعر المخفَّض المُعلَن عنه للسلعة. |
sale_price_effective_date |
النطاق الزمني الذي تكون فيه السلعة معروضة للبيع (راجِع مواصفات بيانات المنتج) |
product_height |
تمثّل هذه السمة ارتفاع المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل). |
product_length |
طول المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل). |
product_width |
تمثّل هذه السمة عرض المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل). |
product_weight |
تمثّل هذه السمة وزن المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و2000 (شامل). |
shipping[] |
قواعد الشحن |
free_shipping_threshold[] |
الشروط التي يجب استيفاؤها لتوفير شحن مجاني للمنتج. |
shipping_weight |
وزن السلعة للشحن |
shipping_length |
طول السلعة للشحن |
shipping_width |
عرض السلعة للشحن |
shipping_height |
ارتفاع السلعة للشحن |
size_types[] |
قصّة السلعة ويمكن استخدامها لتمثيل أنواع المقاسات المجمّعة لسلع الملابس. يمكن تقديم نوعَين كحدّ أقصى من أنواع المقاسات (يُرجى الاطّلاع على [https://support.google.com/merchants/answer/6324497](نوع المقاس)). |
taxes[] |
معلومات الضرائب |
unit_pricing_measure |
مقياس وأبعاد المنتج. |
unit_pricing_base_measure |
تمثّل هذه السمة تفضيل المقام لسعر الوحدة. |
ads_labels[] |
يشبه الأمر ads_grouping، ولكنه يعمل فقط مع تكلفة النقرة. |
cost_of_goods_sold |
تكلفة السلع المُباعة. يتم استخدامه لإعداد تقارير حول الأرباح الإجمالية. |
product_details[] |
المواصفات الفنية أو تفاصيل إضافية للمنتج |
product_highlights[] |
نقاط تعداد تصف أهم التفاصيل عن المنتج |
display_ads_similar_ids[] |
الاقتراحات التي يحدّدها المعلِن: |
promotion_ids[] |
المعرّف الفريد لعرض ترويجي. |
included_destinations[] |
قائمة الوجهات المطلوب تضمينها لهذا الهدف (تتوافق مع مربّعات الاختيار المحدّدة في Merchant Center) يتم دائمًا تضمين الوجهات التلقائية ما لم يتم توفيرها في |
excluded_destinations[] |
قائمة الوجهات المطلوب استبعادها لهذا الهدف (تتوافق مع مربّعات الاختيار غير المحدّدة في Merchant Center). |
shopping_ads_excluded_countries[] |
قائمة برموز البلدان (وفقًا لمعيار ISO 3166-1 alpha-2) لاستبعاد العرض من وجهة "إعلانات Shopping". تتم إزالة البُلدان من هذه القائمة من البلدان التي تم ضبطها في إعدادات مصدر البيانات. |
lifestyle_image_links[] |
عناوين URL إضافية لصور نمط الحياة للسلعة، يتم استخدامها لتحديد الصور التي تعرض السلعة في سياق واقعي. يمكنك الاطّلاع على مقالة مركز المساعدة لمعرفة مزيد من المعلومات. |
cloud_export_additional_properties[] |
حقول إضافية للتصدير إلى برنامج Cloud Retail |
certifications[] |
شهادات المنتجات، على سبيل المثال، لتصنيف كفاءة استهلاك الطاقة للمنتجات المسجّلة في قاعدة بيانات EU EPREL يمكنك الاطّلاع على مقالة مركز المساعدة للحصول على مزيد من المعلومات. |
auto_pricing_min_price |
حماية في "الخصومات التلقائية" (https://support.google.com/merchants/answer/10295759) و"العروض الترويجية الديناميكية" (https://support.google.com/merchants/answer/13949249) ما يضمن تقديم خصومات على أسعار التجّار عدم انخفاض عروض الأسعار عن هذه القيمة، وبالتالي يحافظ على قيمة العرض وربحيته. |
identifier_exists |
اضبط هذه القيمة على "خطأ" عندما لا تحتوي السلعة على معرّفات منتجات فريدة مناسبة لفئتها، مثل رقم GTIN ورقم القطعة المحدّد من الشركة المصنّعة والعلامة التجارية. وتكون القيم التلقائية القيمة "صحيح"، إذا لم يتم توفيرها. |
is_bundle |
ما إذا كانت السلعة حزمة يحدّدها التاجر الحزمة هي مجموعة مخصّصة تضمّ منتجات مختلفة يبيعها تاجر بسعر واحد. |
title |
عنوان السلعة |
description |
وصف السلعة |
link |
عنوان URL ينقل مباشرةً إلى صفحة السلعة في متجرك على الإنترنت |
mobile_link |
عنوان URL للإصدار المحسَّن للأجهزة الجوّالة من الصفحة المقصودة لسلعتك. |
canonical_link |
هو عنوان URL للنسخة الأساسية من الصفحة المقصودة الخاصة بسلعتك. |
image_link |
عنوان URL لصورة السلعة. |
adult |
اضبط القيمة على "true" إذا كان العنصر يستهدف البالغين. |
age_group |
استهداف الفئة العمرية للسلعة. |
availability |
حالة توفّر السلعة. |
brand |
العلامة التجارية للسلعة. |
color |
لون السلعة |
condition |
حالة السلعة أو حالتها |
gender |
الجنس المستهدف للعنصر |
google_product_category |
تمثّل هذه السمة فئة السلعة في Google (راجِع تصنيف المنتج من Google). عند طلب البحث عن منتجات، سيتضمن هذا الحقل القيمة التي قدمها المستخدم. ليست هناك حاليًا طريقة لاستعادة فئات منتجات Google التي تم تحديدها تلقائيًا من خلال واجهة برمجة التطبيقات. |
gtin |
الرقم التجاري العالمي للسلعة (GTIN) |
item_group_id |
معرّف مشترك لكل خيارات المنتج نفسه |
material |
تمثّل هذه السمة المادة التي صُنعت منها السلعة. |
mpn |
هو رقم القطعة المحدّد من الشركة المصنّعة (MPN) للسلعة |
pattern |
نمط العنصر (على سبيل المثال، منقّط). |
sell_on_google_quantity |
كمية المنتج المتاحة للبيع على Google يُسمَح به فقط للمنتجات التي تظهر على الإنترنت. |
max_handling_time |
الحدّ الأقصى لوقت مناولة المنتجات (بأيام العمل). |
min_handling_time |
الحدّ الأدنى لوقت مناولة المنتجات (بأيام العمل) |
shipping_label |
تشير هذه السمة إلى تصنيف حزمة المنتج، ويتم استخدامه لتجميع المنتج في قواعد الشحن على مستوى الحساب. |
transit_time_label |
تصنيف مدة النقل للمنتج، ويُستخدَم لتجميع المنتج في جداول زمنية على مستوى الحساب للنقل |
size |
مقاس السلعة يُسمح بقيمة واحدة فقط. بالنسبة إلى خيارات المنتج بمقاسات مختلفة، أدخِل منتجًا منفصلاً لكل مقاس يتضمّن قيمة |
size_system |
النظام الذي يتم تحديد الحجم فيه. مُقترَحة لسلع الملابس. |
tax_category |
فئة الضريبة للمنتج، وتُستخدم لضبط وجودة ضريبية تفصيلية في إعدادات الضريبة على مستوى الحساب. |
energy_efficiency_class |
تمثّل هذه السمة فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU. |
min_energy_efficiency_class |
تمثّل هذه السمة فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU. |
max_energy_efficiency_class |
تمثّل هذه السمة فئة كفاءة استهلاك الطاقة على النحو المحدّد في توجيه الاتحاد الأوروبي 2010/30/EU. |
multipack |
عدد المنتجات المتطابقة في حزمة منتجات يحدّدها التاجر |
ads_grouping |
تُستخدَم لتجميع العناصر بطريقة عشوائية. وبالنسبة إلى نسبة تكلفة الإجراء فقط، لا يُنصح باستخدامها في الحالات الأخرى. |
ads_redirect |
تسمح للمعلنين بإلغاء عنوان URL للسلعة عند عرض المنتج في سياق إعلانات المنتج. |
display_ads_id |
معرّف لعنصر في حملات تجديد النشاط التسويقي الديناميكي |
display_ads_title |
عنوان سلعة لحملات تجديد النشاط التسويقي الديناميكي |
display_ads_link |
عنوان URL مباشرةً إلى الصفحة المقصودة للسلعة في حملات تجديد النشاط التسويقي الديناميكي. |
display_ads_value |
قدِّم هامشًا لحملات تجديد النشاط التسويقي الديناميكي. |
pickup_method |
خيار استلام السلعة |
pickup_sla |
المخطط الزمني لاستلام السلعة من المتجر |
link_template |
نموذج رابط لواجهة محلّ مجاور يستضيفها تاجر |
mobile_link_template |
نموذج رابط لواجهة محلّ مجاور يستضيفها تاجر محسّن للأجهزة الجوّالة. |
custom_label_0 |
التصنيف المخصّص 0 لتجميع العناصر المخصّص في حملة Shopping. |
custom_label_1 |
التصنيف المخصّص 1 لتجميع العناصر المخصّصة في حملة Shopping. |
custom_label_2 |
التصنيف المخصّص 2 لتجميع العناصر المخصّصة في حملة Shopping. |
custom_label_3 |
تصنيف مخصّص 3 لتجميع السلع المخصّص في حملة Shopping |
custom_label_4 |
التصنيف المخصّص 4 لتجميع العناصر المخصّص في حملة Shopping. |
external_seller_id |
هذا الحقل مطلوب للحسابات المتعددة البائعين. استخدِم هذه السمة إذا كنت تدير سوقًا تحمِّل منتجات لبائعين مختلفين في حسابك المتعدد البائعين. |
pause |
سيتم إيقاف نشر هذا العنصر مؤقتًا. |
virtual_model_link |
عنوان URL للصورة الثلاثية الأبعاد للسلعة. يمكنك الاطّلاع على مقالة مركز المساعدة لمعرفة مزيد من المعلومات. |
structured_title |
عنوان منظَّم للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (AI) |
structured_description |
وصف منسَّق للأوصاف التي يتم إنشاؤها باستخدام خوارزميات (AI) |
الشهادة
شهادة المنتج: تم طرحها في البداية للتأكّد من الامتثال لتصنيفات كفاءة استهلاك الطاقة في الاتحاد الأوروبي باستخدام قاعدة بيانات EPREL الخاصة بالاتحاد الأوروبي.
الحقول | |
---|---|
certification_authority |
هيئة إصدار الشهادات، مثل European_Commission. الحد الأقصى للطول هو 2,000 حرف. |
certification_name |
تعرض هذه السمة اسم شهادة الاعتماد، مثل EPREL. الحد الأقصى للطول هو 2,000 حرف. |
certification_code |
رقم الاعتماد. الحد الأقصى للطول هو 2,000 حرف. |
certification_value |
قيمة الشهادة (المعروفة أيضًا باسم الفئة أو المستوى أو الدرجة)، على سبيل المثال "+A" و"C" و"المستوى الذهبي" الحد الأقصى للطول هو 2,000 حرف. |
CloudExportAdditionalProperties
موقع المنتج في Cloud Retail API على سبيل المثال، يمكن أن تكون خصائص منتج تلفزيون هي "درجة دقة الشاشة". أو "حجم الشاشة"
الحقول | |
---|---|
text_value[] |
القيمة النصية للسمة المحدّدة. على سبيل المثال، "8K(UHD)" يمكن أن يكون قيمة نصية لمنتج تلفزيون. الحد الأقصى لتكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ومتسق. يبلغ الحد الأقصى لحجم السلسلة 256 حرفًا. |
int_value[] |
القيم الصحيحة للسمة المحدّدة. على سبيل المثال، 1080 لدرجة دقة شاشة منتج تلفزيون. الحد الأقصى لتكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ومتسق. |
float_value[] |
قيم عائمة للسمة المحددة. على سبيل المثال، لمنتج التلفزيون 1.2345. الحد الأقصى لتكرار هذه القيمة هو 400. يتم تخزين القيم بترتيب عشوائي ومتسق. |
property_name |
اسم الموقع المحدّد. على سبيل المثال، "درجة دقة الشاشة" لمنتج التلفزيون. يبلغ الحد الأقصى لحجم السلسلة 256 حرفًا. |
bool_value |
القيمة المنطقية للسمة المحدّدة. على سبيل المثال، بالنسبة إلى منتج التلفزيون، "True" أو "خطأ" إذا كانت الشاشة بدقة فائقة |
min_value |
الحدّ الأدنى للقيمة العائمة للسمة المحدّدة. على سبيل المثال، منتج التلفزيون 1.00. |
max_value |
الحدّ الأقصى للقيمة العائمة للسمة المحدّدة. على سبيل المثال، منتج تلفزيون 100.00. |
unit_code |
وحدة الموقع المحدّد. على سبيل المثال، "Pixel" لمنتج التلفزيون. الحد الأقصى لحجم السلسلة هو 256 بايت. |
DeleteProductInputRequest
طلب رسالة لطريقة DeleteProductInput.
الحقول | |
---|---|
name |
مطلوب. اسم مورد إدخال المنتج المطلوب حذفه. التنسيق: accounts/{account}/productInputs/{product} |
data_source |
مطلوب. مصدر البيانات الأساسي أو التكميلي الذي يجب حذف إدخال المنتج منه التنسيق: |
FreeShippingThreshold
الشروط التي يجب استيفاؤها لتوفير شحن مجاني للمنتج.
الحقول | |
---|---|
country |
رمز CLDR للمنطقة للبلد الذي سيتم شحن سلعة إليه. |
price_threshold |
تمثّل هذه السمة الحدّ الأدنى لسعر المنتج لتصبح تكلفة الشحن مجانية. يتم تمثيلها كرقم. |
GetProductRequest
اطلب رسالة بشأن طريقة GetProduct.
الحقول | |
---|---|
name |
مطلوب. تمثّل هذه السمة اسم المنتج الذي تريد استرداده. تنسيق الملف: |
InsertProductInputRequest
طلب رسالة لطريقة InsertProductInput.
الحقول | |
---|---|
parent |
مطلوب. تمثّل هذه السمة الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account} |
product_input |
مطلوب. إدخال المنتج المطلوب إدراجه. |
data_source |
مطلوب. اسم مصدر بيانات المنتجات الأساسي أو التكميلي إذا كان المنتج متوفّرًا من قبل وكان مصدر البيانات المقدَّم مختلفًا، سيتم نقل المنتج إلى مصدر بيانات جديد. التنسيق: |
التقسيط
تشير هذه السمة إلى رسالة تمثّل الأقساط.
الحقول | |
---|---|
months |
تمثّل هذه السمة عدد الأقساط المترتّبة على المشتري. |
amount |
المبلغ المترتّب على المشتري شهريًا. |
downpayment |
تمثّل هذه السمة مبلغ الدفعة الأولى التي يجب أن يدفعها المشتري. |
credit_type |
تمثّل هذه السمة نوع دفعات الأقساط. القيمتان المسموح بإدراجهما هما: * " |
ListProductsRequest
اطلب رسالة لطريقة ListProducts.
الحقول | |
---|---|
parent |
مطلوب. الحساب المطلوب إدراج المنتجات التي تمت معالجتها له التنسيق: accounts/{account} |
page_size |
تمثّل هذه السمة الحدّ الأقصى لعدد المنتجات المطلوب إرجاعها. قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000؛ سيتم فرض القيم الأكبر من 1000 على 1000. وفي حال عدم تحديد قيمة هذه السمة، سيتم إرجاع الحد الأقصى لعدد المنتجات. |
page_token |
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق " عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
ListProductsResponse
رسالة ردّ على طريقة ListProducts.
الحقول | |
---|---|
products[] |
المنتجات التي تمت معالجتها من الحساب المحدّد هذه هي منتجاتك التي تمت معالجتها بعد تطبيق القواعد ومصادر البيانات التكميلية. |
next_page_token |
رمز مميز يمكن إرساله على شكل |
LoyaltyPoints
تشير هذه السمة إلى رسالة تمثّل نقاط الولاء.
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم برنامج نقاط الولاء. ويوصى بألا يزيد الاسم عن 12 حرفًا بالعرض الكامل أو 24 حرفًا رومانيًا. |
points_value |
نقاط الولاء لبائع التجزئة في القيمة المطلقة. |
ratio |
يشير ذلك المصطلح إلى نسبة النقطة عند تحويلها إلى عملة. تفترض Google العملة بناءً على إعدادات Merchant Center. وإذا تم استبعاد النسبة، سيتم ضبط القيمة التلقائية على 1.0. |
LoyaltyProgram
رسالة تمثّل برنامج الولاء.
الحقول | |
---|---|
program_label |
تمثّل هذه السمة تصنيف برنامج الولاء. هذا تصنيف داخلي يعرّف بشكل فريد العلاقة بين كيان التاجر وكيان برنامج الولاء. يجب تقديم التصنيف ليتمكّن النظام من ربط مواد العرض أدناه (مثل السعر والنقاط) بالتاجر. يجب أن يكون البرنامج المقابل مرتبطًا بحساب التاجر. |
tier_label |
تمثّل هذه السمة تصنيف الفئة ضمن برنامج الولاء. يجب أن يتطابق مع أحد التصنيفات في البرنامج. |
price |
تشير هذه السمة إلى السعر المخصّص للمشتركين في الفئة المحدّدة، أي السعر المخفَّض الفوري. يجب أن تكون القيمة أصغر من أو يساوي السعر العادي. |
cashback_for_future_use |
يشير هذا المصطلح إلى الأموال التي يمكن استخدامها لإجراء عمليات شراء في المستقبل. |
loyalty_points |
يشير هذا المقياس إلى عدد نقاط الولاء التي تم الحصول عليها مقابل عملية شراء. |
member_price_effective_date |
هو نطاق زمني يكون فيه المنتج مؤهَّلاً للحصول على السعر المخصّص للمشتركين. إذا لم يتم تحديد السعر المخصّص للمشتركين، يكون السعر الساري متاحًا دائمًا. يتم تمثيل النطاق الزمني بزوج من تواريخ ISO 8601 مفصولاً بمسافة أو فاصلة أو شرطة مائلة. |
المنتج
المنتج الذي تمت معالجته، والذي تم إنشاؤه من [إدخالات المنتجات][[google.shopping.content.bundles.Products.ProductInput] متعددة بعد تطبيق القواعد ومصادر البيانات التكميلية. يتطابق هذا المنتج الذي تمت معالجته مع ما يظهر في حسابك على Merchant Center وفي إعلانات Shopping ومنصات Google الأخرى. يتم إنشاء كل منتج من إدخال واحد فقط لمصدر البيانات الأساسي، بالإضافة إلى إدخالات متعدّدة لمصدر البيانات التكميلية. بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
تتطابق جميع الحقول في المنتج الذي تمت معالجته ورسائله الفرعية مع اسم السمة المقابلة لها في مواصفات بيانات المنتج مع بعض الاستثناءات.
الحقول | |
---|---|
name |
اسم المنتج تنسيق الملف: |
channel |
النتائج فقط. قناة المنتج. |
offer_id |
النتائج فقط. معرّف فريد للمنتج ينطبق ذلك أيضًا على المنتجات التي تم إدخالها والمنتج الذي تمت معالجته. تتم إزالة المسافات البيضاء البادئة واللاحقة ويتم استبدال المسافات البيضاء المتعددة بمسافة بيضاء واحدة عند الإرسال. لمزيد من التفاصيل، يمكنك الاطّلاع على مواصفات بيانات المنتج. |
content_language |
النتائج فقط. تمثّل هذه السمة رمز اللغة ISO 639-1 المكوّن من حرفَين للمنتج. |
feed_label |
النتائج فقط. تمثّل هذه السمة تصنيف الخلاصة للمنتج. |
data_source |
النتائج فقط. مصدر البيانات الأساسي للمنتج. |
attributes |
النتائج فقط. قائمة بسمات المنتج |
custom_attributes[] |
النتائج فقط. قائمة بالسمات المخصّصة (المقدّمة من التاجر). ويمكن استخدامها أيضًا لإرسال أي سمة لمواصفات البيانات بشكلها العام (مثل |
product_status |
النتائج فقط. حالة المنتج، أو مشكلات التحقق من صحة البيانات، أي معلومات حول منتج محسوبة بشكل غير متزامن. |
version_number |
النتائج فقط. تُمثِّل هذه السمة الإصدار الحالي (حداثة) المنتج، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدة تعديلات في الوقت نفسه. وفي حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إعادة الإدراج (مثلاً، إعادة تحميل المنتج بعد 30 يومًا) باستخدام لا يتاح إلا للإدراج في مصادر البيانات الأساسية. في حال منع العملية، سيتم طرح استثناء تم إلغاؤه. |
ProductDetail
تفاصيل المنتج.
الحقول | |
---|---|
section_name |
عنوان القسم المستخدَم لتجميع مجموعة من تفاصيل المنتج |
attribute_name |
تمثّل هذه السمة اسم تفاصيل المنتج. |
attribute_value |
قيمة تفاصيل المنتج. |
ProductDimension
أبعاد المنتج.
الحقول | |
---|---|
value |
مطلوب. قيمة البُعد الممثَّلة كرقم. يمكن أن يكون للقيمة كحد أقصى لدقة أربعة خانات عشرية. |
unit |
مطلوب. وحدات البُعد. القيم المقبولة هي: * " |
ProductInput
يمثّل هذا المرجع بيانات الإدخال التي ترسلها لأحد المنتجات، ولا يمثّل المنتج الذي تمت معالجته الظاهر في Merchant Center أو في إعلانات Shopping أو على مساحات عرض Google. ويتم دمج إدخالات المنتجات وقواعدها وبيانات مصادر البيانات التكميلية لإنشاء [product][google.shopping.content.bundles.Products.Product] الذي تمت معالجته.
إنّ السمات المطلوبة لإدخال المنتج لاجتياز عمليات التحقّق من صحة البيانات يتم تحديدها بشكل أساسي في مواصفات بيانات المنتجات.
السمات التالية مطلوبة: [feedLabel][google.shopping.content.bundles.Products.feed_label] و[contentLanguage][google.shopping.content.bundles.Products.content_language] و[offerId][google.shopping.content.bundles.Products.offer_id].
بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
تتطابق جميع الحقول في إدخال المنتج ورسائله الفرعية مع الاسم باللغة الإنجليزية للسمة المقابلة في مواصفات العمود مع بعض الاستثناءات.
الحقول | |
---|---|
name |
المُعرّف. اسم المنتج الذي تم إدخاله. تنسيق الملف: |
product |
النتائج فقط. تمثّل هذه السمة اسم المنتج الذي تمت معالجته. تنسيق الملف: |
channel |
مطلوب. غير قابل للتغيير. قناة المنتج. |
offer_id |
مطلوب. غير قابل للتغيير. معرّف فريد للمنتج ينطبق ذلك أيضًا على المنتجات التي تم إدخالها والمنتج الذي تمت معالجته. تتم إزالة المسافات البيضاء البادئة واللاحقة ويتم استبدال المسافات البيضاء المتعددة بمسافة بيضاء واحدة عند الإرسال. لمزيد من التفاصيل، يمكنك الاطّلاع على مواصفات بيانات المنتجات. |
content_language |
مطلوب. غير قابل للتغيير. تمثّل هذه السمة رمز اللغة ISO 639-1 المكوّن من حرفَين للمنتج. |
feed_label |
مطلوب. غير قابل للتغيير. تصنيف الخلاصة للمنتج. |
attributes |
اختياريّ. قائمة بسمات المنتج |
custom_attributes[] |
اختياريّ. قائمة بالسمات المخصّصة (المقدّمة من التاجر). ويمكن استخدامها أيضًا لإرسال أي سمة لمواصفات البيانات بشكلها العام (مثل |
version_number |
اختياريّ. تُمثِّل هذه السمة الإصدار الحالي (حداثة) المنتج، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدة تعديلات في الوقت نفسه. وفي حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إعادة الإدراج (مثلاً، إعادة تحميل المنتج بعد 30 يومًا) باستخدام لا يتاح إلا للإدراج في مصادر البيانات الأساسية. في حال منع العملية، سيتم طرح استثناء تم إلغاؤه. |
ProductStatus
حالة المنتج، أو مشكلات التحقق من صحة البيانات، أي معلومات حول منتج محسوبة بشكل غير متزامن.
الحقول | |
---|---|
destination_statuses[] |
الوجهات المقصودة للمنتج |
item_level_issues[] |
قائمة بكل المشاكل المرتبطة بالمنتج. |
creation_date |
تمثّل هذه السمة تاريخ إنشاء العنصر بتنسيق ISO 8601. |
last_update_date |
تمثّل هذه السمة تاريخ آخر تعديل للعنصر، بالتنسيق ISO 8601. |
google_expiration_date |
تاريخ انتهاء صلاحية السلعة، بالتنسيق ISO 8601. |
DestinationStatus
حالة الوجهة لحالة المنتج.
الحقول | |
---|---|
reporting_context |
اسم سياق الإبلاغ |
approved_countries[] |
تمثّل هذه السمة قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تتم الموافقة على العرض فيها. |
pending_countries[] |
قائمة برموز البلدان (ISO 3166-1 alpha-2) التي في انتظار الموافقة على العرض. |
disapproved_countries[] |
تمثّل هذه السمة قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تم رفض العرض فيها. |
ItemLevelIssue
تمثّل هذه السمة قيمة ItemLevelISSUE لحالة المنتج.
الحقول | |
---|---|
code |
رمز الخطأ للمشكلة |
severity |
كيفية تأثير هذه المشكلة في تقديم العرض |
resolution |
ما إذا كان بإمكان التاجر حلّ المشكلة |
attribute |
اسم السمة، إذا كانت المشكلة ناتجة عن سمة واحدة. |
reporting_context |
سياق إعداد التقارير الذي تنطبق عليه المشكلة |
description |
وصف موجز للمشكلة باللغة الإنجليزية |
detail |
وصف مفصل للمشكلة باللغة الإنجليزية. |
documentation |
تمثّل هذه السمة عنوان URL لصفحة ويب للمساعدة في حلّ هذه المشكلة. |
applicable_countries[] |
قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تنطبق فيها المشكلة على العرض. |
درجة الخطورة
كيفية تأثير المشكلة في عرض المنتج
عمليات التعداد | |
---|---|
SEVERITY_UNSPECIFIED |
لم يتم تحديده. |
NOT_IMPACTED |
تشير هذه المشكلة إلى تحذير وليس لها تأثير مباشر على المنتج. |
DEMOTED |
يتم خفض ترتيب المنتج، ومن المرجّح أن يكون أداؤه محدودًا في نتائج البحث. |
DISAPPROVED |
تؤدي المشكلة إلى رفض المنتج. |
ProductStructuredDescription
وصف منسَّق للأوصاف التي يتم إنشاؤها باستخدام خوارزميات (AI)
الحقول | |
---|---|
digital_source_type |
نوع المصدر الرقمي، مثل "trained_algorithmic_media". تتم متابعة IPTC. الحد الأقصى للطول هو 40 حرفًا. |
content |
الحد الأقصى للطول في نص الوصف هو 5,000 حرف. |
ProductStructuredTitle
عنوان منظَّم للعناوين التي يتم إنشاؤها باستخدام الخوارزميات (AI)
الحقول | |
---|---|
digital_source_type |
نوع المصدر الرقمي، مثل "trained_algorithmic_media". تتم متابعة IPTC. الحد الأقصى للطول هو 40 حرفًا. |
content |
الحد الأقصى للطول في نص العنوان هو 150 حرفًا. |
ProductWeight
وزن المنتج
الحقول | |
---|---|
value |
مطلوب. الوزن ممثلة كرقم. يمكن أن يصل الحد الأقصى لدقة الوزن إلى أربعة خانات عشرية. |
unit |
مطلوب. وحدة الوزن. القيم المقبولة هي: * " |
الشحن
تمثّل هذه السمة شحن المنتج.
الحقول | |
---|---|
price |
سعر شحن ثابت، ويتم تمثيله في شكل رقم. |
country |
رمز CLDR للمنطقة للبلد الذي سيتم شحن سلعة إليه. |
region |
المنطقة الجغرافية التي ينطبق عليها سعر الشحن. يُرجى الاطّلاع على المنطقة للحصول على مزيد من المعلومات. |
service |
وصف ذو تنسيق مرن لفئة الخدمة أو سرعة التسليم. |
location_id |
المعرّف الرقمي لموقع جغرافي ينطبق عليه تعرفة الشحن كما هو محدّد في AdWords API |
location_group_name |
الموقع الجغرافي الذي يكون فيه الشحن ساريًا، ويمثّله اسم مجموعة المواقع الجغرافية |
postal_code |
نطاق الرمز البريدي الذي تنطبق عليه تعرفة الشحن، ويمثّله رمز بريدي، وبادئة رمز بريدي يتبعها حرف بدل *، أو نطاق بين رمزَين بريديَين أو بادئتَي رمز بريدي متساويتَين في الطول |
min_handling_time |
تمثّل هذه السمة الحدّ الأدنى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه في أيام العمل. 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]. |
max_handling_time |
الحدّ الأقصى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه في أيام العمل. 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]. |
min_transit_time |
تمثّل هذه السمة الحدّ الأدنى لمدة النقل (شاملاً) بين وقت شحن الطلب ووقت تسليمه خلال أيام العمل. وتعني القيمة 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]. |
max_transit_time |
الحدّ الأقصى لمدة النقل (شامل) بين وقت شحن الطلب ووقت تسليمه في أيام العمل وتعني القيمة 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]. |
ShippingDimension
سمة شحن المنتج
الحقول | |
---|---|
value |
أبعاد المنتج المستخدَمة لاحتساب تكلفة شحن السلعة. |
unit |
وحدة القيمة. |
ShippingWeight
تمثّل هذه السمة وزن صندوق الشحن الخاص بالمنتج.
الحقول | |
---|---|
value |
وزن المنتج المستخدَم لاحتساب تكلفة شحن السلعة |
unit |
وحدة القيمة. |
SubscriptionCost
تمثّل هذه السمة قيمة الاشتراك في المنتج.
الحقول | |
---|---|
period |
تمثّل هذه السمة نوع فترة الاشتراك. القيمتان المسموح بإدراجهما هما: * " |
period_length |
عدد فترات الاشتراك التي يجب أن يدفع المشتري خلالها. |
amount |
المبلغ المترتّب على المشتري مقابل كل فترة اشتراك. |
SubscriptionPeriod
فترة الاشتراك في المنتج.
عمليات التعداد | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
يشير إلى أنّه لم يتم تحديد فترة الاشتراك. |
MONTH |
يشير إلى أنّ مدة الاشتراك هي شهر. |
YEAR |
يشير هذا الرمز إلى أنّ فترة الاشتراك هي سنة. |
الضريبة
ضريبة المنتج.
الحقول | |
---|---|
rate |
النسبة المئوية لمعدّل الضريبة الذي ينطبق على سعر السلعة. |
country |
البلد الذي يتم فيه فرض ضريبة على السلعة، ويتم تحديده ليكون رمز CLDR للمنطقة |
region |
المنطقة الجغرافية التي ينطبق عليها معدّل الضريبة. |
tax_ship |
اضبط القيمة على "صحيح" إذا تم تحصيل الضريبة على الشحن. |
location_id |
المعرّف الرقمي لموقع جغرافي ينطبق عليه معدّل الضريبة كما هو محدّد في AdWords API. |
postal_code |
نطاق الرمز البريدي الذي ينطبق عليه معدّل الضريبة، ويمثّله رمز بريدي، أو بادئة رمز بريدي تستخدم حرف بدل *، أو نطاق بين رمزَين بريديَين أو بادئتَي رمز بريدي متساويتَين في الطول أمثلة: 94114، و94*، و94002-95460، و94*-95*. |
UnitPricingBaseMeasure
مقياس UnitPriceBaseMeasurement للمنتج.
الحقول | |
---|---|
value |
مقام سعر الوحدة. |
unit |
وحدة المقام. |
UnitPricingMeasure
تمثّل هذه السمة طريقة تسعير الوحدات للمنتج.
الحقول | |
---|---|
value |
تمثّل هذه السمة مقياسًا لعنصر. |
unit |
وحدة القياس. |