ActionPackage, bir Uygulama taslağının ve dağıtılan her sürümün içeriğini barındırır. Buna dizin girişi ayrıntıları, ileti dizisi yapılandırması ve hesap bağlama da dahildir.
JSON gösterimi | |
---|---|
{ "manifest": { object ( |
Alanlar | |
---|---|
manifest |
Uygulamanın ayrıntıları. Burada, dizin girişi ve displayName gibi diğer Uygulama kimlikleri saklanır. |
accountLinking |
Bu uygulamada hesap bağlamayla ilgili ayrıntılar. |
actions[] |
Uygulamanın gerçekleştirebileceği işlemlerin listesi. |
types[] |
Geliştirici tarafından tanımlanan türlerin listesi. |
conversations |
|
locale |
Bu işlem paketinin yerel ayarı. Bu, "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK" vb. gibi BCP-47 dil dizeleriyle temsil edilir. Bu, bir Uygulama birden fazla dili destekliyorsa gereklidir. Desteklenen her yerel ayarın kendi ActionPackage'ı vardır. Değer sağlanmazsa aracının varsayılan yerel ayarı ima edilir. |
Manifest
Uygulama için meta veri grubu. Bu mesajın içeriği birden çok bağlamda kullanılıyor:
- işlem (Google dizini giriş sayfasındaki işlemler).
- Açık çağrı (
displayName
) için bir Uygulamanın benzersiz tanımlaması. ActionPackage
öğesinin diğer bölümlerinin içeriği (shortDescription
,AccountLinking
dilinde görüntülemek için kullanılır,displayName
iseactions
dilinde Uygulama adını kullanıcılara göstermek için kullanılır).
Bu ileti salt okunur. Bu iletideki alanları doğrudan işlem paketinde değil, işlem konsolu aracılığıyla belirtirsiniz.
JSON gösterimi | |
---|---|
{
"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 ( |
Alanlar | |
---|---|
displayName |
Bu Uygulamanın varsayılan görünen adı (çevirisi yoksa), ör. "Starbucks". Bu ad, kullanıcıların bu Uygulamayı ( |
invocationName |
Bu, uygulamanın ses (sözlü) bağlamında doğrudan çağıracağı benzersiz addır. Politikalar, çağrı adının fonetik olarak |
enabledRegions[] |
Kullanıcının bulunduğu konuma göre Uygulamaya izin verilen bölgelerin AdWords ölçüt kimlikleri. Bkz. https://developers.google.com/adwords/api/docs/appendix/geotargeting |
disabledRegions[] |
Uygulamanın, kullanıcının bulunduğu konuma göre engellendiği bölgelerin AdWords ölçüt kimlikleri. Bkz. https://developers.google.com/adwords/api/docs/appendix/geotargeting |
shortDescription |
Uygulamanın varsayılan kısa açıklaması (çeviri yoksa). Açıklama 80 karakterle sınırlıdır. |
longDescription |
Uygulamanın varsayılan uzun açıklaması (çevirisi yoksa). Bu, 4.000 karakterle sınırlıdır. |
category |
Uygulama kategorisi. Değer, Uygulamalar için izin verilen kategorilerden biri olmalıdır. İzin verilen kategorilerin listesi için Google konsolundaki işlemlere bakın. |
smallSquareLogoUrl |
Küçük kare resim. Boyutlar 192 x 192 piksel olmalıdır. |
largeLandscapeLogoUrl |
Büyük yatay resim. Boyutların 2208 x 1242 piksel olması gerekir. |
companyName |
Uygulamanın ilişkilendirildiği şirketin adı. |
contactEmail |
Kullanıcıların Uygulamayla ilgili olarak iletişim kurabileceği iletişim e-posta adresi. |
termsOfServiceUrl |
Uygulamanın Hizmet Şartları'nın (Hizmet Şartları) URL'si. |
privacyUrl |
Uygulamanın gizlilik politikasının URL'si. |
sampleInvocation[] |
Tüm uygulamaların dizininde Uygulama açıklamasının bir parçası olarak gösterilen örnek çağrı ifadesi. Yalnızca 5 değer girilebilir. |
introduction |
Uygulamanın neler yapabileceğinin özeti. Kullanıcılara uygulamayı tanıtmak için kullanılır. Bu, "Bu uygulamayı şu amaçlarla kullanabilirsiniz:" gibi bir cümleyi tamamlayan bir fiil ifadesi olmalıdır. |
testingInstructions |
Uygulama inceleme uzmanı için serbest biçimli test talimatları. |
voiceName |
Kullanılacak ses adı. Desteklenen örnek değerler: |
externalVoiceName |
Bu temsilcinin harici ses adı. Yerel ayar bilgilerini içermez. |
voiceLocale |
Bu temsilci için sesin yerel ayarı. Boş bir dizeye ayarlanırsa çalışma zamanında kullanıcının yerel ayarına çözümlenir. |
surfaceRequirements |
Uygulamanın tetiklenebilmesi için Google Asistan istemci yüzeyine yönelik bir dizi gereksinim. |
SurfaceRequirements
Aracının tetiklenmesi için istemci yüzeyine yönelik bir dizi gereksinim içerir. Burada listelenen koşullardan herhangi biri karşılanmazsa aracı tetiklenmez.
JSON gösterimi | |
---|---|
{
"minimumCapabilities": [
{
object ( |
Alanlar | |
---|---|
minimumCapabilities[] |
Aracının çalışması için gereken minimum özellik grubu. Yüzeyde bunlardan herhangi biri eksikse aracı tetiklenmez. |
Kapasite
Belirli bir işlevin kullanılabilirliğiyle ilgili bir gereksinimi temsil eder
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Özelliğin adı (ör. actions.capability.AUDIO_OUTPUT) |
Tür
Bir İşlem içinde referans verilebilen bir tür. Bunlar işleme özel özel türler veya Google tarafından tanımlanan ve işlemde referans verilen yaygın türler olabilir.
JSON gösterimi | |
---|---|
{
"name": string,
"entities": [
{
object ( |
Alanlar | |
---|---|
name |
özel türün |
entities[] |
Bu tür için varlıkların listesi. Bunların her biri bir anahtar ve eş anlamlılar listesi içerir. |
isUserDefined |
Varlıkların kullanıcı tanımlı olup olmadığı (her kullanıcı için farklı). |
Varlık
Her varlık bu türe karşılık gelir. Anahtar benzersiz olmalıdır ve tetikleme için eş anlamlılar listesi kullanılmalıdır.
JSON gösterimi | |
---|---|
{ "key": string, "synonyms": [ string ] } |
Alanlar | |
---|---|
key |
Bu öğe için benzersiz anahtar. |
synonyms[] |
Bu öğeye atıfta bulunmak için kullanılabilecek eş anlamlıların listesi. |