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

الاسم المعروض التلقائي لهذا التطبيق (في حال عدم توفّر ترجمة)، مثلاً "Starbucks". يتم استخدام هذه البيانات أيضًا كطريقة تتيح للمستخدمين استدعاء هذا التطبيق (بالإضافة إلى 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

الوصف الطويل التلقائي للتطبيق (في حال عدم توفّر ترجمة). يقتصر على 4,000 حرف.
category

string

فئة التطبيق. يجب أن تكون القيمة إحدى الفئات المسموح بها للتطبيقات. راجِع الإجراءات في Google Console للحصول على قائمة بالفئات المسموح بها.
smallSquareLogoUrl

string

صورة مربّعة صغيرة. يجب أن تكون الأبعاد 192 × 192 بكسل.
largeLandscapeLogoUrl

string

صورة أفقية كبيرة يجب أن تكون الأبعاد 2208 × 1242 بكسل.
companyName

string

اسم الشركة التي يرتبط بها التطبيق.
contactEmail

string

عنوان البريد الإلكتروني لجهة الاتصال للسماح للمستخدمين بالتواصل معهم بخصوص التطبيق.
termsOfServiceUrl

string

تشير هذه السمة إلى عنوان URL المؤدي إلى بنود الخدمة الخاصة بالتطبيق.
privacyUrl

string

عنوان URL لسياسة خصوصية التطبيق.
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" التي يجب استيفاؤها لتشغيل التطبيق.

SurfaceRequirements

تحتوي على مجموعة من المتطلبات لواجهة العميل التي يجب استيفاؤها ليتم تفعيل الوكيل. في حال عدم استيفاء أي متطلب مُدرَج هنا، لن يتم تشغيل الوكيل.

تمثيل JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
الحقول
minimumCapabilities[]

object (Capability)

تمثّل هذه السمة الحد الأدنى لمجموعة الإمكانات اللازمة لعمل الوكيل. وفي حال عدم توفّر أي من الأجزاء السابقة في السطح، لن يتم تشغيل الوكيل.

الإمكانية

يمثّل شرطًا بشأن توفُّر إمكانية معيّنة

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

اسم الإمكانية، مثل actions.capability.AUDIO_OUTPUT

Type

يشير ذلك المصطلح إلى نوع يمكن الإشارة إليه ضِمن إجراء. يمكن أن تكون هذه الأنواع عبارة عن أنواع مخصّصة فريدة للإجراء أو أنواع شائعة تحدّدها Google وتتم الإشارة إليها ضمن الإجراء.

تمثيل JSON 
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
الحقول
name

string

اسم النوع المخصص بتنسيق type.
entities[]
(deprecated)

object (Entity)

قائمة بالكيانات من هذا النوع ويتضمن كل منها مفتاحًا وقائمة من المرادفات.
isUserDefined

boolean

ما إذا كانت الكيانات معرفة من جانب المستخدم (مختلفة لكل مستخدم).

الكيان

كل كيان يتوافق مع هذا النوع من الأغراض الفريدة. يجب أن يكون المفتاح فريدًا وأن يتم استخدام قائمة المرادفات لبدء التشغيل.

تمثيل JSON 
{
  "key": string,
  "synonyms": [
    string
  ]
}
الحقول
key

string

مفتاح فريد لهذا العنصر.
synonyms[]

string

قائمة بالمرادفات التي يمكن استخدامها للإشارة إلى هذا العنصر.