- تمثيل JSON
- PurchaseItemExtension
- MerchantUnitMeasure
- ItemOption
- ProductDetails
- ReservationItemExtension
- StaffFacilitator
يحتوي بند واحد على عمود واحد. يمكن أن يحتوي الطلب أو سلة التسوق على عناصر متعددة من نفس موضع الإعلان. يجب تحديد العناصر الفرعية/الإضافات وما إلى ذلك في نماذج أوّلية رأسية بناءً على حالات استخدامها. ملاحظة: 1- يجب أن تكون كل السلاسل على جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن يكون عدد جميع الحقول المتكرّرة على جميع المستويات أقل من 50، ما لم يتم تحديد خلاف ذلك. 3- يجب أن تكون كل الطوابع الزمنية بجميع المستويات، في حال تحديدها، طوابع زمنية صالحة.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
الحقول | ||
---|---|---|
id |
المطلوب: المعرّف الذي خصّصه التاجر للعنصر. تُستخدَم لتحديد تفاصيل الإعلان الحالية عند تطبيق التعديلات الجزئية. الحد الأقصى المسموح به للطول هو 64 حرفًا. |
|
name |
اسم البند كما هو موضح في الإيصال. الحد الأقصى المسموح به للطول هو 100 حرف. |
|
userVisibleStateLabel |
تمّ الإيقاف. يُرجى استخدام الحالة العمودية بدلاً من ذلك. على سبيل المثال، بالنسبة إلى عمليات الشراء، استخدِم purchaseOrderExtension.status. تصنيف مرئي للمستخدم لحالة هذا العنصر |
|
provider |
تمثّل هذه السمة موفِّر العنصر المعيّن، إذا كان مختلفًا عن الطلب العام. مثال: طلب Expedia مع مقدم خدمة العناصر ANA |
|
priceAttributes[] |
السعر والتعديلات على مستوى العنصر: |
|
followUpActions[] |
إجراءات المتابعة على تفاصيل الإعلان |
|
recipients[] |
بالنسبة إلى العملاء على مستوى العنصر، قد يختلف هذا الخيار عن المشتري على مستوى الطلب. مثال: قام المستخدم س بحجز مطعم تحت اسم المستخدم ص. |
|
image |
صورة صغيرة مرتبطة بهذه السلعة، إن توفّرت |
|
description |
وصف البند. |
|
notes[] |
ملاحظات إضافية تنطبق على هذا العنصر بالتحديد، مثل سياسة الإلغاء |
|
disclosures[] |
بيانات الإفصاح المرتبطة بهذا البند |
|
vertical |
متوقّفة نهائيًا: استخدِم الفئات بدلاً منها. المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يجب أن تكون إحدى القيمتين التاليتين: كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |
|
حقل الاتحاد verticals . المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يمكن أن يكون verticals واحدًا فقط مما يلي: |
||
purchase |
طلبات الشراء، مثل السلع والطعام وغير ذلك |
|
reservation |
طلبات الحجز، مثل المطعم وقص الشعر وغير ذلك |
PurchaseItemExtension
محتوى العناصر في قطاع الشراء
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: الحالة على مستوى العنصر |
userVisibleStatusLabel |
المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
مطلوب: نوع الشراء. |
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر |
quantity |
كمية السلعة |
unitMeasure |
قياس الوحدة. تُستخدَم لتحديد حجم السلعة في الوحدات المختارة. يتم استخدام الحجم مع السعر النشط لتحديد سعر الوحدة. |
returnsInfo |
تؤدي إلى إرجاع معلومات لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات إرجاع مستوى الطلب. |
fulfillmentInfo |
معلومات التنفيذ لهذا العنصر وفي حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات التنفيذ على مستوى الطلب. |
itemOptions[] |
إضافات أو عناصر فرعية إضافية |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |
productDetails |
تمثّل هذه السمة تفاصيل حول المنتج. |
MerchantUnitMeasure
مقياس تسعير وحدات التاجر
تمثيل JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
الحقول | |
---|---|
measure |
القيمة: مثال 1.2. |
unit |
الوحدة: مثال على POUND، GRAM. |
ItemOption
يمثل هذا الإعداد الإضافات أو العناصر الفرعية.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
الحقول | |
---|---|
id |
بالنسبة إلى خيارات السلع، معرّف السلعة الفريد |
name |
اسم الخيار. |
prices[] |
السعر الإجمالي للخيار |
note |
ملاحظة ذات صلة بالخيار |
quantity |
بالنسبة إلى خيارات السلع والكمية. |
productId |
معرّف المنتج أو العرض المرتبط بهذا الخيار |
subOptions[] |
لتحديد خيارات فرعية متداخلة أخرى. |
ProductDetails
تمثّل هذه السمة تفاصيل حول المنتج.
تمثيل JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
الحقول | |
---|---|
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر |
gtin |
تمثّل هذه السمة الرقم التجاري العالمي للسلعة للمنتج. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ. |
plu |
إنّ رموز البحث عن الأسعار، المعروفة عادةً برموز PLU أو أرقام PLU أو أرقام PLU أو رموز الإنتاج أو تصنيفات المنتجات، هي منظومة من الأرقام التي تحدّد بشكل فريد المنتجات المجمّعة التي يتم بيعها في متاجر البقالة ومحلات السوبرماركت. |
productType |
فئة المنتج التي حدّدها التاجر. مثلاً: الصفحة الرئيسية > بقالة > منتجات الألبان البيض > حليب > حليب كامل الدسم" |
productAttributes |
التفاصيل التي يقدّمها التاجر عن المنتج، مثل: { "allergen": "peanut" }. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ. عنصر يحتوي على قائمة بأزواج |
ReservationItemExtension
محتويات العنصر لطلبات الحجز، مثل المطعم، وقص الشعر وما إلى ذلك. رقم التعريف التالي: 15.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: حالة الحجز. |
userVisibleStatusLabel |
المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
نوع الحجز. ويمكن إلغاء تحديده في حال عدم انطباق أي من خيارات النوع. |
reservationTime |
الوقت الذي تمت جدولة الخدمة/الحدث فيه لوقوع الخدمة. يمكن أن يكون نطاقًا زمنيًا أو تاريخًا أو وقتًا محددًا. |
userAcceptableTimeRange |
نطاق زمني مقبول للمستخدم |
confirmationCode |
رمز تأكيد هذا الحجز. |
partySize |
عدد الأشخاص. |
staffFacilitators[] |
منسّقو الموظفين الذين سيقدمون خدمة الحجز. مثال مصفّف الشعر. |
location |
الموقع الجغرافي للخدمة/الحدث. |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |
StaffFacilitator
معلومات حول مقدّم الخدمة
تمثيل JSON | |
---|---|
{
"name": string,
"image": {
object ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم المُنسّق. مثال "جون سميث" |
image |
صور مؤدي عروض الأداء |