ActionPackage

ActionPackage giữ nội dung cho bản nháp của Ứng dụng cũng như từng phiên bản đã triển khai. Trong đó có thông tin chi tiết về trang thông tin trong thư mục, cấu hình cuộc trò chuyện và việc 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
}
Trường
manifest

object (Manifest)

Thông tin chi tiết về Ứ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 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 những 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))

Các cuộc trò chuyện trên bản đồ có thể được chia sẻ 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. Thuộc tính 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ợ 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 hỗ trợ sẽ được ngụ ý.

Tệp kê khai

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

  1. trên trang thông tin của Google Directory.
  2. Thông tin nhận dạng duy nhất của một Ứng dụng cho lệnh 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 thị trong AccountLinking, displayName được dùng trong actions để hiện Tên ứng dụng cho người dùng).

Thông báo này đang ở chế độ chỉ có thể đọc. Bạn chỉ định các trường trong thông báo này qua bảng điều khiển Actions (bảng điều khiển Actions) chứ không chỉ định 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)
  }
}
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ụ: "PLACEHOLDER". Phương thức này cũng được dùng làm phương thức để người dùng gọi Ứng dụng này (ngoài invocationName). Tên hiển thị phải là duy nhất và về mặt ngữ âm rất giống với invocationName.
invocationName

string

Đây là tên duy nhất cho Ứng dụng này để gọi ra nó trực tiếp trong ngữ cảnh giọng nói (bằng giọng nói). Các chính sách yêu cầu tên lệnh gọi phải rất giống về mặt ngữ âm với trường displayName.
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 xem https://developers.google.com/adwords/api/docs/appendix/geotargeting
disabledRegions[]

string (int64 format)

Mã tiêu chí AdWords cho những khu vực chặn Ứng dụng dựa trên vị trí hiện diện của người dùng. Hãy xem 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). Mã này chỉ được 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). Giới hạn trong 4.000 ký tự.
category

string

Danh mục dành cho Ứng dụng. Giá trị phải là một trong các danh mục được phép đối với Ứng dụng. Xem các thao tác trên bảng điều khiển của Google để 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 phải 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ệ để cho phép người dùng liên hệ về Ứng dụng.
termsOfServiceUrl

string

URL dẫn tới Điều khoản dịch vụ (Điều khoản dịch vụ) của Ứng dụng.
privacyUrl

string

URL của chính sách quyền riêng tư của Ứng dụng.
sampleInvocation[]

string

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

string

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

string

Hướng dẫn kiểm thử 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 về 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 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 nhóm các yêu cầu đối với giao diện ứng dụng của Trợ lý Google mà người dùng phải đáp ứng thì mới có thể kích hoạt Ứng dụng.

SurfaceRequirements

Chứa một bộ yêu cầu đối với giao diện ứng dụng mà bạn phải đáp ứng thì Nhân viên hỗ trợ mới được kích hoạt. Nếu không đáp ứng 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)
    }
  ]
}
Trường
minimumCapabilities[]

object (Capability)

Bộ chức năng tối thiểu cần thiết để nhân viên hỗ trợ hoạt động. Nếu nền tảng thiếu bất kỳ thông tin nào trong số này, thì nhân viên hỗ trợ sẽ không được kích hoạt.

Chức năng

Trình bày yêu cầu về khả năng sử dụng của một chức năng cụ thể

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

string

Tên 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 kiểu tuỳ chỉnh dành riêng cho hành động hoặc các kiểu 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
}
Trường
name

string

tên của loại tuỳ chỉnh, ở định dạng type.
entities[]
(deprecated)

object (Entity)

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

boolean

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

Thực thể

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

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "synonyms": [
    string
  ]
}
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ể dùng để tham chiếu đến mục này.