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 |
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 ( |
Alanlar | ||
---|---|---|
header |
Siparişi güncelleme isteğinin başlığı. |
|
orderUpdate.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 |
Google tarafından atanan sipariş kimliği. |
|
orderUpdate.order.userVisibleOrderId |
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 |
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 |
Alıcı hakkında bilgi. |
|
orderUpdate.order.image |
Siparişle ilişkilendirilen resim. |
|
orderUpdate.order.createTime |
Gerekli: Siparişin oluşturulduğu tarih ve saat. RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: |
|
orderUpdate.order.lastUpdateTime |
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: |
|
orderUpdate.order.transactionMerchant |
Ö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 |
Gerekli: Satır öğesi grubu olan sipariş içeriği. |
|
orderUpdate.order.priceAttributes[] |
Fiyat, indirimler, vergiler vb. |
|
orderUpdate.order.followUpActions[] |
Sipariş seviyesinde takip işlemleri. |
|
orderUpdate.order.paymentData |
Sipariş için ödemeyle ilgili veriler. |
|
orderUpdate.order.termsOfServiceUrl |
Sipariş/teklif edilen sipariş için geçerli olan hizmet şartlarının bağlantısı. |
|
orderUpdate.order.note |
Bir siparişe ekli notlar. |
|
orderUpdate.order.promotions[] |
Bu siparişle ilişkili tüm promosyonlar. |
|
orderUpdate.order.disclosures[] |
Bu siparişle ilgili açıklamalar. |
|
orderUpdate.order.vertical |
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: Rastgele türde alanlar içeren bir nesne. |
|
orderUpdate.updateMask |
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: |
|
orderUpdate.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 |
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 |
Satın alma siparişi |
|
orderUpdate.order.ticket |
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 ( |
Alanlar | |
---|---|
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 |
|
updateMask |
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: |
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 |
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 |
Kullanıcı bildiriminin başlığı. İzin verilen maksimum uzunluk 30 karakterdir. |
text |
Bildirimin içeriği. İzin verilen maksimum uzunluk 100 karakterdir. |