ActionPackage, dağıtılan her sürümün yanı sıra Uygulama taslağının içeriğini de barındırır. Bu bilgiler arasında dizin girişi ayrıntıları, görüşme yapılandırması ve hesap bağlama bulunur.
| JSON gösterimi | |
|---|---|
{ "manifest": { object ( |
|
| Alanlar | |
|---|---|
manifest |
Uygulamanın ayrıntıları. Dizin girişi ve displayName gibi diğer uygulama tanımlamaları burada 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" gibi BCP-47 dil dizeleriyle temsil edilir. Bir Uygulama birden fazla dili desteklediğinde bu gereklidir. Desteklenen her yerel ayarın kendi ActionPackage'ı vardır. Değer belirtilmezse aracının varsayılan yerel ayarı belirtilir. |
Manifest
Uygulamaya ilişkin meta veri grubu. Bu mesajın içeriği birden fazla bağlamda kullanılıyor:
- işlemleri için Google Dizini'ni ziyaret edin.
- Açık çağrı için bir Uygulamanın benzersiz kimliği (
displayName). ActionPackageöğesinin diğer bölümlerinin içeriği (shortDescriptionAccountLinkingiçinde görüntüleme için,displayNameiseactionsiçinde Uygulama adını kullanıcılara göstermek için kullanılır).
Bu mesaj salt okunurdur. Bu iletideki alanları doğrudan işlem paketinde değil, işlemler konsolu üzerinden 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 Uygulama için varsayılan görünen ad (çeviri yoksa), ör. "Starbucks". Bu, kullanıcıların bu Uygulamayı çağırmaları için bir yöntem olarak da kullanılır ( |
invocationName |
Bu, uygulamanın uygulamayı sesli bir bağlamda doğrudan çağırabileceği 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. https://developers.google.com/adwords/api/docs/appendix/geotargeting adresine bakın |
disabledRegions[] |
Kullanıcının bulunduğu konuma göre Uygulamanın engellendiği bölgelerin AdWords ölçüt kimlikleri. https://developers.google.com/adwords/api/docs/appendix/geotargeting adresine bakın |
shortDescription |
Uygulamanın varsayılan kısa açıklaması (çevirisi yoksa). Bu alan 80 karakterle sınırlıdır. |
longDescription |
Uygulamanın varsayılan uzun açıklaması (çevirisi yoksa). Bu alan 4.000 karakterle sınırlıdır. |
category |
Uygulamanın kategorisi. Değer, Uygulamalar için izin verilen kategorilerden biri olmalıdır. İzin verilen kategorilerin listesi için Google Console'daki işlemlere bakın. |
smallSquareLogoUrl |
Küçük kare resim. Boyutların 192 x 192 piksel olması gerekir. |
largeLandscapeLogoUrl |
Büyük yatay resim. Boyutların 2.208 x 1.242 piksel olması gerekir. |
companyName |
Uygulamanın ilişkili olduğu şirketin adı. |
contactEmail |
Kullanıcıların Uygulamayla ilgili olarak sizinle iletişime geçebileceği iletişim e-posta adresi. |
termsOfServiceUrl |
Uygulamanın Hizmet Şartları'nın URL'si. |
privacyUrl |
Uygulamanın gizlilik politikasının URL'si. |
sampleInvocation[] |
Tüm Uygulamalar dizininde Uygulama açıklamasının bir parçası olarak gösterilen örnek çağrı ifadesi. Yalnızca 5 değer verilebilir. |
introduction |
Bir Uygulamanın yapabileceklerinin özeti. Uygulamayı kullanıcılara tanıtmak için kullanılır. Bu, "Bu uygulamayı şu amaçlarla kullanabilirsiniz:" gibi bir cümleyi tamamlayan fiil ifadesi olmalıdır. |
testingInstructions |
Uygulama incelemecisi için serbest biçimli test talimatları. |
voiceName |
Kullanılacak sesin 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 tetiklenmesi için Google Asistan istemci yüzeyiyle ilgili karşılanması gereken bir dizi gereksinim. |
SurfaceRequirements
Aracının tetiklenmesi için istemci yüzeyiyle ilgili karşılanması gereken bir dizi gereksinim içerir. Burada listelenen koşullardan herhangi biri karşılanmazsa temsilci 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 özelliğin kullanılabilirliğiyle ilgili şartı ifade eder
| JSON gösterimi | |
|---|---|
{ "name": string } |
|
| Alanlar | |
|---|---|
name |
Özelliğin adı, ör. actions.capability.AUDIO_OUTPUT |
Tür
İşlem içinde referans verilebilecek bir tür. Bunlar, işleme özgü ö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. 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 gelen benzersizdir. Anahtar benzersiz olmalıdır ve tetikleme için eş anlamlılar listesi kullanılır.
| JSON gösterimi | |
|---|---|
{ "key": string, "synonyms": [ string ] } |
|
| Alanlar | |
|---|---|
key |
Bu öğe için benzersiz anahtar. |
synonyms[] |
Bu öğeyi ifade etmek için kullanılabilecek eş anlamlıların listesi. |