ActionPackage

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 (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ı. Burada, dizin girişi ve displayName gibi diğer Uygulama kimlikleri 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 ürününde paylaşılabilecek görüşmeler harita üzerinde. Örneğin, Fulfillment içindeki conversationName öğesine 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" 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:

  1. işlem (Google dizini giriş sayfasındaki işlemler).
  2. Açık çağrı (displayName) için bir Uygulamanın benzersiz tanımlaması.
  3. ActionPackage öğesinin diğer bölümlerinin içeriği (shortDescription, AccountLinking dilinde görüntülemek için kullanılır, displayName ise actions 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 (SurfaceRequirements)
  }
}
Alanlar
displayName

string

Bu Uygulamanın varsayılan görünen adı (çevirisi yoksa), ör. "Starbucks". Bu ad, kullanıcıların bu Uygulamayı (invocationName ile birlikte) çağırma yöntemi olarak da kullanılır. Görünen ad benzersiz ve fonetik olarak invocationName ile çok benzer olmalıdır.

invocationName

string

Bu, uygulamanın ses (sözlü) bağlamında doğrudan çağıracağı 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. Bkz. https://developers.google.com/adwords/api/docs/appendix/geotargeting

disabledRegions[]

string (int64 format)

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

string

Uygulamanın varsayılan kısa açıklaması (çeviri yoksa). Açıklama 80 karakterle sınırlıdır.

longDescription

string

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

category

string

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

string

Küçük kare resim. Boyutlar 192 x 192 piksel olmalıdır.

largeLandscapeLogoUrl

string

Büyük yatay resim. Boyutların 2208 x 1242 piksel olması gerekir.

companyName

string

Uygulamanın ilişkilendirildiği şirketin adı.

contactEmail

string

Kullanıcıların Uygulamayla ilgili olarak iletişim kurabileceği iletişim e-posta adresi.

termsOfServiceUrl

string

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

privacyUrl

string

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

sampleInvocation[]

string

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

string

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

string

Uygulama inceleme uzmanı için serbest biçimli test talimatları.

voiceName

string

Kullanılacak ses 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 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 (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 işlevin kullanılabilirliğiyle ilgili bir gereksinimi temsil eder

JSON gösterimi
{
  "name": string
}
Alanlar
name

string

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

string

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

entities[]
(deprecated)

object (Entity)

Bu tür için varlıkların listesi. Bunların 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 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

string

Bu öğe için benzersiz anahtar.

synonyms[]

string

Bu öğeye atıfta bulunmak için kullanılabilecek eş anlamlıların listesi.