ActionPackage

ActionPackage lưu giữ nội dung cho bản nháp của một ứng dụng cũng như từng phiên bản đã triển khai. Trong đó có thông tin chi tiết trên trang thông tin thư mục, cấu hình cuộc trò chuyện và liên kết tài khoản.

Biểu diễn dưới dạng JSON
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Các trường
manifest

object (Manifest)

Thông tin chi tiết của Ứng dụng. Đây là nơi lưu giữ trang thông tin thư mục cũng như các thông tin nhận dạng ứng dụng khác, chẳng hạn như displayName.

accountLinking

object (AccountLinking)

Thông tin chi tiết về việc liên kết tài khoản trên ứng dụng này.

actions[]

object (Action)

Danh sách thao tác mà Ứng dụng có thể xử lý.

types[]

object (Type)

Danh sách các loại do nhà phát triển xác định.

conversations

map (key: string, value: object (ConversationFulfillment))

Bạn có thể chia sẻ các cuộc trò chuyện trên bản đồ trên actions. Ví dụ: hãy xem conversationName trong Fulfillment.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

locale

string

Ngôn ngữ cho gói hành động này. Điều này được biểu thị bằng các chuỗi ngôn ngữ BCP-47, chẳng hạn như "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK", v.v. Đây là yêu cầu bắt buộc khi một ứng dụng hỗ trợ nhiều ngôn ngữ. Mỗi ngôn ngữ được hỗ trợ đều có ActionPackage riêng. Nếu bạn không cung cấp giá trị thì ngôn ngữ mặc định của tác nhân sẽ được ngụ ý.

Tệp kê khai

Tập hợp siêu dữ liệu cho Ứng dụng. Nội dung của thông báo này được sử dụng trong nhiều ngữ cảnh:

  1. các hành động trên trang danh sách thư mục của Google.
  2. Giá trị nhận dạng duy nhất của một Ứng dụng để gọi rõ ràng (displayName).
  3. Nội dung của các phần khác của ActionPackage (shortDescription dùng để hiện trong AccountLinking, displayName dùng trong actions để hiện tên Ứng dụng cho người dùng).

Tin nhắn này ở chế độ chỉ có thể đọc. Bạn chỉ định các trường trong thông báo này thông qua bảng điều khiển hành động, chứ không phải trực tiếp trong gói hành động.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
Các trường
displayName

string

Tên hiển thị mặc định cho Ứng dụng này (nếu không có bản dịch), ví dụ: "discount". Đây cũng được dùng làm phương thức để người dùng gọi ra Ứng dụng này (ngoài invocationName). Tên hiển thị phải là duy nhất và có ngữ âm giống với invocationName.

invocationName

string

Đây là tên duy nhất để gọi Ứng dụng này trực tiếp trong ngữ cảnh bằng giọng nói. Các chính sách yêu cầu tên lệnh gọi phải giống với trường displayName về mặt ngữ âm.

enabledRegions[]

string (int64 format)

Mã tiêu chí AdWords cho các khu vực cho phép Ứng dụng dựa trên vị trí hiện diện của người dùng. Hãy truy cập vào https://developers.google.com/adwords/api/docs/appendix/geotargeting

disabledRegions[]

string (int64 format)

Mã tiêu chí AdWords cho những khu vực nơi Ứng dụng bị chặn dựa trên vị trí hiện diện của người dùng. Hãy truy cập vào https://developers.google.com/adwords/api/docs/appendix/geotargeting

shortDescription

string

Nội dung mô tả ngắn mặc định cho Ứng dụng (nếu không có bản dịch). Tên này chỉ chứa tối đa 80 ký tự.

longDescription

string

Nội dung mô tả dài mặc định cho Ứng dụng (nếu không có bản dịch). Mã này chỉ giới hạn trong 4000 ký tự.

category

string

Danh mục cho Ứng dụng. Giá trị phải là một trong những danh mục được phép đối với Ứng dụng. Hãy xem các thao tác trên Google Console để biết danh sách các danh mục được phép.

smallSquareLogoUrl

string

Hình ảnh vuông nhỏ. Kích thước phải là 192 px x 192 px.

largeLandscapeLogoUrl

string

Hình ảnh ngang lớn. Kích thước tối đa là 2208 px x 1242 px.

companyName

string

Tên của công ty liên kết với Ứng dụng.

contactEmail

string

Địa chỉ email liên hệ để người dùng có thể liên hệ với bạn về Ứng dụng.

termsOfServiceUrl

string

URL dẫn đến Điều khoản dịch vụ (Điều khoản dịch vụ) của ứng dụng.

privacyUrl

string

URL cho chính sách quyền riêng tư của ứng dụng.

sampleInvocation[]

string

Cụm từ của lời gọi mẫu hiển thị dưới dạng một phần của nội dung mô tả ứng dụng trong thư mục Tất cả ứng dụng. Bạn chỉ có thể cung cấp 5 giá trị.

introduction

string

Tóm tắt những việc mà Ứng dụng có thể làm. Dùng để giới thiệu ứng dụng cho người dùng. Đây phải là một cụm động từ để hoàn thành một câu như "Bạn có thể dùng ứng dụng này để..."

testingInstructions

string

Hướng dẫn thử nghiệm dạng biểu mẫu tuỳ ý dành cho nhân viên đánh giá ứng dụng.

voiceName

string

Tên giọng nói sẽ được sử dụng. Các giá trị mẫu được hỗ trợ: male_1, male_2, female_1, female_2.

externalVoiceName

string

Tên giọng nói bên ngoài của nhân viên hỗ trợ này. Không chứa thông tin ngôn ngữ.

voiceLocale

string

Ngôn ngữ giọng nói của nhân viên hỗ trợ này. Nếu bạn đặt chính sách này thành một chuỗi trống, thì chuỗi này sẽ được phân giải thành ngôn ngữ của người dùng trong thời gian chạy.

surfaceRequirements

object (SurfaceRequirements)

Một tập hợp các yêu cầu trên giao diện ứng dụng của Trợ lý Google mà phải được đáp ứng để Ứng dụng được kích hoạt.

SurfaceRequirements

Chứa tập hợp các yêu cầu đối với giao diện ứng dụng phải được đáp ứng để Nhân viên hỗ trợ được kích hoạt. Nếu không đáp ứng được bất kỳ yêu cầu nào nêu ở đây, nhân viên hỗ trợ sẽ không được kích hoạt.

Biểu diễn dưới dạng JSON
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Các trường
minimumCapabilities[]

object (Capability)

Tập hợp các khả năng tối thiểu cần thiết để tác nhân hỗ trợ hoạt động. Nếu nền tảng thiếu bất kỳ yếu tố nào trong số này, tác nhân sẽ không được kích hoạt.

Chức năng

Biểu thị yêu cầu về khả năng sử dụng một chức năng nhất định

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

string

Tên của chức năng, ví dụ: actions.capability.AUDIO_OUTPUT

Loại

Loại có thể được tham chiếu trong một Hành động. Đây có thể là các loại tuỳ chỉnh riêng biệt cho hành động hoặc các loại phổ biến do Google xác định và được tham chiếu trong hành động đó.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Các trường
name

string

tên của loại tùy chỉnh, ở định dạng type.

entities[]
(deprecated)

object (Entity)

Danh sách thực thể thuộc loại này. Mỗi cụm từ bao gồm một khoá và danh sách từ đồng nghĩa.

isUserDefined

boolean

Liệu các thực thể có do người dùng xác định hay không (khác nhau đối với mỗi người dùng).

Thực thể

Mỗi Thực thể tương ứng là duy nhất cho loại này. Khoá phải khác biệt và danh sách các từ đồng nghĩa được dùng để kích hoạt.

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

string

Khoá duy nhất cho mục này.

synonyms[]

string

Danh sách các từ đồng nghĩa có thể sử dụng để tham chiếu đến mục này.