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" }. تكون هذه المعلومات مفيدة إذا لم يكن OfferId متوفّرًا في 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)

صور المؤدي