LineItem

يحتوي بند واحد على عمود واحد. يمكن أن يحتوي الطلب أو سلة التسوق على عناصر متعددة من نفس موضع الإعلان. يجب تحديد العناصر الفرعية/الإضافات وما إلى ذلك في نماذج أوّلية رأسية بناءً على حالات استخدامها. ملاحظة: 1- يجب أن تكون كل السلاسل على جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن يكون عدد جميع الحقول المتكرّرة على جميع المستويات أقل من 50، ما لم يتم تحديد خلاف ذلك. 3- يجب أن تكون كل الطوابع الزمنية بجميع المستويات، في حال تحديدها، طوابع زمنية صالحة.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
الحقول
id

string

المطلوب: المعرّف الذي خصّصه التاجر للعنصر. تُستخدَم لتحديد تفاصيل الإعلان الحالية عند تطبيق التعديلات الجزئية. الحد الأقصى المسموح به للطول هو 64 حرفًا.
name

string

اسم البند كما هو موضح في الإيصال. الحد الأقصى المسموح به للطول هو 100 حرف.
userVisibleStateLabel
(deprecated)

string

تمّ الإيقاف. يُرجى استخدام الحالة العمودية بدلاً من ذلك. على سبيل المثال، بالنسبة إلى عمليات الشراء، استخدِم purchaseOrderExtension.status. تصنيف مرئي للمستخدم لحالة هذا العنصر
provider

object (Merchant)

تمثّل هذه السمة موفِّر العنصر المعيّن، إذا كان مختلفًا عن الطلب العام. مثال: طلب Expedia مع مقدم خدمة العناصر ANA
priceAttributes[]

object (PriceAttribute)

السعر والتعديلات على مستوى العنصر:
followUpActions[]

object (Action)

إجراءات المتابعة على تفاصيل الإعلان
recipients[]

object (UserInfo)

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

object (Image)

صورة صغيرة مرتبطة بهذه السلعة، إن توفّرت
description

string

وصف البند.
notes[]

string

ملاحظات إضافية تنطبق على هذا العنصر بالتحديد، مثل سياسة الإلغاء
disclosures[]

object (Disclosure)

بيانات الإفصاح المرتبطة بهذا البند
vertical
(deprecated)

object

متوقّفة نهائيًا: استخدِم الفئات بدلاً منها. المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يجب أن تكون إحدى القيمتين التاليتين: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }
حقل الاتحاد verticals. المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يمكن أن يكون verticals واحدًا فقط مما يلي:
purchase

object (PurchaseItemExtension)

طلبات الشراء، مثل السلع والطعام وغير ذلك
reservation

object (ReservationItemExtension)

طلبات الحجز، مثل المطعم وقص الشعر وغير ذلك

PurchaseItemExtension

محتوى العناصر في قطاع الشراء

تمثيل JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
الحقول
status

enum (PurchaseStatus)

مطلوب: الحالة على مستوى العنصر
userVisibleStatusLabel

string

المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا.
type

enum (PurchaseType)

مطلوب: نوع الشراء.
productId
(deprecated)

string

معرّف المنتج أو العرض المرتبط بهذا العنصر
quantity

integer

كمية السلعة
unitMeasure

object (MerchantUnitMeasure)

قياس الوحدة. تُستخدَم لتحديد حجم السلعة في الوحدات المختارة. يتم استخدام الحجم مع السعر النشط لتحديد سعر الوحدة.
returnsInfo

object (PurchaseReturnsInfo)

تؤدي إلى إرجاع معلومات لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات إرجاع مستوى الطلب.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

معلومات التنفيذ لهذا العنصر وفي حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات التنفيذ على مستوى الطلب.
itemOptions[]

object (ItemOption)

إضافات أو عناصر فرعية إضافية
extension

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle

كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }
productDetails

object (ProductDetails)

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

MerchantUnitMeasure

مقياس تسعير وحدات التاجر

تمثيل JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
الحقول
measure

number

القيمة: مثال 1.2.
unit

enum (Unit)

الوحدة: مثال على POUND، GRAM.

ItemOption

يمثل هذا الإعداد الإضافات أو العناصر الفرعية.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
الحقول
id

string

بالنسبة إلى خيارات السلع، معرّف السلعة الفريد
name

string

اسم الخيار.
prices[]

object (PriceAttribute)

السعر الإجمالي للخيار
note

string

ملاحظة ذات صلة بالخيار
quantity

integer

بالنسبة إلى خيارات السلع والكمية.
productId

string

معرّف المنتج أو العرض المرتبط بهذا الخيار
subOptions[]

object (ItemOption)

لتحديد خيارات فرعية متداخلة أخرى.

ProductDetails

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

تمثيل JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
الحقول
productId

string

معرّف المنتج أو العرض المرتبط بهذا العنصر
gtin

string

تمثّل هذه السمة الرقم التجاري العالمي للسلعة للمنتج. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ.
plu

string

إنّ رموز البحث عن الأسعار، المعروفة عادةً برموز PLU أو أرقام PLU أو أرقام PLU أو رموز الإنتاج أو تصنيفات المنتجات، هي منظومة من الأرقام التي تحدّد بشكل فريد المنتجات المجمّعة التي يتم بيعها في متاجر البقالة ومحلات السوبرماركت.
productType

string

فئة المنتج التي حدّدها التاجر. مثلاً: الصفحة الرئيسية > بقالة > منتجات الألبان البيض > حليب > حليب كامل الدسم"
productAttributes

map (key: string, value: string)

التفاصيل التي يقدّمها التاجر عن المنتج، مثل: { "allergen": "peanut" }. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ReservationItemExtension

محتويات العنصر لطلبات الحجز، مثل المطعم، وقص الشعر وما إلى ذلك. رقم التعريف التالي: 15.

تمثيل JSON 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
الحقول
status

enum (ReservationStatus)

مطلوب: حالة الحجز.
userVisibleStatusLabel

string

المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا.
type

enum (ReservationType)

نوع الحجز. ويمكن إلغاء تحديده في حال عدم انطباق أي من خيارات النوع.
reservationTime

object (Time)

الوقت الذي تمت جدولة الخدمة/الحدث فيه لوقوع الخدمة. يمكن أن يكون نطاقًا زمنيًا أو تاريخًا أو وقتًا محددًا.
userAcceptableTimeRange

object (Time)

نطاق زمني مقبول للمستخدم
confirmationCode

string

رمز تأكيد هذا الحجز.
partySize

integer

عدد الأشخاص.
staffFacilitators[]

object (StaffFacilitator)

منسّقو الموظفين الذين سيقدمون خدمة الحجز. مثال مصفّف الشعر.
location

object (Location)

الموقع الجغرافي للخدمة/الحدث.
extension

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle

كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

StaffFacilitator

معلومات حول مقدّم الخدمة

تمثيل JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
الحقول
name

string

تمثّل هذه السمة اسم المُنسّق. مثال "جون سميث"
image

object (Image)

صور مؤدي عروض الأداء