Order

Sipariş varlığı. 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
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Alanlar
googleOrderId

string

Google tarafından atanan sipariş kimliği.

merchantOrderId

string

Gerekli: Satıcı tarafından atanan dahili sipariş kimliği. Bu kimlik benzersiz olmalı ve sonraki sipariş güncelleme işlemleri için gereklidir. Bu kimlik, sağlanan googleOrderId veya başka bir benzersiz değere ayarlanabilir. Kullanıcılara sunulan kimliğin userGörünenOrderId olduğunu ve bu farklı ve daha kullanıcı dostu bir değer olabileceğini unutmayın. İzin verilen maksimum uzunluk 128 karakterdir.

userVisibleOrderId

string

Mevcut siparişe referans veren kullanıcıya gösterilen kimlik. Bu kimlik web siteleri, uygulamalar ve e-posta dahil olmak üzere diğer bağlamlarda bu sipariş için görüntülenen kimlikle tutarlı olmalıdır.

userVisibleStateLabel
(deprecated)

string

Kullanımdan kaldırıldı: Bunun yerine OrderExtensions durumunu kullanın. Bu siparişin durumu için kullanıcı tarafından görülebilen etiket.

buyerInfo

object (UserInfo)

alıcıyla ilgili bilgiler.

image

object (Image)

Siparişle ilişkilendirilen resim.

createTime

string (Timestamp format)

Gerekli: siparişin oluşturulduğu tarih ve saat.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

siparişin son güncellendiği tarih ve saat. Sipariş Güncellemesi için gereklidir.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Ödeme işlemini kolaylaştıran satıcı. Bu, satır öğesi seviyesindeki sağlayıcıdan farklı olabilir. Örnek: ANA'dan satır öğesi içeren Expedia Siparişi.

contents

object (Contents)

Gerekli: Satır öğesi grubu olan sipariş içeriği.

priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.

followUpActions[]

object (Action)

Sipariş seviyesinde takip işlemleri.

paymentData

object (PaymentData)

Sipariş için ödemeyle ilgili veriler.

termsOfServiceUrl

string

Sipariş/teklif edilen sipariş için geçerli olan hizmet şartlarının bağlantısı.

note

string

Bir siparişe ekli notlar.

promotions[]

object (Promotion)

Bu siparişle ilişkili tüm promosyonlar.

disclosures[]

object (Disclosure)

Bu siparişle ilgili açıklamalar.

vertical
(deprecated)

object

Kullanımdan kaldırıldı: Bunun yerine sektör kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu tema, satır öğesi düzeyi dikey türüyle eşleşmelidir. Olası değerler: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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ı. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu tema, satır öğesi düzeyi dikey türüyle eşleşmelidir. verticals şunlardan yalnızca biri olabilir:
purchase

object (PurchaseOrderExtension)

Satın alma siparişi

ticket

object (TicketOrderExtension)

Bilet siparişi

İçindekiler

Satır öğeleri için sarmalayıcı.

JSON gösterimi
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Alanlar
lineItems[]

object (LineItem)

Sipariş satır öğelerinin listesi. En az 1 satır öğesi gereklidir ve en fazla 50 satır öğesine izin verilir. Tüm satır öğeleri aynı sektöre ait olmalıdır.

PaymentData

Bir siparişle ilgili ödeme verileri.

JSON gösterimi
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Alanlar
paymentResult

object (PaymentResult)

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu. Ödeme deneyimi actions-on-Google tarafından yönetiliyorsa bu alan, Google'daki işlemler tarafından doldurulur.

paymentInfo

object (PaymentInfo)

Kullanıcıyla etkileşim için yararlı olan siparişle ilgili ödeme bilgileri.

PaymentResult

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.

JSON gösterimi
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Alanlar
result alanı. Google ödeme verileri veya satıcı ödeme yöntemi sağlanmış. result şunlardan yalnızca biri olabilir:
googlePaymentData

string

Google, ödeme yöntemi verilerini sağlar. Ödeme işleyiciniz şurada Google tarafından desteklenen ödeme işleyici olarak listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla ayrıntı için bağlantı üzerinden ödeme işleyicinize gidin. Aksi takdirde yük ayrıntıları için aşağıdaki belgeleri inceleyin. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Satıcı/İşlem tarafından sağlanan, kullanıcı tarafından seçilen ödeme yöntemi.

PaymentInfo

Verilen siparişle ilgili ödeme bilgileri. Bu proto, kullanıcılara yönelik etkileşim için yararlı olan bilgileri yakalar.

JSON gösterimi
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Alanlar
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

İşlem için kullanılan ödeme yönteminin bilgileri.

paymentMethodProvenance

enum (PaymentMethodProvenance)

İşlem için kullanılan ödeme yönteminin kaynağı. Kullanıcı, aynı ödeme yöntemini hem Google'a hem de satıcıya kaydetmiş olabilir.

PaymentMethodDisplayInfo

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.

JSON gösterimi
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
Alanlar
paymentType

enum (PaymentType)

Ödemenin türü.

paymentMethodDisplayName

string

Ödeme yönteminin kullanıcı tarafından görünen adı. Örneğin, VISA **** 1234 Check acct **** 5678

Tanıtım

Alışveriş sepetine eklenen promosyonlar/teklifler.

JSON gösterimi
{
  "coupon": string
}
Alanlar
coupon

string

Gerekli: Bu teklife uygulanan kupon kodu.

PurchaseOrderExtension

Satın alma sektörü için sipariş uzantısı. Bu özellikler, bir satır öğesinde geçersiz kılınmadığı sürece sipariş içindeki tüm satır öğeleri için geçerlidir.

JSON gösterimi
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Alanlar
status

enum (PurchaseStatus)

Gerekli: Sipariş için Genel Durum.

userVisibleStatusLabel

string

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ü.

returnsInfo

object (PurchaseReturnsInfo)

Siparişin iade bilgileri.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Siparişin sipariş karşılama bilgileri.

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" }.

purchaseLocationType

enum (PurchaseLocationType)

Satın alma işleminin yapıldığı yer (mağazada / internette)

errors[]

object (PurchaseError)

İsteğe bağlı: Bu siparişin reddedilmesinden kaynaklanan hatalar.

PurchaseError

Satın alma siparişinin reddedilebileceği hatalar.

JSON gösterimi
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Alanlar
type

enum (ErrorType)

Gerekli: Bu, bir siparişin satıcı tarafından reddedilmesinin ayrıntılı nedenini temsil eder.

description

string

Ek hata açıklaması.

entityId

string

Hataya karşılık gelen varlık kimliği. Örnek; LineItemId / ItemOptionId'ye karşılık gelebilir.

updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE hata türüyle alakalıdır.

availableQuantity

integer

Şu anda kullanılabilir miktar. AVAILABILITY_CHANGED durumunda geçerlidir.

TicketOrderExtension

Film, spor vb. bilet siparişlerinin içerikleri

JSON gösterimi
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Alanlar
ticketEvent

object (TicketEvent)

Etkinlik, tüm satır öğesi biletlerine uygulandı.

TicketEvent

Tek bir etkinliği temsil eder.

JSON gösterimi
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Alanlar
type

enum (Type)

Gerekli: bilet etkinliğinin türü (ör. film, konser).

name

string

Zorunlu: Etkinliğin adı. Örneğin, etkinlik bir filmse, bunun film adı olması gerekir.

description

string

açıklamaya çalışın.

url

string

Etkinlik bilgisinin URL'si.

location

object (Location)

Etkinliğin gerçekleştiği veya bir kuruluşun bulunduğu konum.

eventCharacters[]

object (EventCharacter)

Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya aktörleri ya da bir konserin sanatçıları vb.

startDate

object (Time)

Başlangıç zamanı.

endDate

object (Time)

Bitiş zamanı.

doorTime

object (Time)

Giriş saati. Bu saat, etkinliğin başlangıç zamanından farklı olabilir. Örneğin, etkinlik 09:00'da başlıyor ancak giriş saati 08:30'da.

EventCharacter

Bir etkinlik karakteri, ör. organizatör, sanatçı vb.

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

enum (Type)

etkinlik karakterinin türü (ör. oyuncu veya yönetmen).

name

string

karakterin adı.

image

object (Image)

Karakterlerin resimleri.