Method: orders.patch

Sipariş 3p olan ayarı AOG olarak güncelleyin. Siparişin kimliği boşsa veya mevcut bir siparişe eşit değilse INVALID_ARGUMENT değerini döndürür.

HTTP isteği

PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
orderUpdate.order.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 64 karakterdir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "header": {
    object (OrderRequestHeader)
  },
  "orderUpdate": {
    "type": enum (Type),
    "order": {
      "googleOrderId": 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.
    },
    "updateMask": string,
    "userNotification": {
      object (UserNotification)
    },
    "reason": string
  }
}
Alanlar
header

object (OrderRequestHeader)

Siparişi güncelleme isteğinin başlığı.

orderUpdate.type
(deprecated)

enum (Type)

Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_mask kullanın. Tür = SNAPSHOT ise OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise, bu, sipariş düzeyi durum değişikliğidir. Yalnızca order.last_update_time ve bu sektör durumu alınır. Not: type.ORDER_STATUS, yalnızca PurcahaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamını genişletme planı yoktur. Bunun yerine, daha genel ve genişletilebilir olduğundan ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz.

orderUpdate.order.googleOrderId

string

Google tarafından atanan sipariş kimliği.

orderUpdate.order.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.

orderUpdate.order.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.

orderUpdate.order.buyerInfo

object (UserInfo)

Alıcı hakkında bilgi.

orderUpdate.order.image

object (Image)

Siparişle ilişkilendirilen resim.

orderUpdate.order.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".
orderUpdate.order.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".
orderUpdate.order.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.

orderUpdate.order.contents

object (Contents)

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

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.

orderUpdate.order.followUpActions[]

object (Action)

Sipariş seviyesinde takip işlemleri.

orderUpdate.order.paymentData

object (PaymentData)

Sipariş için ödemeyle ilgili veriler.

orderUpdate.order.termsOfServiceUrl

string

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

orderUpdate.order.note

string

Bir siparişe ekli notlar.

orderUpdate.order.promotions[]

object (Promotion)

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

orderUpdate.order.disclosures[]

object (Disclosure)

Bu siparişle ilgili açıklamalar.

orderUpdate.order.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" }.
orderUpdate.updateMask

string (FieldMask format)

Not: Aşağıdaki özel alanlarla ilgili olarak dikkate alınması gereken bazı noktalar/öneriler mevcuttur: 1. order.last_update_time, güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. updateMask ile sağlanmışsa order.create_time, order.google_order_id ve order.merchant_order_id dikkate alınmaz.

Tam nitelikli alan adlarının virgülle ayrılmış listesi. Örnek: "user.displayName,photo".
orderUpdate.userNotification

object (UserNotification)

Belirtilmişse kullanıcıya belirtilen başlık ve metni içeren bir bildirim görüntüler. Bildirim belirlemek, bilgilendirme amaçlı bir öneridir ve bildirimle sonuçlanacağı garanti edilmez.

orderUpdate.reason

string

Değişikliğin/güncellemenin nedeni.

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:
orderUpdate.order.purchase

object (PurchaseOrderExtension)

Satın alma siparişi

orderUpdate.order.ticket

object (TicketOrderExtension)

Bilet siparişi

Yanıt gövdesi

Başarılıysa yanıt metni, Order öğesinin bir örneğini içerir.

OrderUpdate

Bir siparişe güncelleyin.

JSON gösterimi 
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Alanlar
type
(deprecated)

enum (Type)

Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_mask kullanın. Tür = SNAPSHOT ise OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise, bu, sipariş düzeyi durum değişikliğidir. Yalnızca order.last_update_time ve bu sektör durumu alınır. Not: type.ORDER_STATUS, yalnızca PurcahaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamını genişletme planı yoktur. Bunun yerine, daha genel ve genişletilebilir olduğundan ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz.
order

object (Order)
updateMask

string (FieldMask format)

Not: Aşağıdaki özel alanlarla ilgili olarak dikkate alınması gereken bazı noktalar/öneriler mevcuttur: 1. order.last_update_time, güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. updateMask ile sağlanmışsa order.create_time, order.google_order_id ve order.merchant_order_id dikkate alınmaz.

Tam nitelikli alan adlarının virgülle ayrılmış listesi. Örnek: "user.displayName,photo".
userNotification

object (UserNotification)

Belirtilmişse kullanıcıya belirtilen başlık ve metni içeren bir bildirim görüntüler. Bildirim belirlemek, bilgilendirme amaçlı bir öneridir ve bildirimle sonuçlanacağı garanti edilmez.

reason

string

Değişikliğin/güncellemenin nedeni.

Tür

Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_mask kullanın. Bir siparişte güncelleme yapılmasına izin veriliyor.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi, açık bir şekilde ayarlanmamalıdır.
ORDER_STATUS Yalnızca siparişin durumunu güncelleyin.
SNAPSHOT Sipariş anlık görüntüsünü güncelleyin.

UserNotification

Sipariş güncellemesinin bir parçası olarak gösterilecek isteğe bağlı kullanıcı bildirimi.

JSON gösterimi 
{
  "title": string,
  "text": string
}
Alanlar
title

string

Kullanıcı bildiriminin başlığı. İzin verilen maksimum uzunluk 30 karakterdir.

text

string

Bildirimin içeriği. İzin verilen maksimum uzunluk 100 karakterdir.