قبل إصدار "الإجراء" للمستخدمين، يجب اختباره بدقة وتحديد مساحات العرض والمواقع الجغرافية والأجهزة المستهدفة، والتأكّد من توافقه مع سياسات Google for Actions. تقدّم هذه الصفحة نظرة عامة على المهام التي يجب تنفيذها أثناء الاستعداد لإرسال الإجراء المطلوب اتّخاذه، للحصول على موافقة من أجل إصدار هذه الميزات للقنوات التجريبية أو قنوات الإنتاج.
التحقّق من انتهاك السياسات
تأكَّد من أنّ إجراءك يتّبع سياسات "المهام مع مساعد Google". بشكل عام، اتّبِع الإرشادات التالية المتعلقة بالمحتوى الخاص بك:
- كُن دقيقًا: يجب أن يتمكّن المستخدمون من استدعاء الإجراء الخاص بك على وجه التحديد. لا تستخدم عامةً أو عامة جدًا عند اختيار اسم العرض أو لفظه. على سبيل المثال، استخدم "Talk to WeatherApp" للتحقق من حالة الطقس لـ [city]" بدلاً من "Check theWeather for [city]" كعبارة Action. اتّبِع إرشادات توفير عبارات إجراء جيدة.
- تجنُّب المحتوى المحظور: ما لم يخدم غرضًا علميًا أو فنيًا أو وثائقيًا أو تعليميًا، إنّ الإجراءات التي تتضمّن محتوًى جنسيًا أو عنيفًا أو غير قانوني أو يحضّ على الكراهية أمرًا مخالفًا لسياسات "المهام مع مساعد Google". وسيتم أيضًا رفض أو إزالة الإجراءات التي تروّج للتنمّر أو التحرش.
- احترام حقوق الطبع والنشر والملكية الفكرية: تأكّد من أنك تملك الحقوق الكافية لاستخدام المحتوى المقدّم من الإجراء الذي تتّخذه.
- كن صادقًا:لا تضلل المستخدمين أو تخدعهم من خلال الادعاءات الزائفة.
- حماية خصوصية المستخدمين وأمانهم: يجب التعامل بشفافية في كيفية التعامل مع بيانات المستخدمين ونقل بيانات المستخدمين بأمان وتوفير سياسة خصوصية.
- عدم الاستماع إلى المستخدمين بدون إذن: على المستخدمين معرفة الوقت الذي ينتظر فيه الإجراء الذي ستدخلهم إليه. ويُعدّ ترك الميكروفون مفتوحًا بدون طلب إذن المستخدم من الأخطاء الشائعة الموضّحة في سياساتنا. تأكّد من أن "الإجراء" يؤدي إلى إبلاغ المستخدم عند انتظار أمر للحد من خطر رفض الإجراء.
- مراجعة أسماء الاستدعاء وأسماء العرض: تأكد من أن اسم الاستدعاء متوافق مع الاسم المعروض الذي يظهر على صفحة دليل "مساعد Google". تأكّد من أنّ كلا الاسمَين محدّدين بما يكفي لاستدعاء الإجراء بسهولة. يجب أن تتبع أسماء الاستدعاء وأسماء العرض سياسات المهام على Google.
راجِع القائمة الكاملة للسياسات وتأكَّد من الالتزام بها لتسريع عملية مراجعة الإجراء والموافقة عليه.
ضبط الاسم المعروض
يحدِّد الاسم المعروض كيفية استدعاء المستخدمين صراحةً لإجراءك. ويُستخدم هذا الاسم أيضًا في دليل "مساعد Google".
لإعداد الاسم المعروض، اتّبِع الخطوات التالية:
- انتقل إلى التطوير > الاستدعاء > الإعدادات.
- أدخِل الاسم المعروض للإجراء.
- انقر على رمز التشغيل play_circle_filled للتعرّف على طريقة لفظ الاسم.
تغيير الاسم المعروض
يمكنك في أي وقت تغيير الاسم المعروض للإجراء. ومع ذلك، ستخضع الإجراء لعملية مراجعة أخرى كاملة قبل أن يتمكّن المستخدمون من استدعاء الإجراء باستخدام الاسم الجديد.
اختياري: تحديد الموقع الجغرافي المستهدف
وبشكلٍ تلقائي، يتوفر الإجراء في جميع المناطق طالما أنّه تم ضبط لغة جهاز المستخدم على صيغة "الإنجليزية" (على سبيل المثال، الإنجليزية الأمريكية أو الإنجليزية البريطانية).
يتحكّم إعداد الاستهداف حسب الموقع الجغرافي في مدى توفّر الإجراءات على مستوى منطقة معيّنة.
اطّلِع على مزيد من المعلومات عن النشر المترجَم.
اختياري: تحديد إمكانات العرض
يمكن أن يظهر الإجراء في مجموعة متنوعة من مساحات العرض المتوافقة مع "مساعد Google"، مثل الهواتف (Android وiOS) والشاشات الذكية.
تتيح لك إمكانات العرض إمكانية التحكّم في ما إذا كان بإمكان المستخدمين استدعاء الإجراء أم لا استنادًا إلى المساحة التي يستخدمونها. إذا حاول المستخدمون استدعاء الإجراء على سطح غير متوافق، سيتلقّون رسالة خطأ تفيد بأن أجهزتهم غير متوافقة.
يمكنك قراءة المزيد من المعلومات حول إمكانات العرض.
اختياري: تحديد خيارات "لوحة الرسم التفاعلية"
إذا كان الإجراء الذي أجريته يستخدم لوحة الرسم التفاعلية، عليك تفعيل وضبط بعض الخيارات ضمن التطوير > اللوحة التفاعلية في شريط التنقّل الأيمن.
- يمكنك تفعيل خيار استخدام "لوحة الرسم التفاعلية" مع الإجراء.
- أدخِل عنوان URL لتطبيق الويب الذي يستضيف العناصر المرئية للإجراء.
الاختبار باستخدام المحاكي
قبل إصدار مهمتك، استخدِم المحاكي لاختبار تجربة المستخدم للمهمة والتأكّد من أن كل شيء يعمل.
تحقَّق من الأخطاء والانتهاكات الشائعة التالية:
- يجب أن يكون نقل الرد التلقائي على الويب آمنًا: تحقّق من أنك تستخدم تشفير HTTPS (بروتوكول أمان طبقة النقل) عند نقل الردود التلقائية على الويب.
- التحقّق من طلبات الردّ التلقائي على الويب: تأكَّد من التوقيع على طلبات الردّ التلقائي على الويب باستخدام حزمة تطوير البرامج (SDK) للإجراءات والتحقّق منها في الرد التلقائي على الويب.
- اختبار اسم الإجراء: تأكد من أن اسم الإجراء الذي حددته يؤدي إلى تشغيل الإجراء باستمرار. استخدِم جهازًا أو محاكي الويب وقُل اسم الاستدعاء بشكل متكرر، في سيناريوهات حقيقية على أرض الواقع (أي تشويش في الخلفية أو على مسافات مختلفة عن الجهاز). إذا أمكن، اطلب من أشخاص من أجناس مختلفة أو بلهجات مختلفة استدعاء الإجراء الخاص بك. إذا لم يتم التعرف على اسم الاستدعاء بشكل متسق، فيمكنك تغييره.
- الاختبار على الأجهزة الفعلية: على الرغم من أن محاكي الويب مناسب لاختبار الإجراء بسرعة أثناء التطوير، يجب دائمًا اختبار الاستدعاء ومربعات الحوار على الأجهزة الفعلية. هذه هي أفضل طريقة لفهم آلية عمل الإجراء في الحياة اليومية وتساعدك على تحسين تجربة المستخدم.
لاختبار مسودة مشروع "المهام" الحالي، انتقِل إلى قسم الاختبار في شريط التنقّل الرئيسي. هذا يضمن استخدام الإصدار الحالي من الإجراء على مستوى المحاكي ووحدة التحكم والأجهزة المزوّدة بخدمة "مساعد Google".
اطّلِع على مزيد من المعلومات عن محاكي الإجراءات.
إصدار مشروعك
بعد اختبار مسودة المشروع ورضاك بالنتائج، يمكنك نشرها على قناة الإصدار الأولي أو القناة التجريبية لإجراء اختبار إضافي. وبدلاً من ذلك، يمكنك إرساله للمراجعة وإصداره لمستخدمي "مساعد Google".
في قسم النشر > الإصدار من وحدة التحكم، ستجد الخيارات التالية للإصدارات:
- الإصدار الأولي: يُستخدم بشكل أفضل للنسخ السريعة من الاختبار. يتم توزيع الإجراء على مجموعة صغيرة من المستخدمين الذين يتم تحديدهم بدون الخضوع للمراجعة الكاملة من Google.
- الإصدار التجريبي: يُستخدم هذا الخيار على أفضل نحو لتوزيع الإجراء على مجموعة محدودة من المستخدمين بعد مراجعة Google كاملة. وبما أنّ الإجراء قد خضع للمراجعة الكاملة، يمكنك اختيار جعله علنيًا في أي وقت.
- الإنتاج: تُرسِل مهمتك إلى المراجعة الكاملة في Google. بعد الموافقة عليه، سيصبح الإجراء متاحًا لمستخدمي "مساعد Google".
يمكنك الاطّلاع على المزيد من المعلومات حول الإصدارات.
حالة النشر
يوضّح الجدول التالي حالات النشر المختلفة للمشروع والخطوات الإضافية التي قد تحتاج إلى اتّخاذها:
| حالة النشر | الوصف |
|---|---|
| قيد المراجعة |
عند إرسال عملية نشر جديدة، تخضع لعملية الموافقة. يدقّق المراجعون في الإجراء الخاص بك وتتأكّد من عدم انتهاك أي سياسات. وستصلك رسالة إلكترونية بعد اكتمال عملية المراجعة لإعلامك بما إذا تمّت الموافقة على عملية النشر أم لا. |
| مرفوض | تعني حالة "مرفوض" أنه لم تتم الموافقة على عملية النشر. ومن المفترض أن تتلقى رسالة إلكترونية توضّح سبب رفض عملية النشر. يمكنك أيضًا النقر على لماذا؟ بجانب الحالة مرفوض في وحدة التحكّم للاطّلاع على أسباب الرفض. |
| تم نشرها | إجراء معتمد تمت الموافقة عليه ويتم عرضه للمستخدمين. يمكنك "إزالة" نسخة تم نشرها في أي وقت من وحدة التحكّم. |
| موافق عليه | إجراء تم اجتياز المراجعة ولا يتم عرضه حاليًا للمستخدمين. عندما تتم مراجعة أحد الإجراءات بنجاح، يمكن إصداره في أي وقت من وحدة التحكّم، بدون إجراء مراجعة إضافية. |
| غير صحي | تُرسل Google طلبات منتظمة إلى نقطة النهاية الخاصة بالإجراء وتتحقّق من تلقّي رد مناسب. إذا اكتشفنا أنّ نقطة النهاية معطّلة أو لا تستجيب، سنوقف مؤقتًا عرض الإجراء الخاص بك على المستخدمين. في هذه الحالة، ستصلك رسالة إلكترونية لإعلامك بأن نقطة النهاية غير سليمة وتم نقل الإجراء إلى حالة غير سليم. عندما نكتشف أنّ نقطة النهاية متجاوبة مجددًا، سنستأنف عرض الإجراء على المستخدمين. ستصلك رسالة إلكترونية عندما يحدث ذلك، ومن المفترض أن تعود حالة النشر إلى تم النشر. |
| تمّت إزالته | قد تزيل Google الإجراء الذي تقدّمه إذا اكتشفنا انتهاكًا للسياسة بعد نشره. ستصلك رسالة إلكترونية في حال حدوث ذلك، وسيظهر أيضًا إعلان بانر في Play Console لإعلامك بأنّه تمت إزالة الإجراء. يمكنك النقر على لماذا؟ للاطّلاع على الأسباب والاطّلاع على الخيارات المتاحة لحلّ مشكلة انتهاك السياسة أو طلب إعادة النظر في القرار. |
تحديد إصدارات مشروعك
بمرور الوقت، قد تحتاج إلى تعديل المعلومات المتعلقة بالإجراء. تؤدي بعض التغييرات إلى إجراء في نسخة جديدة من مشروعك. يجب إعادة إرسال كل نسخة جديدة ومراجعة عملية المراجعة بالكامل قبل نشر الإجراء المعدَّل وعرضه على الجمهور.
يتطلب إجراء أي من التغييرات التالية إعادة إرسال إجراء للمراجعة:
- يتم إجراء تغيير في وحدة التحكّم لتعديل وصف المشروع أو رمزه أو البيانات الوصفية الأخرى.
- باستخدام "أداة إنشاء المهام" أو حزمة تطوير برامج المهام، أجريت تغييرات على مشروع "الإجراءات".
- باستخدام حزمة تطوير برامج المهام القديمة، أجريت تغييرات على حزمة الإجراءات.
- باستخدام Dialogflow، أجريت تغييرات على وكيل Dialogflow.
لست بحاجة إلى إعادة إرسال مشروعك للسيناريوهات التالية:
- لقد أجريت تغييرات على الرمز فقط في ردّ تلقائي على الويب مستضاف خارجيًا، أو محرّر الردّ التلقائي على الويب المضمّن في "أداة إنشاء المهام"، أو في المحرّر المضمّن في Dialogflow.
- تستخدم النماذج، وقد عدّلت بيانات النماذج من خلال تحميل المحتوى إلى "جداول بيانات Google".
لإرسال الإجراء المعدَّل الذي تريد مراجعته، انتقِل إلى نشر > الإصدار، ثم انقر على إنشاء إصدار. إذا تمت الموافقة على الإصدار السابق، لن يتم استخدامه وسيتم توفير أحدث إصدار من الإجراء لمستخدمي "مساعد Google".
تتبُّع النُسخ وتعديلها
لتتبُّع الإصدارات والحصول على معلومات عنها، انتقِل إلى نشر > الإصدار وانقر على النسخة التي تريد الحصول على معلومات عنها.
يعرض الجدول تاريخ آخر تعديل والحالة الحالية للإصدار. يمكنك إجراء تغييرات محددة على الحالة، بناءً على حالة الإصدار الحالي.
- إذا كان الإصدار قيد المراجعة، يمكنك اختيار سحب النسخة من المراجعة.
- في حال نشر إصدار، يمكنك اختيار إلغاء النشر من الإنتاج لإزالة الإجراء.
- في حال عدم استخدام إصدار سابق، يمكنك اختيار النشر إلى الإصدار للعودة إلى هذا الإصدار.