Method: orders.patch

3. gün olan siparişi AOG olarak güncelleyin. Siparişin kimliği boşsa veya mevcut bir siparişe eşit değilse GEÇERSİZ_BAĞLANTIYI 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

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 64 karakterdir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri 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ş güncelleme isteğinin başlığı.

orderUpdate.type
(deprecated)

enum (Type)

Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. = SNAPSHOT türündeyse, OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise bu, sipariş düzeyinde durum değişikliğidir. Yalnızca Order.last_update_time ve bu sektör/tema durumu alınır. Not: type.ORDER_STATUS yalnızca PurchaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamının genişletilmesi planlanmamaktadır. Bunun yerine, daha genel, genişletilebilir 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

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

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

orderUpdate.order.buyerInfo

object (UserInfo)

Alıcıyla ilgili bilgiler.

orderUpdate.order.image

object (Image)

Siparişle ilişkilendirilen resim.

orderUpdate.order.createTime

string (Timestamp format)

Zorunlu: 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. OrderUpdate 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 bir 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çerikleri.

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.

orderUpdate.order.followUpActions[]

object (Action)

Sipariş düzeyinde takip işlemleri.

orderUpdate.order.paymentData

object (PaymentData)

Siparişe ilişkin ödemeyle ilgili veriler.

orderUpdate.order.termsOfServiceUrl

string

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

orderUpdate.order.note

string

Bir siparişe notlar eklendi.

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

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 olur. Bu dikey, satır öğesi düzeyindeki dikey türle 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. "@type" adlı ek bir 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 alanlar için şu hususlar/öneriler geçerlidir: 1. order.last_update_time güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. order.create_time, order.google_order_id ve order.merchant_order_id gibi değerleri, updateMask kapsamında sağlanırsa yoksayılır.

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

orderUpdate.userNotification

object (UserNotification)

Belirtilirse kullanıcıya, belirtilen başlık ve metinle bir bildirim görüntüler. Bildirim belirtmek, bildirim gönderilmesi için bir öneridir ve bildirim gönderileceği garanti edilmez.

orderUpdate.reason

string

Değişiklik/güncelleme nedeni.

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

object (PurchaseOrderExtension)

Satın alma siparişi

orderUpdate.order.ticket

object (TicketOrderExtension)

Bilet sırası

Yanıt gövdesi

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

OrderUpdate

Siparişi güncelleyin.

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

enum (Type)

Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. = SNAPSHOT türündeyse, OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise bu, sipariş düzeyinde durum değişikliğidir. Yalnızca Order.last_update_time ve bu sektör/tema durumu alınır. Not: type.ORDER_STATUS, yalnızca Purcahase OrderExtension durum güncellemelerini destekler ve bu desteğin genişletilmesiyle ilgili bir plan yoktur. Bunun yerine, daha genel, genişletilebilir 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 alanlar için şu hususlar/öneriler geçerlidir: 1. order.last_update_time güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. order.create_time, order.google_order_id ve order.merchant_order_id gibi değerleri, updateMask kapsamında sağlanırsa yoksayılır.

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

userNotification

object (UserNotification)

Belirtilirse kullanıcıya, belirtilen başlık ve metinle bir bildirim görüntüler. Bir bildirimin belirtilmesi, bildirimde bulunulması önerilir ve bildirimle sonuçlanacağı garanti edilmez.

reason

string

Değişiklik/güncelleme nedeni.

Tür

Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. Bir siparişte izin verilen güncellemeler.

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

UserNotification

Sipariş güncellemesi kapsamında 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.