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 Order با ارائه دهنده اقلام خطی ANA.

priceAttributes[]

object ( PriceAttribute )

قیمت و تنظیمات سطح مورد خطی.

followUpActions[]

object ( Action )

پیگیری اقدامات در مورد خط.

recipients[]

object ( UserInfo )

مشتریان سطح اقلام خطی، این ممکن است با خریدار سطح سفارش متفاوت باشد. مثال: کاربر X با نام کاربر Y رزرو رستوران انجام داده است.

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 )

سفارشات رزرو مانند رستوران، مدل مو و غیره

PurchaseItem Extension

محتویات مورد خط خرید عمودی.

نمایندگی 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

هر فیلد اضافی رد و بدل شده بین تاجر و گوگل.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@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 )

واحد: مثال پوند، گرم.

گزینه آیتم

نشان دهنده افزونه ها یا موارد فرعی است.

نمایندگی 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 )

برای تعریف دیگر گزینه های فرعی تو در تو.

جزئیات محصول

جزئیات در مورد محصول.

نمایندگی JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
زمینه های
productId

string

شناسه محصول یا پیشنهاد مرتبط با این مورد خط.

gtin

string

شماره کالای تجارت جهانی محصول. اگر offerId در Merchant Center وجود نداشته باشد مفید است. اختیاری.

plu

string

کدهای جستجوی قیمت که معمولاً کدهای PLU، اعداد PLU، PLUs، کدهای تولید یا برچسب های تولید نامیده می شوند، سیستمی از اعداد هستند که محصولات فله ای را که در فروشگاه های مواد غذایی و سوپرمارکت ها فروخته می شوند به طور منحصر به فرد شناسایی می کنند.

productType

string

دسته بندی محصول توسط تاجر تعریف شده است. به عنوان مثال "خانه > مواد غذایی > لبنیات و تخم مرغ > شیر > شیر کامل"

productAttributes

map (key: string, value: string)

جزئیات ارائه شده توسط بازرگان در مورد محصول، به عنوان مثال { "allergen": "peanut" }. اگر offerId در Merchant Center وجود نداشته باشد مفید است. اختیاری.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

ReservationItem Extension

محتویات آیتم های خطی برای سفارش های رزرو مانند رستوران، مدل مو و غیره. شناسه بعدی: 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

هر فیلد اضافی رد و بدل شده بین تاجر و گوگل.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

کارمندان تسهیل کننده

اطلاعات در مورد مسئول خدمات.

نمایندگی JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
زمینه های
name

string

نام تسهیل کننده کارکنان. سابق. "جان اسمیت"

image

object ( Image )

تصاویر مجری