ActionPackage

ActionPackage menyimpan konten untuk draf Aplikasi serta setiap versi yang di-deploy. Informasi ini mencakup detail listingan direktori, konfigurasi percakapan, dan penautan akun.

Representasi JSON
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Kolom
manifest

object (Manifest)

Detail Aplikasi. Di sinilah listingan direktori disimpan, serta identifikasi Aplikasi lainnya seperti displayName.

accountLinking

object (AccountLinking)

Detail untuk penautan akun di Aplikasi ini.

actions[]

object (Action)

Daftar tindakan yang dapat ditangani Aplikasi.

types[]

object (Type)

Daftar jenis yang ditentukan oleh developer.

conversations

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

Petakan percakapan yang dapat dibagikan di seluruh actions. Misalnya, lihat conversationName di Fulfillment.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

locale

string

Lokalitas untuk paket tindakan ini. Ini diwakili oleh string bahasa BCP-47, seperti "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK", dll. Ini diperlukan jika Aplikasi mendukung lebih dari satu bahasa. Setiap lokalitas yang didukung memiliki ActionPackage sendiri. Jika tidak ada nilai yang diberikan, lokalitas default agen akan tersirat.

Manifes

Kumpulan metadata untuk Aplikasi. Konten pesan ini digunakan dalam berbagai konteks:

  1. tindakan di halaman listingan direktori Google.
  2. Identifikasi unik Aplikasi untuk panggilan eksplisit (displayName).
  3. Konten untuk bagian lain ActionPackage (shortDescription digunakan untuk tampilan di AccountLinking, displayName digunakan di actions untuk menampilkan nama Aplikasi kepada pengguna).

Pesan ini bersifat hanya baca. Anda menentukan kolom dalam pesan ini melalui konsol tindakan dan tidak secara langsung di paket tindakan.

Representasi 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)
  }
}
Kolom
displayName

string

Nama tampilan default untuk Aplikasi ini (jika tidak ada terjemahan yang tersedia), mis. "Starbucks". Hal ini juga digunakan sebagai metode bagi pengguna untuk memanggil Aplikasi ini (selain invocationName). Nama tampilan harus unik dan secara fonetik sangat mirip dengan invocationName.

invocationName

string

Ini adalah nama unik untuk Aplikasi ini untuk memanggilnya secara langsung dalam konteks suara (lisan). Kebijakan mewajibkan bahwa nama pemanggilan secara fonetik sangat mirip dengan kolom displayName.

enabledRegions[]

string (int64 format)

ID kriteria AdWords untuk wilayah tempat Aplikasi diizinkan berdasarkan lokasi keberadaan pengguna. Lihat https://developers.google.com/adwords/api/docs/appendix/geotargeting

disabledRegions[]

string (int64 format)

ID kriteria AdWords untuk wilayah tempat Aplikasi diblokir berdasarkan lokasi kehadiran pengguna. Lihat https://developers.google.com/adwords/api/docs/appendix/geotargeting

shortDescription

string

Deskripsi singkat default untuk Aplikasi (jika tidak ada terjemahan). Deskripsi ini dibatasi hingga 80 karakter.

longDescription

string

Deskripsi panjang default untuk Aplikasi (jika tidak ada terjemahan yang tersedia). Deskripsi ini dibatasi hingga 4.000 karakter.

category

string

Kategori untuk Aplikasi. Nilai harus berupa salah satu kategori yang diizinkan untuk Aplikasi. Lihat tindakan di konsol Google untuk mengetahui daftar kategori yang diizinkan.

smallSquareLogoUrl

string

Gambar persegi kecil. Dimensi harus 192px kali 192px.

largeLandscapeLogoUrl

string

Gambar lanskap besar. Dimensi harus 2.208 x 1.242 piksel.

companyName

string

Nama perusahaan yang terkait dengan Aplikasi.

contactEmail

string

Alamat email kontak yang memungkinkan pengguna menghubungi Anda terkait Aplikasi.

termsOfServiceUrl

string

URL ke ToS (Persyaratan Layanan) untuk Aplikasi.

privacyUrl

string

URL untuk kebijakan privasi Aplikasi.

sampleInvocation[]

string

Contoh frasa panggilan yang ditampilkan sebagai bagian dari deskripsi Aplikasi di direktori semua Aplikasi. Hanya 5 nilai yang dapat diberikan.

introduction

string

Ringkasan tentang apa saja yang dapat dilakukan Aplikasi. Digunakan untuk pengenalan aplikasi kepada pengguna. Ini harus berupa frasa kata kerja yang melengkapi kalimat seperti "Anda dapat menggunakan Aplikasi ini untuk..."

testingInstructions

string

Petunjuk pengujian bentuk bebas untuk Peninjau aplikasi.

voiceName

string

Nama suara yang akan digunakan. Contoh nilai yang didukung: male_1, male_2, female_1, female_2.

externalVoiceName

string

Nama suara eksternal untuk agen ini. Tidak berisi informasi lokal.

voiceLocale

string

Lokalitas suara untuk agen ini. Jika ditetapkan ke string kosong, string tersebut akan di-resolve ke lokalitas pengguna saat runtime.

surfaceRequirements

object (SurfaceRequirements)

Serangkaian persyaratan untuk platform klien Asisten Google yang harus dipenuhi agar Aplikasi dapat dipicu.

SurfaceRequirements

Berisi kumpulan persyaratan untuk platform klien yang harus dipenuhi agar Agen dipicu. Jika persyaratan yang tercantum di sini tidak terpenuhi, agen tidak akan dipicu.

Representasi JSON
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Kolom
minimumCapabilities[]

object (Capability)

Kumpulan kemampuan minimum yang diperlukan agar agen dapat berfungsi. Jika platform tidak memiliki salah satunya, agen tidak akan dipicu.

Kemampuan

Menampilkan persyaratan tentang ketersediaan kemampuan tertentu

Representasi JSON
{
  "name": string
}
Kolom
name

string

Nama kemampuan, mis. actions.capability.AUDIO_OUTPUT

Jenis

Jenis yang dapat direferensikan dalam Action. Hal ini dapat berupa jenis kustom yang unik untuk tindakan atau jenis umum yang ditentukan oleh Google dan dirujuk dalam tindakan.

Representasi JSON
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Kolom
name

string

nama jenis kustom, dalam format type.

entities[]
(deprecated)

object (Entity)

Daftar entitas untuk jenis ini. Masing-masing menyertakan kunci dan daftar sinonim.

isUserDefined

boolean

Apakah entity-nya merupakan buatan pengguna (berbeda untuk setiap pengguna).

Entitas

Setiap Entity bersifat unik untuk jenis ini. Kunci harus unik dan daftar sinonim digunakan untuk memicu.

Representasi JSON
{
  "key": string,
  "synonyms": [
    string
  ]
}
Kolom
key

string

Kunci unik untuk item ini.

synonyms[]

string

Daftar sinonim yang dapat digunakan untuk merujuk ke item ini.