ActionPackage

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 (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Alanlar
manifest

object (Manifest)

Uygulamanın ayrıntıları. Dizin girişi ve displayName gibi diğer uygulama tanımlamaları burada saklanır.

accountLinking

object (AccountLinking)

Bu uygulamada hesap bağlamayla ilgili ayrıntılar.

actions[]

object (Action)

Uygulamanın gerçekleştirebileceği işlemlerin listesi.

types[]

object (Type)

Geliştirici tarafından tanımlanan türlerin listesi.

conversations

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

actions arasında paylaşılabilecek görüşmeleri eşleyin. Örneğin Fulfillment içindeki conversationName konusuna bakın.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

locale

string

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:

  1. işlemleri için Google Dizini'ni ziyaret edin.
  2. Açık çağrı için bir Uygulamanın benzersiz kimliği (displayName).
  3. ActionPackage öğesinin diğer bölümlerinin içeriği (shortDescription AccountLinking içinde görüntüleme için, displayName ise actions iç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 (SurfaceRequirements)
  }
}
Alanlar
displayName

string

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 özelliğine ek olarak). Görünen ad benzersiz ve fonetik olarak invocationName ile çok benzer olmalıdır.

invocationName

string

Bu, uygulamanın uygulamayı sesli bir bağlamda doğrudan çağırabileceği benzersiz addır. Politikalar, çağrı adının fonetik olarak displayName alanına çok benzer olmasını gerektirir.

enabledRegions[]

string (int64 format)

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[]

string (int64 format)

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

string

Uygulamanın varsayılan kısa açıklaması (çevirisi yoksa). Bu alan 80 karakterle sınırlıdır.

longDescription

string

Uygulamanın varsayılan uzun açıklaması (çevirisi yoksa). Bu alan 4.000 karakterle sınırlıdır.

category

string

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

string

Küçük kare resim. Boyutların 192 x 192 piksel olması gerekir.

largeLandscapeLogoUrl

string

Büyük yatay resim. Boyutların 2.208 x 1.242 piksel olması gerekir.

companyName

string

Uygulamanın ilişkili olduğu şirketin adı.

contactEmail

string

Kullanıcıların Uygulamayla ilgili olarak sizinle iletişime geçebileceği iletişim e-posta adresi.

termsOfServiceUrl

string

Uygulamanın Hizmet Şartları'nın URL'si.

privacyUrl

string

Uygulamanın gizlilik politikasının URL'si.

sampleInvocation[]

string

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

string

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

string

Uygulama incelemecisi için serbest biçimli test talimatları.

voiceName

string

Kullanılacak sesin adı. Desteklenen örnek değerler: male_1, male_2, female_1, female_2.

externalVoiceName

string

Bu temsilcinin harici ses adı. Yerel ayar bilgilerini içermez.

voiceLocale

string

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

object (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 (Capability)
    }
  ]
}
Alanlar
minimumCapabilities[]

object (Capability)

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

string

Ö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 (Entity)
    }
  ],
  "isUserDefined": boolean
}
Alanlar
name

string

özel türün type biçiminde adı.

entities[]
(deprecated)

object (Entity)

Bu tür için varlıkların listesi. Her biri bir anahtar ve eş anlamlılar listesi içerir.

isUserDefined

boolean

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

string

Bu öğe için benzersiz anahtar.

synonyms[]

string

Bu öğeyi ifade etmek için kullanılabilecek eş anlamlıların listesi.