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 tüm alanların sayısı 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

Zorunlu: Satıcı tarafından atanan dahili sipariş kimliği. Bu kimlik benzersiz olmalıdır ve sonraki sipariş güncelleme işlemleri için gereklidir. Bu kimlik, sağlanan googleOrdersId veya başka bir benzersiz değere ayarlanabilir. Kullanıcılara sunulan kimlik, farklı ve daha kullanıcı dostu bir değer olan uservisible OrderId olabilir. İzin verilen maksimum uzunluk 128 karakterdir.

userVisibleOrderId

string

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

userVisibleStateLabel
(deprecated)

string

Desteği sonlandı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ı hakkındaki 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. OrderUpdate 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 bir sağlayıcıdan farklı olabilir. Örnek: ANA'dan satır öğesi içeren Expedia Siparişi.

contents

object (Contents)

Gerekli: Bir satır öğesi grubu olan sipariş içerikleri.

priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.

followUpActions[]

object (Action)

Sipariş düzeyinde takip işlemleri.

paymentData

object (PaymentData)

Siparişe ilişkin ödemeyle ilgili veriler.

termsOfServiceUrl

string

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

note

string

Bir siparişe notlar eklendi.

promotions[]

object (Promotion)

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

disclosures[]

object (Disclosure)

Bu siparişle ilgili açıklamalar.

vertical
(deprecated)

object

Desteği sonlandırıldı: Bunun yerine sektörleri kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör türüyle eşleşmelidir. Muhtemel değerler: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

Birleştirme alanı verticals. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör 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)

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu. Ödeme deneyimi Google'daki işlemler tarafından yönetiliyorsa bu alan Google'daki işlemlerle doldurulur.

paymentInfo

object (PaymentInfo)

Siparişle ilgili, kullanıcıların gördüğü etkileşimlerde faydalı olan ödeme bilgileri.

PaymentResult

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından 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
Birleştirme alanı result. Google ödeme verileri veya satıcı ödeme yöntemi sağlanır. result şunlardan yalnızca biri olabilir:
googlePaymentData

string

Google tarafından sağlanan ödeme yöntemi verileri. Ödeme işleyiciniz şu adreste Google tarafından desteklenen ödeme işleyici olarak listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla bilgi edinmek için bağlantıyı kullanarak ödeme işleyicinize gidin. Aksi takdirde yük ayrıntıları için aşağıdaki belgelere bakın. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Kullanıcı tarafından seçilen satıcı/işlem tarafından sağlanan ödeme yöntemi.

PaymentInfo

Verilen siparişle ilgili ödeme bilgileri. Bu protokol, 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öntemiyle ilgili gösterilen bilgiler.

paymentMethodProvenance

enum (PaymentMethodProvenance)

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

PaymentMethodDisplayInfo

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından 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ülebilen adı. Örneğin, VISA **** 1234 Çek hesabı **** 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ıkça 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)

Zorunlu: satın alma türü

returnsInfo

object (PurchaseReturnsInfo)

Siparişle ilgili iade bilgileri.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Siparişin sipariş karşılama bilgileri.

extension

object

Satıcı ile Google arasında aktarılan tüm ek alanlar.

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

purchaseLocationType

enum (PurchaseLocationType)

Satın alma yeri (mağazada / internette)

errors[]

object (PurchaseError)

İsteğe bağlı: Bu siparişin reddedilmesine neden olan 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 reddedilme nedenini ayrıntılı olarak gösterir.

description

string

Ek hata açıklaması.

entityId

string

Hataya karşılık gelen varlık kimliği. Örnek, bunun LineItemId / ItemOptionId öğesine karşılık gelebilir.

updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE hata türünde geçerlidir.

availableQuantity

integer

Kullanılabilir miktar. AVAILABILITY_CHANGED durumunda geçerlidir.

TicketOrderExtension

Film, spor vb. bilet siparişlerinin içeriği

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

object (TicketEvent)

Tüm satır öğesi biletlerine uygulanan etkinlik.

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 bu film adı olmalıdır.

description

string

etkinliğin açıklamasına yer verir.

url

string

Etkinlik bilgisinin URL'si.

location

object (Location)

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

eventCharacters[]

object (EventCharacter)

Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya oyuncuları ya da bir konserin performansları vb. olabilir.

startDate

object (Time)

Başlangıç zamanı.

endDate

object (Time)

Bitiş zamanı.

doorTime

object (Time)

Giriş saati. Bu saat, etkinlik başlangıç zamanından farklı olabilir. ör. Etkinlik sabah 9'da başlıyor, ancak giriş saati 08:30.

EventCharacter

Bir etkinlik karakteri, ör. düzenleyen, sanatçı vb.

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

enum (Type)

etkinlik karakterinin türü, ör. oyuncu ya da yönetmen.

name

string

karakterinin adını yazın.

image

object (Image)

Karakterin resimleri.