ActionPackage

ActionPackage محتوای پیش نویس یک برنامه و همچنین هر نسخه مستقر شده را نگه می دارد. این شامل جزئیات فهرست فهرست، پیکربندی مکالمه و پیوند حساب است.

نمایندگی JSON
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
زمینه های
manifest

object ( Manifest )

جزئیات برنامه این جایی است که فهرست فهرست دایرکتوری و همچنین سایر شناسه های برنامه مانند displayName نگهداری می شود.

accountLinking

object ( AccountLinking )

جزئیات مربوط به پیوند دادن حساب در این برنامه.

actions[]

object ( Action )

فهرست اقداماتی که برنامه قادر به انجام آن است.

types[]

object ( Type )

لیست انواع تعریف شده توسط توسعه دهنده.

conversations

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

مکالمات نقشه ای که می توانند در بین actions به اشتراک گذاشته شوند. به عنوان مثال به conversationName در Fulfillment مراجعه کنید.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

locale

string

محلی برای این بسته اقدام. این با رشته های زبان BCP-47، مانند "en"، "en-US"، "fr"، "fr-CA"، "sr-Latn"، "zh-Hans"، "zh-Hans-CN" نشان داده می شود. "، "zh-Hant"، "zh-Hant-HK"، و غیره. این مورد زمانی لازم است که یک برنامه از بیش از یک زبان پشتیبانی کند. هر زبان پشتیبانی شده دارای ActionPackage مخصوص به خود است. اگر مقدار ارائه نشده باشد، محلی پیش فرض عامل در نظر گرفته می شود.

آشکار

مجموعه ای از ابرداده برای برنامه. محتوای این پیام در چندین زمینه استفاده می شود:

  1. اقدامات در صفحه فهرست فهرست دایرکتوری Google.
  2. شناسایی منحصر به فرد یک برنامه برای فراخوانی صریح ( displayName ).
  3. محتوای سایر بخش‌های ActionPackage ( shortDescription برای نمایش در AccountLinking استفاده می‌شود، displayName در actions برای نشان دادن نام برنامه به کاربران استفاده می‌شود).

این پیام فقط خواندنی است. شما فیلدها را در این پیام از طریق کنسول اکشن و نه مستقیماً در بسته اکشن مشخص می کنید.

نمایندگی 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)
  }
}
زمینه های
displayName

string

نام نمایش پیش‌فرض این برنامه (اگر ترجمه‌ای در دسترس نباشد)، به عنوان مثال «استارباکس». این همچنین به عنوان روشی برای کاربران برای فراخوانی این برنامه (علاوه بر invocationName ) استفاده می شود. نام نمایشی باید منحصر به فرد و از نظر آوایی بسیار شبیه به invocationName باشد.

invocationName

string

این نام منحصر به فرد برای این برنامه است که به طور مستقیم آن را در یک زمینه صوتی (گفتاری) فراخوانی می کند. خط مشی ها ایجاب می کنند که نام فراخوان از نظر آوایی بسیار شبیه به قسمت displayName باشد.

enabledRegions[]

string ( int64 format)

شناسه‌های معیار Adwords برای مناطقی که برنامه بر اساس مکان حضور کاربر مجاز است. به https://developers.google.com/adwords/api/docs/appendix/geotargeting مراجعه کنید

disabledRegions[]

string ( int64 format)

شناسه‌های معیار Adwords برای مناطقی که برنامه بر اساس مکان حضور کاربر مسدود شده است. به https://developers.google.com/adwords/api/docs/appendix/geotargeting مراجعه کنید

shortDescription

string

شرح کوتاه پیش‌فرض برای برنامه (اگر ترجمه‌ای در دسترس نباشد). این به 80 کاراکتر محدود شده است.

longDescription

string

شرح طولانی پیش‌فرض برای برنامه (اگر ترجمه‌ای در دسترس نباشد). این به 4000 کاراکتر محدود شده است.

category

string

دسته برای برنامه. مقدار باید یکی از دسته‌های مجاز برای برنامه‌ها باشد. برای مشاهده لیست دسته بندی های مجاز، اقدامات موجود در کنسول Google را مشاهده کنید.

smallSquareLogoUrl

string

تصویر مربع کوچک. ابعاد باید 192 پیکسل در 192 پیکسل باشد.

largeLandscapeLogoUrl

string

تصویر منظره بزرگ ابعاد باید 2208 پیکسل در 1242 پیکسل باشد.

companyName

string

نام شرکتی که برنامه با آن مرتبط است.

contactEmail

string

آدرس ایمیل تماس برای اینکه کاربران بتوانند در مورد برنامه ارتباط برقرار کنند.

termsOfServiceUrl

string

URL به ToS (شرایط خدمات) برای برنامه.

privacyUrl

string

نشانی اینترنتی خط‌مشی رازداری برنامه.

sampleInvocation[]

string

نمونه عبارت فراخوانی به عنوان بخشی از توضیحات برنامه در فهرست همه برنامه ها نمایش داده می شود. فقط 5 مقدار می تواند داده شود.

introduction

string

خلاصه کارهایی که یک برنامه می تواند انجام دهد. برای معرفی برنامه به کاربران استفاده می شود. این باید یک عبارت فعل باشد که جمله ای مانند "شما می توانید از این برنامه برای... استفاده کنید" را کامل می کند.

testingInstructions

string

دستورالعمل‌های آزمایش فرم رایگان برای بازبین برنامه.

voiceName

string

نام صوتی مورد استفاده مقادیر نمونه پشتیبانی شده: male_1 ، male_2 ، female_1 ، female_2 .

externalVoiceName

string

نام صدای خارجی این نماینده. حاوی اطلاعات محلی نیست.

voiceLocale

string

محل صدا برای این نماینده. اگر روی یک رشته خالی تنظیم شود، در زمان اجرا به محلی کاربر حل می شود.

surfaceRequirements

object ( SurfaceRequirements )

مجموعه ای از الزامات برای سطح سرویس گیرنده Google Assistant که برای راه اندازی برنامه باید رعایت شود.

سطح مورد نیاز

شامل مجموعه ای از الزامات برای سطح مشتری است که برای فعال شدن عامل باید برآورده شود. اگر هر یک از الزامات ذکر شده در اینجا برآورده نشود، عامل فعال نخواهد شد.

نمایندگی JSON
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
زمینه های
minimumCapabilities[]

object ( Capability )

حداقل مجموعه ای از قابلیت های مورد نیاز برای عملکرد عامل. اگر سطح یکی از این موارد را نداشته باشد، عامل فعال نمی شود.

قابلیت

نشان دهنده یک نیاز در مورد در دسترس بودن یک قابلیت معین است

نمایندگی JSON
{
  "name": string
}
زمینه های
name

string

نام قابلیت، به عنوان مثال actions.capability.AUDIO_OUTPUT

تایپ کنید

نوعی که می تواند در یک Action ارجاع داده شود. اینها می‌توانند انواع سفارشی منحصر به فرد اقدام یا انواع معمولی باشند که توسط Google تعریف شده و در عمل به آنها ارجاع داده شده است.

نمایندگی JSON
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
زمینه های
name

string

نام نوع سفارشی، در قالب type .

entities[]
(deprecated)

object ( Entity )

لیست موجودیت های این نوع هر کدام شامل کلید و فهرستی از مترادف ها هستند.

isUserDefined

boolean

اینکه آیا نهادها توسط کاربر تعریف شده اند (برای هر کاربر متفاوت است).

وجود، موجودیت

هر Entity مربوط به این نوع منحصر به فرد است. کلید باید منحصر به فرد باشد و از لیست مترادف ها برای راه اندازی استفاده شود.

نمایندگی JSON
{
  "key": string,
  "synonyms": [
    string
  ]
}
زمینه های
key

string

کلید منحصر به فرد برای این مورد.

synonyms[]

string

فهرست مترادف هایی که می توان برای اشاره به این مورد استفاده کرد.