Package google.shopping.merchant.products.v1beta

الفهرس

ProductInputsService

خدمة لاستخدام مورد ProductInput. هذه الخدمة متاحة فقط للمنتجات المتوفّرة على الإنترنت.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

يتم حذف إدخال منتج من حسابك على Merchant Center.

بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

تحمّل إدخال منتج إلى حسابك على Merchant Center. في حال توفُّر مُدخل يتضمّن contentLanguage و offerId وdataSource نفسهما، ستحلّ هذه الطريقة محلّ هذا الإدخال.

بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

ProductsService

خدمة لاستخدام مورد المنتج. هذه الخدمة متاحة فقط للمنتجات المتوفّرة على الإنترنت.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

بعد إدخال بيانات منتج أو تعديلها أو حذفها، قد يستغرق استرداد المنتج النهائي عدّة دقائق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

يسرد المنتجات التي تمت معالجتها في حسابك على Merchant Center. قد تحتوي الاستجابة على عناصر أقل مما هو محدّد حسب pageSize. اعتمِد على pageToken لتحديد ما إذا كان هناك المزيد من العناصر المطلوبة.

بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

السمات

السمات.

الحقول
expiration_date

Timestamp

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

Timestamp

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

Timestamp

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

Price

سعر السلعة
installment

Installment

تمثّل هذه السمة عدد الأقساط والمبلغ المطلوب دفعه مقابل سلعة.
subscription_cost

SubscriptionCost

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

LoyaltyPoints

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

LoyaltyProgram

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

string

فئات السلعة (بتنسيق مواصفات بيانات المنتج)
sale_price

Price

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

Interval

النطاق الزمني الذي تكون فيه السلعة معروضة للبيع (راجِع مواصفات بيانات المنتج)
product_height

ProductDimension

تمثّل هذه السمة ارتفاع المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل).
product_length

ProductDimension

طول المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل).
product_width

ProductDimension

تمثّل هذه السمة عرض المنتج بالوحدات المقدَّمة. يجب أن تتراوح القيمة بين 0 (غير شامل) و3000 (شامل).
product_weight

ProductWeight

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

Shipping

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

FreeShippingThreshold

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

ShippingWeight

وزن السلعة للشحن
shipping_length

ShippingDimension

طول السلعة للشحن
shipping_width

ShippingDimension

عرض السلعة للشحن
shipping_height

ShippingDimension

ارتفاع السلعة للشحن
size_types[]

string

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

Tax

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

UnitPricingMeasure

مقياس وأبعاد المنتج.
unit_pricing_base_measure

UnitPricingBaseMeasure

تمثّل هذه السمة تفضيل المقام لسعر الوحدة.
ads_labels[]

string

يشبه الأمر ads_grouping، ولكنه يعمل فقط مع تكلفة النقرة.
cost_of_goods_sold

Price

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

ProductDetail

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

string

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

string

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

string

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

string

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

string

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

string

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

CloudExportAdditionalProperties

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

Certification

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

Price

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

bool

اضبط هذه القيمة على "خطأ" عندما لا تحتوي السلعة على معرّفات منتجات فريدة مناسبة لفئتها، مثل رقم GTIN ورقم القطعة المحدّد من الشركة المصنّعة والعلامة التجارية. وتكون القيم التلقائية القيمة "صحيح"، إذا لم يتم توفيرها.
is_bundle

bool

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

string

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

string

وصف السلعة
adult

bool

اضبط القيمة على "true" إذا كان العنصر يستهدف البالغين.
age_group

string

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

string

حالة توفّر السلعة.
brand

string

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

string

لون السلعة
condition

string

حالة السلعة أو حالتها
gender

string

الجنس المستهدف للعنصر
google_product_category

string

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

string

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

string

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

string

تمثّل هذه السمة المادة التي صُنعت منها السلعة.
mpn

string

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

string

نمط العنصر (على سبيل المثال، منقّط).
sell_on_google_quantity

int64

كمية المنتج المتاحة للبيع على Google يُسمَح به فقط للمنتجات التي تظهر على الإنترنت.
max_handling_time

int64

الحدّ الأقصى لوقت مناولة المنتجات (بأيام العمل).
min_handling_time

int64

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

string

تشير هذه السمة إلى تصنيف حزمة المنتج، ويتم استخدامه لتجميع المنتج في قواعد الشحن على مستوى الحساب.
transit_time_label

string

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

string

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

string

النظام الذي يتم تحديد الحجم فيه. مُقترَحة لسلع الملابس.
tax_category

string

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

string

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

string

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

string

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

int64

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

string

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

string

تسمح للمعلنين بإلغاء عنوان URL للسلعة عند عرض المنتج في سياق إعلانات المنتج.
display_ads_id

string

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

string

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

double

قدِّم هامشًا لحملات تجديد النشاط التسويقي الديناميكي.
pickup_method

string

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

string

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

string

التصنيف المخصّص 0 لتجميع العناصر المخصّص في حملة Shopping.
custom_label_1

string

التصنيف المخصّص 1 لتجميع العناصر المخصّصة في حملة Shopping.
custom_label_2

string

التصنيف المخصّص 2 لتجميع العناصر المخصّصة في حملة Shopping.
custom_label_3

string

تصنيف مخصّص 3 لتجميع السلع المخصّص في حملة Shopping
custom_label_4

string

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

string

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

string

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

ProductStructuredTitle

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

ProductStructuredDescription

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

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

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

الحقول
certification_authority

string

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

string

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

string

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

string

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

CloudExportAdditionalProperties

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

الحقول
text_value[]

string

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

int64

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

float

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

string

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

bool

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

float

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

float

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

string

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

DeleteProductInputRequest

طلب رسالة لطريقة DeleteProductInput.

الحقول
name

string

مطلوبة. اسم مورد إدخال المنتج المطلوب حذفه. التنسيق: accounts/{account}/productInputs/{product}
data_source

string

مطلوبة. مصدر البيانات الأساسي أو التكميلي الذي يجب حذف إدخال المنتج منه التنسيق: accounts/{account}/dataSources/{datasource}

FreeShippingThreshold

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

الحقول
country

string

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

Price

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

GetProductRequest

اطلب رسالة بشأن طريقة GetProduct.

الحقول
name

string

مطلوبة. تمثّل هذه السمة اسم المنتج الذي تريد استرداده. تنسيق الملف: accounts/{account}/products/{product}

InsertProductInputRequest

طلب رسالة لطريقة InsertProductInput.

الحقول
parent

string

مطلوبة. تمثّل هذه السمة الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account}
product_input

ProductInput

مطلوبة. إدخال المنتج المطلوب إدراجه.
data_source

string

مطلوبة. اسم مصدر بيانات المنتجات الأساسي أو التكميلي إذا كان المنتج متوفّرًا من قبل وكان مصدر البيانات المقدَّم مختلفًا، سيتم نقل المنتج إلى مصدر بيانات جديد. التنسيق: accounts/{account}/dataSources/{datasource}

الأقساط

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

الحقول
months

int64

تمثّل هذه السمة عدد الأقساط المترتّبة على المشتري.
amount

Price

المبلغ المترتّب على المشتري شهريًا.
downpayment

Price

تمثّل هذه السمة مبلغ الدفعة الأولى التي يجب أن يدفعها المشتري.
credit_type

string

تمثّل هذه السمة نوع دفعات الأقساط. القيمتان المسموح بإدراجهما هما: * "finance" * "lease".

ListProductsRequest

اطلب رسالة لطريقة ListProducts.

الحقول
parent

string

مطلوبة. الحساب المطلوب إدراج المنتجات التي تمت معالجتها له التنسيق: accounts/{account}
page_size

int32

تمثّل هذه السمة الحدّ الأقصى لعدد المنتجات المطلوب إرجاعها. قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هي 1000، وسيتم فرض القيم الأعلى من 1000 على 1000. وفي حال عدم تحديد قيمة هذه السمة، سيتم إرجاع الحد الأقصى لعدد المنتجات.
page_token

string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListProducts". ويمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListProducts مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

ListProductsResponse

رسالة ردّ على طريقة ListProducts.

الحقول
products[]

Product

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

string

رمز مميز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

LoyaltyPoints

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

الحقول
name

string

تمثّل هذه السمة اسم برنامج نقاط الولاء. ويوصى بألا يزيد الاسم عن 12 حرفًا بالعرض الكامل أو 24 حرفًا رومانيًا.
points_value

int64

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

double

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

LoyaltyProgram

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

الحقول
program_label

string

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

string

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

Price

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

Price

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

int64

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

المنتج

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

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

الحقول
name

string

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

ChannelEnum

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

string

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

string

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

string

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

string

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

Attributes

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

CustomAttribute

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

ProductStatus

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

int64

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

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

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

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

ProductDetail

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

الحقول
section_name

string

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

string

تمثّل هذه السمة اسم تفاصيل المنتج.
attribute_value

string

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

ProductDimension

أبعاد المنتج.

الحقول
value

double

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

string

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

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

string

المُعرّف. اسم المنتج الذي تم إدخاله. تنسيق الملف: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

النتائج فقط. تمثّل هذه السمة اسم المنتج الذي تمت معالجته. تنسيق الملف: "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

مطلوبة. غير قابل للتغيير. قناة المنتج.
offer_id

string

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

string

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

string

مطلوبة. غير قابل للتغيير. تصنيف الخلاصة للمنتج.
attributes

Attributes

اختياريّ. قائمة بسمات المنتج
custom_attributes[]

CustomAttribute

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

int64

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

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

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

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

ProductStatus

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

الحقول
destination_statuses[]

DestinationStatus

الوجهات المقصودة للمنتج
item_level_issues[]

ItemLevelIssue

قائمة بكل المشاكل المرتبطة بالمنتج.
creation_date

Timestamp

تمثّل هذه السمة تاريخ إنشاء العنصر بتنسيق ISO 8601.
last_update_date

Timestamp

تمثّل هذه السمة تاريخ آخر تعديل للعنصر، بالتنسيق ISO 8601.
google_expiration_date

Timestamp

تاريخ انتهاء صلاحية السلعة، بالتنسيق ISO 8601.

DestinationStatus

حالة الوجهة لحالة المنتج.

الحقول
reporting_context

ReportingContextEnum

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

string

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

string

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

string

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

ItemLevelIssue

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

الحقول
code

string

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

Severity

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

string

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

string

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

ReportingContextEnum

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

string

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

string

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

string

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

string

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

درجة الخطورة

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

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

ProductStructuredDescription

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

الحقول
digital_source_type

string

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

string

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

ProductStructuredTitle

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

الحقول
digital_source_type

string

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

string

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

ProductWeight

وزن المنتج

الحقول
value

double

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

string

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

الشحن

تمثّل هذه السمة شحن المنتج.

الحقول
price

Price

سعر شحن ثابت، ويتم تمثيله في شكل رقم.
country

string

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

string

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

string

وصف ذو تنسيق مرن لفئة الخدمة أو سرعة التسليم.
location_id

int64

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

string

الموقع الجغرافي الذي يكون فيه الشحن ساريًا، ويمثّله اسم مجموعة المواقع الجغرافية
postal_code

string

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

int64

تمثّل هذه السمة الحدّ الأدنى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه في أيام العمل. 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

int64

الحدّ الأقصى لوقت المناولة (شاملاً) بين وقت استلام الطلب وشحنه في أيام العمل. 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

int64

تمثّل هذه السمة الحدّ الأدنى لمدة النقل (شاملاً) بين وقت شحن الطلب ووقت تسليمه خلال أيام العمل. وتعني القيمة 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

int64

الحدّ الأقصى لمدة النقل (شامل) بين وقت شحن الطلب ووقت تسليمه في أيام العمل وتعني القيمة 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

double

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

string

وحدة القيمة.

ShippingWeight

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

الحقول
value

double

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

string

وحدة القيمة.

SubscriptionCost

تمثّل هذه السمة قيمة الاشتراك في المنتج.

الحقول
period

SubscriptionPeriod

تمثّل هذه السمة نوع فترة الاشتراك. القيمتان المسموح بإدراجهما هما: * "month" * "year".
period_length

int64

عدد فترات الاشتراك التي يجب أن يدفع المشتري خلالها.
amount

Price

المبلغ المترتّب على المشتري مقابل كل فترة اشتراك.

SubscriptionPeriod

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

عمليات التعداد
SUBSCRIPTION_PERIOD_UNSPECIFIED يشير إلى أنّه لم يتم تحديد فترة الاشتراك.
MONTH يشير إلى أنّ مدة الاشتراك هي شهر.
YEAR يشير هذا الرمز إلى أنّ فترة الاشتراك هي سنة.

ضريبة

ضريبة المنتج.

الحقول
rate

double

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

string

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

string

المنطقة الجغرافية التي ينطبق عليها معدّل الضريبة.
tax_ship

bool

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

int64

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

string

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

UnitPricingBaseMeasure

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

الحقول
value

int64

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

string

وحدة المقام.

UnitPricingMeasure

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

الحقول
value

double

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

string

وحدة القياس.