Method: orders.patch

3p থেকে AOG-তে অর্ডার আপডেট করুন। অর্ডারের আইডি খালি থাকলে বা বিদ্যমান অর্ডারের সমান না হলে INVALID_ARGUMENT ফেরত দেয়।

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
orderUpdate.order.merchantOrderId

string

প্রয়োজনীয়: বণিক নির্ধারিত অভ্যন্তরীণ অর্ডার আইডি। এই আইডিটি অবশ্যই অনন্য হতে হবে এবং পরবর্তী অর্ডার আপডেট অপারেশনের জন্য প্রয়োজন। এই আইডি প্রদত্ত googleOrderId বা অন্য কোনো অনন্য মান সেট করা হতে পারে। মনে রাখবেন যে ব্যবহারকারীদের কাছে উপস্থাপিত আইডি হল userVisibleOrderId, যা একটি ভিন্ন, আরও ব্যবহারকারী-বান্ধব মান হতে পারে। সর্বাধিক অনুমোদিত দৈর্ঘ্য 64 অক্ষর।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "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
  }
}
ক্ষেত্র
header

object ( OrderRequestHeader )

আপডেট অর্ডার অনুরোধের জন্য শিরোনাম.

orderUpdate.type
(deprecated)

enum ( Type )

বাতিল করা হয়েছে: পরিবর্তে OrderUpdate.update_mask ব্যবহার করুন। যদি টাইপ = SNAPSHOT, OrderUpdate.order পুরো অর্ডার হওয়া উচিত। টাইপ = ORDER_STATUS হলে, এটি অর্ডার স্তরের স্থিতি পরিবর্তন। শুধুমাত্র order.last_update_time এবং এই উল্লম্ব স্ট্যাটাস নেওয়া হয়। দ্রষ্টব্য: type.ORDER_STATUS শুধুমাত্র PurchaseOrderExtension স্ট্যাটাস আপডেট সমর্থন করে এবং এই সমর্থন প্রসারিত করার কোন পরিকল্পনা নেই। পরিবর্তে, আমরা আপডেটমাস্ক ব্যবহার করার পরামর্শ দিই কারণ এটি আরও জেনেরিক, এক্সটেনসিবল এবং সমস্ত উল্লম্বের জন্য ব্যবহার করা যেতে পারে।

orderUpdate.order.googleOrderId

string

গুগল নির্ধারিত অর্ডার আইডি।

orderUpdate.order.userVisibleOrderId

string

আইডির মুখোমুখি ব্যবহারকারী বর্তমান অর্ডারের উল্লেখ করে। এই আইডিটি ওয়েবসাইট, অ্যাপ এবং ইমেল সহ অন্যান্য প্রসঙ্গে এই অর্ডারের জন্য প্রদর্শিত আইডির সাথে সামঞ্জস্যপূর্ণ হওয়া উচিত।

orderUpdate.order.userVisibleStateLabel
(deprecated)

string

বাতিল করা হয়েছে: পরিবর্তে OrderExtensions স্ট্যাটাস ব্যবহার করুন। এই অর্ডারের অবস্থার জন্য ব্যবহারকারীর দৃশ্যমান লেবেল।

orderUpdate.order.buyerInfo

object ( UserInfo )

ক্রেতা সম্পর্কে তথ্য.

orderUpdate.order.image

object ( Image )

অর্ডারের সাথে যুক্ত ছবি।

orderUpdate.order.createTime

string ( Timestamp format)

প্রয়োজনীয়: তারিখ এবং সময় অর্ডার তৈরি করা হয়েছিল।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ডের জন্য সঠিক। উদাহরণ: "2014-10-02T15:01:23.045123456Z" ।

orderUpdate.order.lastUpdateTime

string ( Timestamp format)

তারিখ এবং সময় অর্ডার শেষ আপডেট করা হয়েছে. অর্ডারআপডেটের জন্য প্রয়োজন।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ডের জন্য সঠিক। উদাহরণ: "2014-10-02T15:01:23.045123456Z" ।

orderUpdate.order.transactionMerchant

object ( Merchant )

চেকআউট সহজতর যে বণিক. এটি একটি লাইন আইটেম স্তর প্রদানকারী থেকে ভিন্ন হতে পারে। উদাহরণ: ANA থেকে লাইন আইটেম সহ Expedia অর্ডার।

orderUpdate.order.contents

object ( Contents )

প্রয়োজনীয়: অর্ডার বিষয়বস্তু যা লাইন আইটেম একটি গ্রুপ.

orderUpdate.order.priceAttributes[]

object ( PriceAttribute )

মূল্য, ডিসকাউন্ট, ট্যাক্স এবং তাই.

orderUpdate.order.followUpActions[]

object ( Action )

অর্ডার স্তরে কর্ম অনুসরণ করুন.

orderUpdate.order.paymentData

object ( PaymentData )

অর্ডারের জন্য পেমেন্ট সম্পর্কিত ডেটা।

orderUpdate.order.termsOfServiceUrl

string

পরিষেবার শর্তাবলীর একটি লিঙ্ক যা অর্ডার/প্রস্তাবিত অর্ডারে প্রযোজ্য।

orderUpdate.order.note

string

একটি আদেশ সংযুক্ত নোট.

orderUpdate.order.promotions[]

object ( Promotion )

এই আদেশের সাথে যুক্ত সমস্ত প্রচার।

orderUpdate.order.disclosures[]

object ( Disclosure )

এই আদেশের সাথে যুক্ত প্রকাশ.

orderUpdate.order.vertical
(deprecated)

object

বাতিল করা হয়েছে: এর পরিবর্তে উল্লম্ব ব্যবহার করুন। এই বৈশিষ্ট্যগুলি সমস্ত লাইন আইটেমগুলিতে প্রযোজ্য হবে, যদি না কিছু লাইন আইটেমে ওভাররাইড করা হয়৷ এই উল্লম্ব অবশ্যই লাইন আইটেম স্তরের উল্লম্ব প্রকারের সাথে মিলবে৷ সম্ভাব্য মান: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

একটি নির্বিচারী ধরনের ক্ষেত্র ধারণকারী একটি বস্তু. একটি অতিরিক্ত ক্ষেত্র "@type" এ টাইপ সনাক্তকারী একটি URI রয়েছে৷ উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।

orderUpdate.updateMask

string ( FieldMask format)

দ্রষ্টব্য: নিম্নলিখিত বিশেষ ক্ষেত্রগুলির জন্য নিম্নলিখিত বিবেচনা/পরামর্শ রয়েছে: 1. order.last_update_time সর্বদা আপডেট অনুরোধের অংশ হিসাবে আপডেট করা হবে। 2. order.create_time, order.google_order_id এবং order.merchant_order_id উপেক্ষা করা হবে যদি আপডেটমাস্কের অংশ হিসাবে প্রদান করা হয়।

ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

orderUpdate.userNotification

object ( UserNotification )

নির্দিষ্ট করা হলে, নির্দিষ্ট শিরোনাম এবং পাঠ্য সহ ব্যবহারকারীকে একটি বিজ্ঞপ্তি প্রদর্শন করে। একটি বিজ্ঞপ্তি নির্দিষ্ট করা হল বিজ্ঞপ্তি দেওয়ার জন্য একটি পরামর্শ এবং এটি একটি বিজ্ঞপ্তির ফলে নিশ্চিত নয়৷

orderUpdate.reason

string

পরিবর্তন/আপডেট করার কারণ।

ইউনিয়ন ক্ষেত্র verticals . এই বৈশিষ্ট্যগুলি সমস্ত লাইন আইটেমগুলিতে প্রযোজ্য হবে, যদি না কিছু লাইন আইটেমে ওভাররাইড করা হয়৷ এই উল্লম্ব অবশ্যই লাইন আইটেম স্তরের উল্লম্ব প্রকারের সাথে মিলবে৷ verticals নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
orderUpdate.order.purchase

object ( PurchaseOrderExtension )

ক্রয় আদেশ

orderUpdate.order.ticket

object ( TicketOrderExtension )

টিকিট অর্ডার

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে Order একটি উদাহরণ থাকে।

অর্ডার আপডেট

একটি অর্ডার আপডেট.

JSON প্রতিনিধিত্ব
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
ক্ষেত্র
type
(deprecated)

enum ( Type )

বাতিল করা হয়েছে: পরিবর্তে OrderUpdate.update_mask ব্যবহার করুন। যদি টাইপ = SNAPSHOT, OrderUpdate.order পুরো অর্ডার হওয়া উচিত। টাইপ = ORDER_STATUS হলে, এটি অর্ডার স্তরের স্থিতি পরিবর্তন। শুধুমাত্র order.last_update_time এবং এই উল্লম্ব স্ট্যাটাস নেওয়া হয়। দ্রষ্টব্য: type.ORDER_STATUS শুধুমাত্র PurchaseOrderExtension স্ট্যাটাস আপডেট সমর্থন করে এবং এই সমর্থন প্রসারিত করার কোন পরিকল্পনা নেই। পরিবর্তে, আমরা আপডেটমাস্ক ব্যবহার করার পরামর্শ দিই কারণ এটি আরও জেনেরিক, এক্সটেনসিবল এবং সমস্ত উল্লম্বের জন্য ব্যবহার করা যেতে পারে।

order

object ( Order )

updateMask

string ( FieldMask format)

দ্রষ্টব্য: নিম্নলিখিত বিশেষ ক্ষেত্রগুলির জন্য নিম্নলিখিত বিবেচনা/পরামর্শ রয়েছে: 1. order.last_update_time সর্বদা আপডেট অনুরোধের অংশ হিসাবে আপডেট করা হবে। 2. order.create_time, order.google_order_id এবং order.merchant_order_id উপেক্ষা করা হবে যদি আপডেটমাস্কের অংশ হিসাবে প্রদান করা হয়।

ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

userNotification

object ( UserNotification )

নির্দিষ্ট করা হলে, নির্দিষ্ট শিরোনাম এবং পাঠ্য সহ ব্যবহারকারীকে একটি বিজ্ঞপ্তি প্রদর্শন করে। একটি বিজ্ঞপ্তি নির্দিষ্ট করা হল বিজ্ঞপ্তি দেওয়ার জন্য একটি পরামর্শ এবং এটি একটি বিজ্ঞপ্তির ফলে নিশ্চিত নয়৷

reason

string

পরিবর্তন/আপডেট করার কারণ।

টাইপ

বাতিল করা হয়েছে: পরিবর্তে OrderUpdate.update_mask ব্যবহার করুন। একটি অর্ডার আপডেটের অনুমতি দেওয়া হয়েছে.

এনামস
TYPE_UNSPECIFIED অনির্দিষ্ট টাইপ করুন, এটি স্পষ্টভাবে সেট করা উচিত নয়।
ORDER_STATUS শুধুমাত্র অর্ডারের অবস্থা আপডেট করুন।
SNAPSHOT অর্ডার স্ন্যাপশট আপডেট করুন।

ব্যবহারকারীর বিজ্ঞপ্তি

অর্ডার আপডেটের অংশ হিসেবে প্রদর্শনের জন্য ঐচ্ছিক ব্যবহারকারীর বিজ্ঞপ্তি।

JSON প্রতিনিধিত্ব
{
  "title": string,
  "text": string
}
ক্ষেত্র
title

string

ব্যবহারকারীর বিজ্ঞপ্তির শিরোনাম। সর্বাধিক অনুমোদিত দৈর্ঘ্য 30 অক্ষর।

text

string

বিজ্ঞপ্তির বিষয়বস্তু। সর্বাধিক অনুমোদিত দৈর্ঘ্য 100 অক্ষর।