Action

Hành động thể hiện một hành động tương tác cụ thể mà dự án hành động của bạn hỗ trợ. Hành động tương tác có thể diễn ra một lần hoặc nhiều bước.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
Các trường
name

string

tên của Hành động. Bạn phải cung cấp tên ngay cả khi đang sử dụng một ý định Hành động phổ biến trên Google (bắt đầu bằng "actions".). Ví dụ: nếu bạn đang sử dụng ý định "actions.intent.MAIN", thì tên Hành động theo quy ước sẽ là "MAIN". Gói Hành động phải khai báo ít nhất một Hành động.

fulfillment

object (Fulfillment)

Cách thực thi Hành động này.

intent

object (Intent)

Ý định mà Hành động này thực hiện. Tên của các ý định Hành động phổ biến trên Google bắt đầu bằng "actions". Các gói hành động cho tác nhân trò chuyện phải có ý định tên là "actions.intent.MAIN". Hãy tham khảo tại https://developers.google.com/actions/reference/rest/intents

description

string

Mô tả bằng tiếng Anh về hành động. Thông tin này chủ yếu được dùng để Google xem xét Hành động hoặc cho mục đích gỡ lỗi. Nội dung mô tả này sẽ không hiển thị cho người dùng. Mã này phải ít hơn 100 chữ cái ASCII.

signInRequired

boolean

Cho biết liệu có bắt buộc phải đăng nhập đối với Hành động này hay không. Xin lưu ý rằng điều này chỉ hợp lệ khi đối tượng ActionPackage có thuộc tính AccountLinks được chỉ định.

source
(deprecated)

string

Giá trị nhận dạng chuỗi của công cụ đã tạo Hành động này

Quy trình thực hiện đơn hàng

Cách thực thi một thao tác.

Biểu diễn dưới dạng JSON
{

  // Union field conversation can be only one of the following:
  "conversationName": string,
  "useDialogflowFulfillment": boolean
  // End of list of possible types for union field conversation.
}
Các trường

Trường nhóm conversation.

conversation chỉ có thể là một trong những trạng thái sau đây:

conversationName

string

Thực hiện một hành động thông qua phương thức thực hiện cuộc trò chuyện. Thao tác này tham chiếu trường "tên" của Conversations trong trường ActionPackage.conversations.

useDialogflowFulfillment

boolean

Trường này cho biết liệu có sử dụng phương thức thực hiện luồng hộp thoại hay không.

Intent

Ý định và các mẫu truy vấn liên kết với ý định đó được dùng để khớp với truy vấn của người dùng. Dùng cho lần kích hoạt ban đầu.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
Các trường
name

string

Cho biết tên của ý định này, ví dụ: BOOK_A_TABLE. Có thể là ý định tích hợp, bắt đầu bằng actions., trong trường hợp này, các tham số và mẫu truy vấn được ngụ ý và do đó bị bỏ qua.

parameters[]

object (Parameter)

Danh sách tham số trong queryPatterns. Bạn phải cung cấp tất cả tham số trong queryPatterns.

trigger

object (Trigger)

Thông số kích hoạt cho ý định này.

Thông số

Một tham số được sử dụng trong các lớp truy vấn. Đây là nội dung trình bày có cấu trúc về các tham số trong queryPatterns (ví dụ: $Color:color).

Biểu diễn dưới dạng JSON
{
  "name": string,
  "type": string
}
Các trường
name

string

tên của tham số, ví dụ: color.

type

string

của tham số. Có thể là loại phổ biến hoặc loại tuỳ chỉnh được khai báo trong gói hành động, ví dụ: Color.

Điều kiện kích hoạt

Thông số của điều kiện kích hoạt.

Biểu diễn dưới dạng JSON
{
  "queryPatterns": [
    string
  ]
}
Các trường
queryPatterns[]

string

Danh sách các mẫu dùng để xác định ý định đã chỉ định. Mẫu truy vấn chỉ được tham chiếu đến các tham số được khai báo trong trường thông số.