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 Overview.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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

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

نطاقات التفويض

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

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

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

ProductsService

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

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

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

نطاقات التفويض

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

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

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

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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

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

نطاقات التفويض

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

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

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

السمات

السمات

الحقول
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.
gtin[]

string

الأرقام التجارية العالمية للسلع (GTIN) للسلعة يمكنك تقديم ما يصل إلى 10 أرقام GTIN.
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

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

Price

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

ProductSustainabilityIncentive

قائمة برامج الحوافز المستدامة
identifier_exists

bool

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

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

ProductStructuredDescription

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

الشهادة

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

الحقول
certification_authority

string

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

string

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

string

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

string

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

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

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

float

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

float

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

string

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

DeleteProductInputRequest

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

الحقول
name

string

مطلوب. اسم مصدر إدخال المنتج المطلوب حذفه التنسيق: accounts/{account}/productInputs/{product} حيث يتألّف القسم الأخير product من 4 أجزاء: channel~content_language~feed_label~offer_id، على سبيل المثال، اسم المنتج هو "accounts/123/productInputs/online~en~US~sku123".
data_source

string

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

FreeShippingThreshold

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

الحقول
country

string

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

Price

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

GetProductRequest

رسالة طلب لطريقة GetProduct

الحقول
name

string

مطلوب. اسم المنتج المطلوب استرجاعه. التنسيق: accounts/{account}/products/{product} حيث يتألّف القسم الأخير product من 4 أجزاء: channel~content_language~feed_label~offer_id، على سبيل المثال، اسم المنتج هو "accounts/123/products/online~en~US~sku123".

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

الحد الأقصى لعدد المنتجات التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 250، وسيتم تحويل القيم التي تزيد عن 250 إلى 250. إذا لم يتم تحديد عدد المنتجات، سيتم عرض الحد الأقصى لعدد المنتجات.
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

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

Interval

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

string

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

المنتج

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

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

الحقول
name

string

اسم المنتج التنسيق: "{product.name=accounts/{account}/products/{product}}" حيث يتألّف القسم الأخير product من 4 أجزاء: channel~content_language~feed_label~offer_id، على سبيل المثال، اسم المنتج هو "accounts/123/products/online~en~US~sku123".
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 التي تمت معالجتها.

إنّ سمات إدخال المنتج المطلوبة لاجتياز عمليات التحقّق من صحة البيانات محدّدة بشكل أساسي في مواصفات بيانات المنتجات.

السمات التالية مطلوبة: feedLabel وcontentLanguage وofferId.

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

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

الحقول
name

string

المعرّف اسم إدخال المنتج. التنسيق: "{productinput.name=accounts/{account}/productInputs/{productinput}}" حيث يتألّف القسم الأخير productinput من 4 أجزاء: channel~content_language~feed_label~offer_id، على سبيل المثال، اسم إدخال المنتج هو "accounts/123/productInputs/online~en~US~sku123".
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 (يمثّل مجموع أحرف الاسم والقيمة). يمكن ضبط 2500 سمة مخصّصة كحدّ أقصى لكل منتج، بإجمالي حجم 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

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

الحقول
digital_source_type

string

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

string

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

ProductStructuredTitle

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

الحقول
digital_source_type

string

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

string

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

ProductSustainabilityIncentive

معلومات عن البرامج التحفيزية ذات الصلة بالاستدامة، مثل الخصومات أو الإعفاءات الضريبية

الحقول
حقل الربط value قيمة الحوافز المستدامة يمكن أن يكون value واحدًا مما يلي فقط:
amount

Price

المبلغ الثابت للحوافز
percentage

double

النسبة المئوية للسعر المخفَّض الذي يتم تطبيق الحوافز عليه.
type

Type

برنامج تحفيزي للاستدامة

النوع

أنواع برامج الحوافز المستدامة المتوافقة

عمليات التعداد
TYPE_UNSPECIFIED نوع الحوافز المستدامة غير محدّد أو غير معروف
EV_TAX_CREDIT برنامج يقدّم تخفيضات في الالتزامات الضريبية للمركبات الكهربائية، وفي بعض البلدان للمركبات الهجينة القابلة للشحن ويمكن أن تستند هذه التخفيضات إلى مبلغ محدّد أو نسبة مئوية من السعر المخفَّض.
EV_PRICE_DISCOUNT يقدّم برنامج الدعم، الذي يُعرف غالبًا باسم "مكافأة بيئية"، منحة شراء للمركبات الكهربائية، وفي بعض البلدان، للمركبات الكهربائية الهجينة القابلة للشحن. قد يكون مبلغ المنحة مبلغًا ثابتًا أو نسبة مئوية من السعر المخفَّض.

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 إلا مع maxHandlingTime، ولكن ليس مطلوبًا استخدامه في حال توفّر maxHandlingTime.
max_handling_time

int64

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

int64

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

int64

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

ShippingDimension

سمة ShippingDimension للمنتج.

الحقول
value

double

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

string

وحدة القيمة.

ShippingWeight

سمة 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

اضبط القيمة على true إذا كانت الضريبة تُحصَّل على الشحن.
location_id

int64

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

string

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

UnitPricingBaseMeasure

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

الحقول
value

int64

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

string

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

UnitPricingMeasure

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

الحقول
value

double

قياس السلعة
unit

string

وحدة القياس