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 ( |
Các trường | |
---|---|
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 |
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[] |
Danh sách thao tác mà Ứng dụng có thể xử lý. |
types[] |
Danh sách các loại do nhà phát triển xác định. |
conversations |
Bạn có thể chia sẻ các cuộc trò chuyện trên bản đồ trên Một đối tượng chứa danh sách các cặp |
locale |
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:
- các hành động trên trang danh sách thư mục của Google.
- Giá trị nhận dạng duy nhất của một Ứng dụng để gọi rõ ràng (
displayName
). - Nội dung của các phần khác của
ActionPackage
(shortDescription
dùng để hiện trongAccountLinking
,displayName
dùng trongactions
để 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 ( |
Các trường | |
---|---|
displayName |
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 |
Đâ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 |
enabledRegions[] |
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[] |
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 |
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 |
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 |
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 |
Hình ảnh vuông nhỏ. Kích thước phải là 192 px x 192 px. |
largeLandscapeLogoUrl |
Hình ảnh ngang lớn. Kích thước tối đa là 2208 px x 1242 px. |
companyName |
Tên của công ty liên kết với Ứng dụng. |
contactEmail |
Địa chỉ email liên hệ để người dùng có thể liên hệ với bạn về Ứng dụng. |
termsOfServiceUrl |
URL dẫn đến Điều khoản dịch vụ (Điều khoản dịch vụ) của ứng dụng. |
privacyUrl |
URL cho chính sách quyền riêng tư của ứng dụng. |
sampleInvocation[] |
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 |
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 |
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 |
Tên giọng nói sẽ được sử dụng. Các giá trị mẫu được hỗ trợ: |
externalVoiceName |
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 |
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 |
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 ( |
Các trường | |
---|---|
minimumCapabilities[] |
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 |
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 ( |
Các trường | |
---|---|
name |
tên của loại tùy chỉnh, ở định dạng |
entities[] |
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 |
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 |
Khoá duy nhất cho mục này. |
synonyms[] |
Danh sách các từ đồng nghĩa có thể sử dụng để tham chiếu đến mục này. |