LineItem

Bir satır öğesi bir tema içeriyor. Bir sipariş veya alışveriş sepetinde aynı sektörden birden fazla satır öğesi olabilir. Alt satır öğeleri/eklentiler vb. kullanım alanlarına bağlı olarak dikey proto'larda tanımlanmalıdır. Not: 1. Aksi belirtilmedikçe tüm düzeylerdeki tüm dizeler 1.000 karakterden kısa olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerdeki yinelenen alanların tümü 50'den az olmalıdır. 3. Belirtilmişse tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.

JSON gösterimi
{
  "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.
}
Alanlar
id

string

Gerekli: Satır öğesi için satıcı tarafından atanan tanımlayıcı. Kısmi güncellemeleri uygularken mevcut satır öğesini tanımlamak için kullanılır. İzin verilen maksimum uzunluk 64 karakterdir.

name

string

Makbuzda görünen satır öğesinin adı. İzin verilen maksimum uzunluk 100 karakterdir.

userVisibleStateLabel
(deprecated)

string

Kullanımdan kaldırıldı. Bunun yerine dikey düzeyde durumu kullanın. Örneğin, satın alma işlemleri için PurchaseOrderExtension.status değerini kullanın. Bu satır öğesinin durumu için kullanıcı tarafından görülebilen etiket.

provider

object (Merchant)

Genel siparişten farklıysa belirli satır öğesinin sağlayıcısı. Örnek: Satır öğesi sağlayıcısı ANA ile Expedia siparişi.

priceAttributes[]

object (PriceAttribute)

Satır öğesi seviyesinde fiyat ve düzenlemeler.

followUpActions[]

object (Action)

Satır öğesindeki takip işlemleri.

recipients[]

object (UserInfo)

Satır öğesi düzeyindeki müşteriler, bu, Sipariş düzeyindeki alıcıdan farklı olabilir. Örnek: X kullanıcısı, Y adlı kullanıcının adı altında restoran rezervasyonu yapmış.

image

object (Image)

Varsa, bu öğeyle ilişkili küçük resim.

description

string

Satır öğesi açıklaması.

notes[]

string

Bu satır öğesi için geçerli olan ek notlar (ör. iptal politikası).

disclosures[]

object (Disclosure)

Bu satır öğesiyle ilgili açıklamalar.

vertical
(deprecated)

object

Kullanımdan kaldırıldı: Bunun yerine sektör kullanın. Gerekli: Satır öğesinin türüne/sektörüne göre Semantik İçeriği. Her sektör kendi sipariş karşılama ayrıntılarını içermelidir. Şu değerlerden biri olmalıdır: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

verticals alanı. Gerekli: Satır öğesinin türüne/sektörüne göre Semantik İçeriği. Her sektör kendi sipariş karşılama ayrıntılarını içermelidir. verticals şunlardan yalnızca biri olabilir:
purchase

object (PurchaseItemExtension)

Mal, yiyecek vb. satın alma siparişleri

reservation

object (ReservationItemExtension)

Restoran, saç kesimi gibi rezervasyon siparişleri

PurchaseItemExtension

Satın alma sektörünün satır öğesi içerikleri.

JSON gösterimi
{
  "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)
  }
}
Alanlar
status

enum (PurchaseStatus)

Gerekli: Satır öğesi düzeyinde durum.

userVisibleStatusLabel

string

Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.

type

enum (PurchaseType)

Gerekli: satın alma türü.

productId
(deprecated)

string

Bu satır öğesiyle ilişkili ürün veya teklif kimliği.

quantity

integer

Öğenin miktarı.

unitMeasure

object (MerchantUnitMeasure)

Birim ölçüsü. Seçilen birimlerde öğenin boyutunu belirtir. Birim fiyatı belirlemek için boyut ve etkin fiyat kullanılır.

returnsInfo

object (PurchaseReturnsInfo)

Bu satır öğesinin bilgilerini döndürür. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyi döndürdüğü bilgileri devralır.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Bu satır öğesi için sipariş karşılama bilgileri. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyinde sipariş karşılama bilgilerini devralır.

itemOptions[]

object (ItemOption)

Ek eklentiler veya alt öğeler.

extension

object

Satıcı ile Google arasında paylaşılan tüm ekstra alanlar.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Ürünle ilgili ayrıntılar.

MerchantUnitMeasure

Satıcı birimi fiyatlandırma ölçüsü.

JSON gösterimi
{
  "measure": number,
  "unit": enum (Unit)
}
Alanlar
measure

number

Değer: Örnek 1.2.

unit

enum (Unit)

Birim: Örnek POUND, GRAM.

ItemOption

Eklentileri veya alt öğeleri temsil eder.

JSON gösterimi
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Alanlar
id

string

Öğe olan seçenekler için benzersiz öğe kimliği.

name

string

Seçenek adı.

prices[]

object (PriceAttribute)

Seçenek toplam fiyatı.

note

string

Seçenekle ilgili not.

quantity

integer

Öğe olan seçenekler için miktar.

productId

string

Bu seçenekle ilişkili ürün veya teklif kimliği.

subOptions[]

object (ItemOption)

İç içe yerleştirilmiş diğer alt seçenekleri tanımlamak için.

ProductDetails

Ürünle ilgili ayrıntılar.

JSON gösterimi
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Alanlar
productId

string

Bu satır öğesiyle ilişkili ürün veya teklif kimliği.

gtin

string

Ürünün Global Ticari Öğe Numarası. OfferId, Merchant Center'da mevcut değilse yararlıdır. İsteğe bağlı.

plu

string

Genellikle PLU kodları, PLU numaraları, PLU'lar, kod üretme veya etiket üretme olarak adlandırılan fiyat arama kodları, market ve süpermarketlerde satılan toplu ürünleri benzersiz şekilde tanımlayan bir sayı sistemidir.

productType

string

Satıcı tarafından tanımlanan ürün kategorisi. Ör. "Ev > Bakkal > Süt Ürünleri ve Yumurta > Süt > Tam Yağlı Süt"

productAttributes

map (key: string, value: string)

Satıcının ürün hakkında sağladığı ayrıntılar, ör. { "allergen": "peanut" }. OfferId Merchant Center'da mevcut değilse yararlıdır. İsteğe bağlı.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Restoran, saç kesimi vb. gibi rezervasyon siparişleri için satır öğesi içeriği. Sonraki kimlik: 15.

JSON gösterimi
{
  "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: ...,
    ...
  }
}
Alanlar
status

enum (ReservationStatus)

Zorunlu: Rezervasyon durumu.

userVisibleStatusLabel

string

Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.

type

enum (ReservationType)

rezervasyon türü. Tür seçeneklerinden hiçbiri geçerli değilse bu ayar kaldırılabilir.

reservationTime

object (Time)

hizmetin/etkinliğin gerçekleşmesinin planlandığı zamandır. Zaman aralığı, tarih veya kesin tarih saat olabilir.

userAcceptableTimeRange

object (Time)

kabul edilebilir bir zaman aralığı belirler.

confirmationCode

string

Bu rezervasyonun onay kodu.

partySize

integer

Kullanıcı sayısı.

staffFacilitators[]

object (StaffFacilitator)

Rezervasyonla ilgili işlemleri yaptıracak personel yöneticileri. Ör. Kuaför.

location

object (Location)

Hizmetin/etkinliğin konumu.

extension

object

Satıcı ile Google arasında paylaşılan tüm ekstra alanlar.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

StaffFacilitator

Hizmet sağlayıcıyla ilgili bilgiler.

JSON gösterimi
{
  "name": string,
  "image": {
    object (Image)
  }
}
Alanlar
name

string

Personel eğitimini düzenleyen kişinin adı. Ör. "Can Demir"

image

object (Image)

Sanatçının resimleri.