ActionPackage

ActionPackage menyimpan konten untuk draf Aplikasi serta setiap versi yang di-deploy. Hal 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. Ini adalah tempat 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 ke 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-nya sendiri. Jika nilai tidak diberikan, lokalitas default agen akan diterapkan.

Manifes

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

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

Pesan ini bersifat hanya baca. Anda dapat 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". Ini juga digunakan sebagai metode bagi pengguna untuk memanggil Aplikasi ini (selain invocationName). Nama tampilan harus unik dan secara fonetis sangat mirip dengan invocationName.

invocationName

string

Ini adalah nama unik untuk Aplikasi ini guna memanggilnya langsung dalam konteks suara (lisan). Kebijakan mengharuskan nama panggilan secara fonetis sangat mirip dengan kolom displayName.

enabledRegions[]

string (int64 format)

ID kriteria AdWords untuk wilayah tempat Aplikasi diizinkan berdasarkan lokasi kehadiran 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 yang tersedia). Bagian ini dibatasi hingga 80 karakter.

longDescription

string

Deskripsi panjang default untuk Aplikasi (jika tidak ada terjemahan yang tersedia). 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 berukuran 192px kali 192px.

largeLandscapeLogoUrl

string

Gambar lanskap besar. Dimensinya harus 2208px kali 1242px.

companyName

string

Nama perusahaan yang terkait dengan Aplikasi.

contactEmail

string

Alamat email kontak untuk mengizinkan pengguna menghubungi 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 hal 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 ini akan di-resolve ke lokalitas pengguna pada saat runtime.

surfaceRequirements

object (SurfaceRequirements)

Kumpulan 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 dapat 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 permukaan tidak memiliki salah satu dari ini, agen tidak akan dipicu.

Kemampuan

Mewakili persyaratan tentang ketersediaan kemampuan tertentu

Representasi JSON
{
  "name": string
}
Kolom
name

string

Nama kemampuan, misalnya actions.capability.AUDIO_OUTPUT

Jenis

Jenis yang dapat direferensikan dalam Action. 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 entitas adalah buatan pengguna (berbeda untuk setiap pengguna).

Entitas

Setiap Entitas yang sesuai 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.