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

النوع

يشير ذلك المصطلح إلى نوع يمكن الإشارة إليه ضمن إجراء. يمكن أن تكون هذه أنواعًا مخصّصة فريدة من نوعها أو أنواعًا شائعة تحدّدها 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

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