تحتوي ActionPackage على محتوى مسودة التطبيق بالإضافة إلى كل إصدار منشور. ويشمل ذلك تفاصيل قائمة الدليل وإعدادات المحادثة وربط الحساب.
تمثيل JSON | |
---|---|
{ "manifest": { object ( |
الحقول | |
---|---|
manifest |
تفاصيل التطبيق. هذا هو المكان الذي يتم فيه الاحتفاظ بقائمة الدليل بالإضافة إلى تعريف التطبيق الآخر مثل displayName. |
accountLinking |
تفاصيل ربط الحسابات على هذا التطبيق |
actions[] |
قائمة بالإجراءات التي يمكن للتطبيق التعامل معها. |
types[] |
قائمة بالأنواع التي حدّدها المطوّر. |
conversations |
يمكنك ربط المحادثات التي يمكن مشاركتها من خلال " عنصر يحتوي على قائمة من أزواج |
locale |
اللغة لحزمة الإجراءات هذه. ويتم تمثيله بالسلاسل اللغوية لـ BCP-47، مثل en ، وen-US، وfr، وfr-CA، وsr-Latn، وzh-Hans، و zh-Hans-CN"، و"zh-Hant"، و"zh-Hant-HK"، وما إلى ذلك. ويكون هذا مطلوبًا عندما يتيح التطبيق استخدام أكثر من لغة واحدة. لكل لغة معتمدة حزمة ActionPackage الخاصة بها. في حال عدم تقديم قيمة، سيتم تضمين اللغة التلقائية للوكيل. |
البيان
مجموعة البيانات الوصفية للتطبيق. يتم استخدام محتوى هذه الرسالة في سياقات متعددة:
- على صفحة قائمة دليل Google.
- تعريف فريد لتطبيق لاستدعاء صريح (
displayName
). - المحتوى الخاص بأجزاء أخرى من
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 ( |
الحقول | |
---|---|
displayName |
الاسم المعروض التلقائي لهذا التطبيق (في حال عدم توفّر ترجمة)، مثلاً "Starbucks". يتم استخدام هذه البيانات أيضًا كطريقة تتيح للمستخدمين استدعاء هذا التطبيق (بالإضافة إلى |
invocationName |
هذا هو الاسم الفريد لهذا التطبيق لاستحضاره مباشرة ضمن سياق صوتي (منطوق). تتطلب السياسات أن يكون اسم الاستدعاء مشابهًا صوتيًا إلى حد كبير للحقل |
enabledRegions[] |
أرقام تعريف معايير AdWords للمناطق التي يُسمح فيها بالتطبيق استنادًا إلى الموقع الجغرافي الذي يتواجد فيه المستخدم. راجع https://developers.google.com/adwords/api/docs/appendix/geotargeting |
disabledRegions[] |
أرقام تعريف معايير AdWords للمناطق التي تم حظر التطبيق فيها استنادًا إلى الموقع الجغرافي الذي يتواجد فيه المستخدم. راجع https://developers.google.com/adwords/api/docs/appendix/geotargeting |
shortDescription |
هو الوصف الموجز التلقائي للتطبيق (في حال عدم توفّر ترجمة). يقتصر على 80 حرفًا. |
longDescription |
الوصف الطويل التلقائي للتطبيق (في حال عدم توفّر ترجمة). يقتصر على 4,000 حرف. |
category |
فئة التطبيق. يجب أن تكون القيمة إحدى الفئات المسموح بها للتطبيقات. راجِع الإجراءات في Google Console للحصول على قائمة بالفئات المسموح بها. |
smallSquareLogoUrl |
صورة مربّعة صغيرة. يجب أن تكون الأبعاد 192 × 192 بكسل. |
largeLandscapeLogoUrl |
صورة أفقية كبيرة يجب أن تكون الأبعاد 2208 × 1242 بكسل. |
companyName |
اسم الشركة التي يرتبط بها التطبيق. |
contactEmail |
عنوان البريد الإلكتروني لجهة الاتصال للسماح للمستخدمين بالتواصل معهم بخصوص التطبيق. |
termsOfServiceUrl |
تشير هذه السمة إلى عنوان URL المؤدي إلى بنود الخدمة الخاصة بالتطبيق. |
privacyUrl |
عنوان URL لسياسة خصوصية التطبيق. |
sampleInvocation[] |
نموذج عبارة استدعاء معروض كجزء من وصف التطبيق في دليل جميع التطبيقات يمكن تقديم 5 قيم فقط. |
introduction |
ملخّص لما يمكن أن يفعله التطبيق، ويُستخدَم في مقدّمة التطبيق للمستخدمين. يجب أن تكون هذه عبارة فعل تكمل جملة مثل "يمكنك استخدام هذا التطبيق من أجل..." |
testingInstructions |
تعليمات الاختبار المرن لمراجع التطبيق |
voiceName |
اسم الصوت الذي سيتم استخدامه. أمثلة على القيم المسموح بها: |
externalVoiceName |
اسم الصوت الخارجي لهذا الوكيل. لا يحتوي على معلومات اللغة. |
voiceLocale |
لغة صوت هذا الوكيل. وفي حال ضبطها على سلسلة فارغة، سيتم تحديدها بلغة المستخدم في وقت التشغيل. |
surfaceRequirements |
مجموعة من المتطلبات لواجهة برنامج "مساعد Google" التي يجب استيفاؤها لتشغيل التطبيق. |
SurfaceRequirements
تحتوي على مجموعة من المتطلبات لواجهة العميل التي يجب استيفاؤها ليتم تفعيل الوكيل. في حال عدم استيفاء أي متطلب مُدرَج هنا، لن يتم تشغيل الوكيل.
تمثيل JSON | |
---|---|
{
"minimumCapabilities": [
{
object ( |
الحقول | |
---|---|
minimumCapabilities[] |
تمثّل هذه السمة الحد الأدنى لمجموعة الإمكانات اللازمة لعمل الوكيل. وفي حال عدم توفّر أي من الأجزاء السابقة في السطح، لن يتم تشغيل الوكيل. |
الإمكانية
يمثّل شرطًا بشأن توفُّر إمكانية معيّنة
تمثيل JSON | |
---|---|
{ "name": string } |
الحقول | |
---|---|
name |
اسم الإمكانية، مثل actions.capability.AUDIO_OUTPUT |
Type
يشير ذلك المصطلح إلى نوع يمكن الإشارة إليه ضِمن إجراء. يمكن أن تكون هذه الأنواع عبارة عن أنواع مخصّصة فريدة للإجراء أو أنواع شائعة تحدّدها Google وتتم الإشارة إليها ضمن الإجراء.
تمثيل JSON | |
---|---|
{
"name": string,
"entities": [
{
object ( |
الحقول | |
---|---|
name |
اسم النوع المخصص بتنسيق |
entities[] |
قائمة بالكيانات من هذا النوع ويتضمن كل منها مفتاحًا وقائمة من المرادفات. |
isUserDefined |
ما إذا كانت الكيانات معرفة من جانب المستخدم (مختلفة لكل مستخدم). |
الكيان
كل كيان يتوافق مع هذا النوع من الأغراض الفريدة. يجب أن يكون المفتاح فريدًا وأن يتم استخدام قائمة المرادفات لبدء التشغيل.
تمثيل JSON | |
---|---|
{ "key": string, "synonyms": [ string ] } |
الحقول | |
---|---|
key |
مفتاح فريد لهذا العنصر. |
synonyms[] |
قائمة بالمرادفات التي يمكن استخدامها للإشارة إلى هذا العنصر. |