Tạo thông tin đặt chỗ

Hướng dẫn này sẽ trình bày quy trình phát triển một dự án Actions (Hành động) có sử dụng API đơn đặt hàng để đặt trước.

Luồng giao dịch

Khi dự án Actions của bạn xử lý các mục đặt trước, dự án đó sẽ sử dụng quy trình sau:

  1. Xác thực các yêu cầu về giao dịch (không bắt buộc) – Sử dụng trình trợ giúp về yêu cầu về giao dịch khi bắt đầu cuộc trò chuyện để đảm bảo người dùng có thể thực hiện giao dịch.
  2. Tạo đơn đặt hàng – Hướng dẫn người dùng thực hiện quy trình "tập hợp giỏ hàng" để họ tạo thông tin chi tiết cho giao dịch đặt trước.
  3. Đề xuất đơn đặt hàng – Sau khi "giỏ hàng" hoàn tất, hãy đề xuất "đơn đặt hàng" đặt trước cho người dùng để họ có thể xác nhận đặt hàng là chính xác. Nếu yêu cầu đặt trước được xác nhận, bạn sẽ nhận được phản hồi kèm theo thông tin đặt trước.
  4. Hoàn tất đơn đặt hàng và gửi biên nhận – Sau khi xác nhận đơn đặt hàng, hãy cập nhật hệ thống đặt trước của bạn và gửi biên nhận cho người dùng.
  5. Gửi thông tin cập nhật về đơn đặt hàng – Trong suốt thời gian hoạt động của yêu cầu đặt trước, hãy cung cấp thông tin cập nhật về trạng thái đặt trước của người dùng bằng cách gửi yêu cầu PATCH tới API đơn đặt hàng.

Các quy định hạn chế và nguyên tắc về bài đánh giá

Xin lưu ý rằng các chính sách bổ sung áp dụng cho những Hành động sử dụng giao dịch và API đơn đặt hàng. Có thể mất đến 6 tuần để chúng tôi xem xét Hành động có giao dịch, vì vậy, hãy tính thời gian đó khi lên kế hoạch cho lịch phát hành. Để quá trình xem xét diễn ra dễ dàng, hãy đảm bảo bạn tuân thủ các chính sách và nguyên tắc về giao dịch trước khi gửi Hành động đi xem xét.

Bạn chỉ có thể triển khai Hành động sử dụng API Đơn đặt hàng ở những quốc gia sau đây:

Úc
Brazil
Canada
Indonesia 		Nhật Bản
Mexico
Qatar
Nga 		Singapore
Thuỵ Sĩ
Thái Lan
Thổ Nhĩ Kỳ
Vương quốc Anh
Hoa Kỳ

Xây dựng dự án của bạn

Để biết ví dụ bao quát về các cuộc trò chuyện giao dịch, hãy xem Mẫu giao dịch trong Node.js.

Thiết lập

Khi tạo Hành động, bạn phải chỉ định rằng bạn muốn thực hiện giao dịch trong Bảng điều khiển Actions.

Để thiết lập dự án và phương thức thực hiện, hãy làm như sau:

  1. Tạo dự án mới hoặc nhập dự án hiện có.
  2. Chuyển đến phần Triển khai > Thông tin thư mục.

  3. Trong phần Thông tin bổ sung > Giao dịch >, hãy đánh dấu hộp có nội dung "Hành động của bạn có sử dụng API Giao dịch để thực hiện các giao dịch đối với hàng hoá thực không?".

Xác thực các yêu cầu về giao dịch (không bắt buộc)

Ngay khi người dùng cho biết họ muốn thiết lập yêu cầu đặt chỗ, bạn nên kiểm tra để chắc chắn rằng họ có thể yêu cầu đặt chỗ. Ví dụ: khi được gọi, Hành động của bạn có thể hỏi "Bạn có muốn đặt chỗ ngồi không?" Nếu người dùng trả lời "có", bạn nên đảm bảo rằng họ có thể tiếp tục và cho họ cơ hội khắc phục mọi chế độ cài đặt khiến họ không thể tiếp tục giao dịch. Để làm như vậy, bạn nên chuyển sang một cảnh thực hiện kiểm tra các yêu cầu giao dịch.

Tạo yêu cầu đối với giao dịch Kiểm tra cảnh

  1. Trên thẻ Scenes (Cảnh), hãy thêm một cảnh mới có tên TransactionRequirementsCheck.
  2. Trong mục Lấp đầy khe, hãy nhấp vào dấu + để thêm một vùng mới.
  3. Trong mục Chọn loại, hãy chọn actions.type.TransactionRequirementsCheckResult làm loại vùng.
  4. Trong trường tên khe, hãy đặt tên cho vị trí là TransactionRequirementsCheck.
  5. Bật hộp kiểm Tùy chỉnh ghi lại giá trị vị trí (được bật theo mặc định).

  6. Nhấp vào Lưu.

Quy trình kiểm tra yêu cầu đối với giao dịch sẽ dẫn đến một trong các kết quả sau:

  • Nếu các yêu cầu được đáp ứng, thông số phiên sẽ được đặt với điều kiện thành công và bạn có thể tiếp tục tạo đơn đặt hàng của người dùng.
  • Nếu không thể đáp ứng một hoặc nhiều yêu cầu, thông số phiên sẽ được đặt bằng một điều kiện lỗi. Trong trường hợp này, bạn nên chuyển cuộc trò chuyện khỏi trải nghiệm giao dịch hoặc kết thúc cuộc trò chuyện.
    • Nếu người dùng có thể khắc phục bất kỳ lỗi nào dẫn đến trạng thái lỗi, họ sẽ được nhắc khắc phục các vấn đề đó trên thiết bị. Nếu cuộc trò chuyện diễn ra trên nền tảng chỉ có giọng nói, thì điện thoại của người dùng sẽ nhận được lệnh chuyển giao.

Xử lý kết quả kiểm tra các yêu cầu đối với giao dịch

  1. Trên thẻ Scenes (Cảnh), hãy chọn cảnh TransactionRequirementsCheck mới tạo.
  2. Trong mục Điều kiện, hãy nhấp vào dấu + để thêm một điều kiện mới.

  3. Trong trường văn bản, hãy nhập cú pháp điều kiện sau để kiểm tra điều kiện thành công:

    scene.slots.status == "FINAL" && session.params.TransactionRequirementsCheck.resultType == "CAN_TRANSACT"

  4. Di chuột qua điều kiện bạn vừa thêm rồi nhấp vào mũi tên lên để đặt điều kiện đó trước if scene.slots.status == "FINAL".

  5. Bật tính năng Gửi lời nhắc và cung cấp một lời nhắc đơn giản cho người dùng biết rằng họ đã sẵn sàng thực hiện giao dịch:

    candidates:
  - first_simple:
      variants:
        - speech: >-
            Looks like you're good to go!.

  6. Trong phần Chuyển đổi, hãy chọn một cảnh khác, cho phép người dùng tiếp tục cuộc trò chuyện và thực hiện giao dịch.

  7. Chọn điều kiện else if scene.slots.status == "FINAL".

  8. Bật tính năng Gửi lời nhắc và đưa ra một lời nhắc đơn giản cho người dùng biết rằng họ không thể thực hiện giao dịch:

    candidates:
  - first_simple:
      variants:
        - speech: Transaction requirements check failed.

  9. Trong phần Chuyển đổi, hãy chọn Kết thúc cuộc trò chuyện để kết thúc cuộc trò chuyện nếu người dùng không thể thực hiện giao dịch.

Tạo đơn đặt hàng

Sau khi bạn có thông tin người dùng cần thiết, hãy tạo trải nghiệm "tập hợp giỏ hàng" để hướng dẫn người dùng tạo mục hàng đặt trước. Mỗi Hành động sẽ có quy trình tập hợp giỏ hàng hơi khác một chút, phù hợp với dịch vụ của chúng.

Trong trải nghiệm tập hợp giỏ hàng cơ bản, người dùng sẽ chọn các tuỳ chọn trong một danh sách để thêm vào mục đặt trước của mình, mặc dù bạn có thể thiết kế cuộc trò chuyện để đơn giản hoá trải nghiệm người dùng. Ví dụ: tạo trải nghiệm tập hợp giỏ hàng cho phép người dùng lên lịch đặt trước hằng tháng chỉ với câu hỏi đơn giản có hoặc không. Bạn cũng có thể hiển thị cho người dùng băng chuyền hoặc thẻ danh sách các mục đặt trước "nên dùng".

Bạn nên sử dụng câu trả lời chi tiết để trình bày các lựa chọn của người dùng một cách trực quan, đồng thời thiết kế cuộc trò chuyện để người dùng có thể tạo giỏ hàng chỉ bằng giọng nói. Để biết một số phương pháp hay nhất và ví dụ về trải nghiệm tập hợp giỏ hàng, hãy xem phần Nguyên tắc thiết kế.

Tạo đơn đặt hàng

Trong suốt cuộc trò chuyện, hãy thu thập thông tin đặt trước của người dùng rồi tạo đối tượng Order.

Ở mức tối thiểu, Order của bạn phải có:

  • buyerInfo – Thông tin về người dùng mua hàng.
  • transactionMerchant – Thông tin về người bán hỗ trợ đơn đặt hàng.
  • contents – Nội dung thực tế của đơn đặt hàng được liệt kê là lineItems.

Tham khảo tài liệu về phản hồi Order để tạo giỏ hàng. Lưu ý rằng bạn có thể cần phải bao gồm các trường khác nhau tuỳ thuộc vào yêu cầu đặt trước.

Mã mẫu dưới đây cho thấy một đơn đặt hàng đặt trước hoàn chỉnh, bao gồm cả các trường không bắt buộc:

const order = {
   createTime: '2019-09-24T18:00:00.877Z',
   lastUpdateTime: '2019-09-24T18:00:00.877Z',
   merchantOrderId: orderId, // A unique ID String for the order
   userVisibleOrderId: orderId,
   transactionMerchant: {
     id: 'http://www.example.com',
     name: 'Example Merchant',
   },
   contents: {
     lineItems: [
       {
         id: 'LINE_ITEM_ID',
         name: 'Dinner reservation',
         description: 'A world of flavors all in one destination.',
         reservation: {
           status: 'PENDING',
           userVisibleStatusLabel: 'Reservation is pending.',
           type: 'RESTAURANT',
           reservationTime: {
             timeIso8601: '2020-01-16T01:30:15.01Z',
           },
           userAcceptableTimeRange: {
             timeIso8601: '2020-01-15/2020-01-17',
           },
           partySize: 6,
           staffFacilitators: [
             {
               name: 'John Smith',
             },
           ],
           location: {
             zipCode: '94086',
             city: 'Sunnyvale',
             postalAddress: {
               regionCode: 'US',
               postalCode: '94086',
               administrativeArea: 'CA',
               locality: 'Sunnyvale',
               addressLines: [
                 '222, Some other Street',
               ],
             },
           },
         },
       },
     ],
   },
   buyerInfo: {
     email: 'janedoe@gmail.com',
     firstName: 'Jane',
     lastName: 'Doe',
     displayName: 'Jane Doe',
   },
   followUpActions: [
     {
       type: 'VIEW_DETAILS',
       title: 'View details',
       openUrlAction: {
         url: 'http://example.com',
       },
     },
     {
       type: 'CALL',
       title: 'Call us',
       openUrlAction: {
         url: 'tel:+16501112222',
       },
     },
     {
       type: 'EMAIL',
       title: 'Email us',
       openUrlAction: {
         url: 'mailto:person@example.com',
       },
     },
   ],
   termsOfServiceUrl: 'http://www.example.com'
 };

Tạo các tuỳ chọn thứ tự và trình bày

const orderOptions = {
      'requestDeliveryAddress': false,
    };

const presentationOptions = {
      'actionDisplayName': 'RESERVE'
    };

Lưu dữ liệu đơn đặt hàng trong tham số phiên

Từ phương thức thực hiện đơn hàng, hãy lưu dữ liệu đơn đặt hàng vào tham số phiên hoạt động. Đối tượng thứ tự sẽ được dùng trên các cảnh trong cùng một phiên hoạt động.

conv.session.params.order = {
    '@type': 'type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec',
    order: order,
    orderOptions: orderOptions,
    presentationOptions: presentationOptions
};

Đề xuất đơn đặt hàng

Sau khi tạo đơn đặt hàng, bạn phải hiển thị đơn đặt hàng đó cho người dùng để xác nhận hoặc từ chối. Để làm như vậy, bạn nên chuyển sang một cảnh đưa ra quyết định về giao dịch.

Tạo cảnh Quyết định giao dịch

  1. Trên thẻ Scenes (Cảnh), hãy thêm một cảnh mới có tên TransactionDecision.
  2. Trong mục Lấp đầy khe, hãy nhấp vào dấu + để thêm một vùng mới.
  3. Trong mục Chọn loại, hãy chọn actions.type.TransactionDecisionValue làm loại vùng.
  4. Trong trường tên khe, hãy đặt tên cho vị trí là TransactionDecision.
  5. Bật hộp kiểm Tùy chỉnh ghi lại giá trị vị trí (được bật theo mặc định).
  6. Trong mục Định cấu hình vị trí, hãy chọn Sử dụng tham số phiên trên trình đơn thả xuống.
  7. Trong mục Định cấu hình khe,hãy nhập tên của tham số phiên được dùng để lưu trữ đơn đặt hàng vào trường văn bản (tức là $session.params.order).

  8. Nhấp vào Lưu.

Để lấp đầy một vị trí TransactionDecisionValue, Trợ lý sẽ bắt đầu một trải nghiệm tích hợp, trong đó Order bạn đã chuyển sẽ hiển thị trực tiếp vào "thẻ xem trước giỏ hàng". Người dùng có thể nói "lên lịch đặt trước", từ chối giao dịch hoặc yêu cầu thay đổi thông tin đặt trước.

Người dùng cũng có thể yêu cầu thay đổi đơn đặt hàng tại thời điểm này. Trong trường hợp này, bạn nên đảm bảo phương thức thực hiện của mình có thể xử lý các yêu cầu thay đổi đơn đặt hàng sau khi hoàn tất trải nghiệm lắp ráp giỏ hàng.

Xử lý kết quả Quyết định giao dịch

Khi một vị trí TransactionDecisionValue được lấp đầy, câu trả lời của người dùng về quyết định giao dịch sẽ được lưu trữ trong thông số phiên. Giá trị này chứa:

  • ORDER_ACCEPTED,
  • ORDER_REJECTED,
  • CART_CHANGE_REQUESTED
  • USER_CANNOT_TRANSACT.

Cách xử lý kết quả quyết định về giao dịch:

  1. Trên thẻ Cảnh, hãy chọn cảnh bạn mới tạo TransactionDecision.
  2. Trong mục Điều kiện, hãy nhấp vào dấu + để thêm một điều kiện mới.

  3. Trong trường văn bản, hãy nhập cú pháp điều kiện sau để kiểm tra điều kiện thành công:

    scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_ACCEPTED"

  4. Di chuột qua điều kiện bạn vừa thêm rồi nhấp vào mũi tên lên để đặt điều kiện đó trước if scene.slots.status == "FINAL".

  5. Bật tính năng Gửi lời nhắc và cung cấp một lời nhắc đơn giản cho người dùng biết việc đặt trước của họ đã hoàn tất:

    candidates:
  - first_simple:
      variants:
        - speech: >-
            Transaction completed! Your reservation
            $session.params.TransactionDecision.order.merchantOrderId is all
            set!

  6. Trong phần Chuyển tiếp, hãy chọn Kết thúc cuộc trò chuyện để kết thúc cuộc trò chuyện.

  7. Trong mục Điều kiện, hãy nhấp vào dấu + để thêm một điều kiện mới.

  8. Trong trường văn bản, hãy nhập cú pháp điều kiện sau để kiểm tra các điều kiện không đạt:

      scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_REJECTED"

  9. Di chuột qua điều kiện bạn vừa thêm rồi nhấp vào mũi tên lên để đặt điều kiện đó trước if scene.slots.status == "FINAL".

  10. Bật tính năng Gửi lời nhắc và cung cấp một lời nhắc đơn giản cho người dùng biết rằng đơn đặt hàng đã bị từ chối:

    candidates:
  - first_simple:
      variants:
        - speech: Looks like you don't want to set up a reservation. Goodbye.

  11. Trong phần Chuyển tiếp, hãy chọn Kết thúc cuộc trò chuyện để kết thúc cuộc trò chuyện.

  12. Chọn điều kiện else if scene.slots.status == "FINAL".

  13. Bật tính năng Gửi lời nhắc và đưa ra một lời nhắc đơn giản cho người dùng biết rằng họ không thể thực hiện giao dịch:

    candidates:
  - first_simple:
      variants:
        - speech: >-
            Transaction failed with status
            $session.params.TransactionDecision.transactionDecision

  14. Trong phần Chuyển đổi, hãy chọn Kết thúc cuộc trò chuyện để kết thúc cuộc trò chuyện nếu người dùng không thể thực hiện giao dịch.

Hoàn tất yêu cầu đặt chỗ và gửi biên nhận

Khi vị trí TransactionDecisionValue trả về kết quả là ORDER_ACCEPTED, bạn phải ngay lập tức thực hiện bất kỳ quá trình xử lý nào cần thiết để lên lịch đặt trước (chẳng hạn như lưu giữ kết quả trong cơ sở dữ liệu của riêng bạn).

Gửi phản hồi đơn giản để duy trì cuộc trò chuyện. Người dùng sẽ nhận được một "thẻ biên nhận đã thu gọn" cùng với phản hồi của bạn.

Cách gửi thông tin cập nhật về đơn đặt hàng ban đầu:

  1. Trên thẻ Scenes (Cảnh), hãy chọn cảnh TransactionDecision của bạn.

  2. Trong phần Điều kiện, hãy chọn điều kiện kiểm tra kết quả thành công, ORDER_ACCEPTED:

    scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_ACCEPTED"

  3. Đối với điều kiện này, hãy bật Gọi webhook và cung cấp tên trình xử lý ý định, chẳng hạn như update_order.

  4. Trong mã webhook của bạn, hãy thêm một trình xử lý ý định để gửi thông tin cập nhật đơn đặt hàng ban đầu:

    app.handle('update_order', conv => {
  const currentTime = new Date().toISOString();
  let order = conv.session.params.TransactionDecision.order;
  conv.add(new OrderUpdate({
    'updateMask': {
      'paths': [
        'reservation.status',
        'reservation.user_visible_status_label',
        'reservation.confirmation_code'
      ]
    },
    'order': {
      'merchantOrderId': order.merchantOrderId,
      'lastUpdateTime': currentTime,
      'reservation': {
        'status': 'CONFIRMED',
        'userVisibleStatusLabel': 'Reservation confirmed',
        'confirmationCode': '123ABCDEFGXYZ',
      },
    },
    'reason': 'Reason string'
  }));
});

Gửi thông tin cập nhật về đơn đặt hàng

Trạng thái đặt trước sẽ thay đổi trong suốt vòng đời. Gửi nội dung cập nhật về đơn đặt hàng đặt trước của người dùng có yêu cầu HTTP PATCH tới API đơn đặt hàng, trong đó chứa trạng thái và thông tin chi tiết về đơn đặt hàng.

Thiết lập các yêu cầu không đồng bộ cho API đơn đặt hàng

Các yêu cầu cập nhật đơn đặt hàng đối với API Đơn đặt hàng được uỷ quyền bằng một mã truy cập. Để PATCH cập nhật đơn đặt hàng lên API đơn đặt hàng, hãy tải khoá tài khoản dịch vụ JSON liên kết với dự án Actions Console của bạn, sau đó đổi khoá tài khoản dịch vụ lấy mã thông báo truy cập có thể được truyền vào tiêu đề Authorization của yêu cầu HTTP.

Để truy xuất khoá tài khoản dịch vụ của bạn, hãy thực hiện các bước sau:

  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn STDEV > API và Dịch vụ > Thông tin xác thực > Tạo thông tin xác thực > Khoá tài khoản dịch vụ.
  2. Trong phần Tài khoản dịch vụ, hãy chọn Tài khoản dịch vụ mới.
  3. Đặt tài khoản dịch vụ thành service-account.
  4. Đặt Role thành Project > Owner (Dự án > Chủ sở hữu).
  5. Đặt loại khoá thành JSON.
  6. Chọn Tạo.
  7. Khoá tài khoản dịch vụ JSON riêng tư sẽ được tải xuống máy cục bộ của bạn.

Trong mã cập nhật đơn đặt hàng của bạn, hãy đổi khoá dịch vụ lấy mã thông báo truy cập bằng cách sử dụng thư viện ứng dụng API của Google và phạm vi "https://www.googleapis.com/auth/actions.order.developer". Bạn có thể tìm thấy các bước cài đặt và ví dụ trên trang GitHub trong thư viện ứng dụng API.

Hãy tham khảo order-update.js trong mẫu Node.js của chúng tôi để biết ví dụ về trao đổi khoá.

Gửi thông tin cập nhật về đơn đặt hàng

Sau khi bạn đã đổi khoá tài khoản dịch vụ của mình lấy mã thông báo truy cập OAuth, hãy gửi thông tin cập nhật đơn đặt hàng dưới dạng yêu cầu PATCH được uỷ quyền tới API đơn đặt hàng.

URL của API Đơn đặt hàng: PATCH https://actions.googleapis.com/v3/orders/${orderId}

Cung cấp các tiêu đề sau trong yêu cầu của bạn:

  • "Authorization: Bearer token" bằng mã thông báo truy cập OAuth mà bạn đã đổi khoá tài khoản dịch vụ của mình.
  • "Content-Type: application/json".

Yêu cầu PATCH phải có nội dung JSON có định dạng sau:

{ "orderUpdate": OrderUpdate }

Đối tượng OrderUpdate bao gồm các trường cấp cao nhất sau đây:

  • updateMask – Các trường của đơn đặt hàng bạn đang cập nhật. Để cập nhật trạng thái đặt trước, hãy đặt giá trị thành reservation.status, reservation.userVisibleStatusLabel.

  • order – Nội dung của bản cập nhật. Nếu bạn đang cập nhật nội dung của phần đặt trước, hãy đặt giá trị thành đối tượng Order cập nhật. Nếu bạn chỉ cập nhật trạng thái của yêu cầu đặt trước (ví dụ: từ "PENDING" thành "FULFILLED"), thì đối tượng này sẽ chứa các trường sau:

    • merchantOrderId – Mã nhận dạng mà bạn đã đặt cho đối tượng Order.
    • lastUpdateTime – Dấu thời gian của lần cập nhật này.
    • purchase – Đối tượng chứa:
      • status – Trạng thái của đơn đặt hàng dưới dạng ReservationStatus, chẳng hạn như "CONFIRMED" hoặc "CANCELLED".
      • userVisibleStatusLabel – Một nhãn dành cho người dùng, cung cấp thông tin chi tiết về trạng thái đơn đặt hàng, chẳng hạn như "Yêu cầu đặt chỗ của bạn đã được xác nhận".

  • userNotification có thể hiển thị trên thiết bị của người dùng khi bản cập nhật này được gửi. Xin lưu ý rằng việc thêm đối tượng này không đảm bảo rằng thông báo sẽ xuất hiện trên thiết bị của người dùng.

Mã mẫu sau đây minh hoạ một OrderUpdate mẫu cập nhật trạng thái của đơn đặt hàng trước thành FULFILLED:

// Import the 'googleapis' module for authorizing the request.
const {google} = require('googleapis');
// Import the 'request-promise' module for sending an HTTP POST request.
const request = require('request-promise');
// Import the OrderUpdate class from the client library.
const {OrderUpdate} = require('@assistant/conversation');

// Import the service account key used to authorize the request.
// Replacing the string path with a path to your service account key.
// i.e. const serviceAccountKey = require('./service-account.json')

// Create a new JWT client for the Actions API using credentials
// from the service account key.
let jwtClient = new google.auth.JWT(
   serviceAccountKey.client_email,
   null,
   serviceAccountKey.private_key,
   ['https://www.googleapis.com/auth/actions.order.developer'],
   null,
);

// Authorize the client
let tokens = await jwtClient.authorize();

// Declare the ID of the order to update.
const orderId = '<UNIQUE_MERCHANT_ORDER_ID>';

// Declare order update
const orderUpdate = new OrderUpdate({
   updateMask: {
     paths: [
       'contents.lineItems.reservation.status',
       'contents.lineItems.reservation.userVisibleStatusLabel'
     ]
   },
   order: {
     merchantOrderId: orderId, // Specify the ID of the order to update
     lastUpdateTime: new Date().toISOString(),
     contents: {
       lineItems: [
         {
           reservation: {
             status: 'FULFILLED',
             userVisibleStatusLabel: 'Reservation fulfilled',
           },
         }
       ]
     },
   },
   reason: 'Reservation status was updated to fulfilled.',
});

// Set up the PATCH request header and body,
// including the authorized token and order update.
let options = {
 method: 'PATCH',
 uri: `https://actions.googleapis.com/v3/orders/${orderId}`,
 auth: {
   bearer: tokens.access_token,
 },
 body: {
   header: {
     isInSandbox: true,
   },
   orderUpdate,
 },
 json: true,
};

// Send the PATCH request to the Orders API.
try {
 await request(options);
} catch (e) {
 console.log(`Error: ${e}`);
}

Đặt trạng thái đặt chỗ

ReservationStatus của bản cập nhật đơn đặt hàng phải mô tả trạng thái hiện tại của đơn đặt hàng. Trong trường order.ReservationStatus của bản cập nhật, hãy dùng một trong những giá trị sau:

  • PENDING – Hành động của bạn đã "tạo" yêu cầu đặt chỗ nhưng cần xử lý thêm trên máy chủ phụ trợ.
  • CONFIRMED – Yêu cầu đặt chỗ đã được xác nhận trong phần phụ trợ lập lịch biểu của bạn.
  • CANCELLED – Người dùng đã huỷ yêu cầu đặt chỗ.
  • FULFILLED – Yêu cầu đặt chỗ của người dùng đã được dịch vụ thực hiện.
  • CHANGE_REQUESTED – Người dùng đã yêu cầu thay đổi thông tin đặt trước và thay đổi đó đang được xử lý.
  • REJECTED – Nếu bạn không thể xử lý hoặc xác nhận yêu cầu đặt phòng.

Gửi thông tin cập nhật về đơn đặt hàng cho từng trạng thái liên quan đến yêu cầu đặt trước của bạn. Ví dụ: nếu yêu cầu đặt trước của bạn yêu cầu xử lý thủ công để xác nhận việc đặt trước sau khi được yêu cầu, hãy gửi thông tin cập nhật về đơn đặt hàng PENDING cho đến khi quá trình xử lý bổ sung đó hoàn tất. Không phải lượt đặt trước nào cũng yêu cầu tất cả giá trị trạng thái.

Kiểm thử dự án

Khi kiểm thử dự án, bạn có thể bật chế độ hộp cát trong bảng điều khiển Actions để kiểm thử Hành động của mình mà không tính phí cho phương thức thanh toán. Để bật chế độ hộp cát, hãy làm theo các bước sau:

  1. Trong bảng điều khiển Actions, hãy nhấp vào Test (Kiểm thử) trong bảng điều hướng.
  2. Nhấp vào Cài đặt.
  3. Bật tuỳ chọn Phát triển Hộp cát.

Đối với các giao dịch thực tế, bạn cũng có thể đặt trường isInSandbox thành true trong mẫu. Thao tác này tương đương với việc bật tuỳ chọn cài đặt chế độ hộp cát trong bảng điều khiển Actions. Để xem đoạn mã sử dụng isInSandbox, hãy xem phần Gửi thông tin cập nhật về đơn đặt hàng.

Khắc phục sự cố

Nếu bạn gặp vấn đề nào trong quá trình kiểm thử, hãy đọc các bước khắc phục sự cố của chúng tôi để biết thông tin về các giao dịch.