برای انتشار اکشن خود آماده شوید

قبل از اینکه Action خود را برای کاربران منتشر کنید، باید آن را به طور کامل آزمایش کنید، سطوح، مکان‌ها و دستگاه‌های هدف را مشخص کنید و تأیید کنید که با خط‌مشی‌های Google برای Actions مطابقت دارد. این صفحه یک نمای کلی از وظایفی را ارائه می دهد که باید هنگام آماده شدن برای ارسال Action خود برای بازبینی، برای دریافت تأییدیه انتشار آن در کانال های بتا یا تولید، انجام دهید.

توجه: قبل از ارسال پروژه خود برای تأیید و انتشار، باید اطلاعاتی درباره Action for Directory Assistant ارائه دهید.

موارد نقض خط مشی را بررسی کنید

بررسی کنید که Action شما از خط‌مشی‌های Actions on Google پیروی می‌کند. به طور کلی، این دستورالعمل ها را برای محتوای خود دنبال کنید:

• خاص باشید: کاربران باید بتوانند Action شما را به طور خاص فراخوانی کنند. هنگام انتخاب نام نمایشی یا تلفظ، خیلی گسترده یا کلی نباشید. به عنوان مثال، به‌عنوان یک عبارت اقدام، از «Talk to WeatherApp برای بررسی آب‌وهوای [شهر]» به‌جای «بررسی آب‌وهوا برای [شهر]» استفاده کنید. دستورالعمل های ارائه عبارات عمل خوب را دنبال کنید.
• از محتوای ممنوع اجتناب کنید: اقداماتی که دارای محتوای صراحتاً جنسی، خشونت‌آمیز، غیرقانونی یا نفرت‌انگیز هستند، به جز در مواردی که هدفی علمی، هنری، مستند یا آموزشی داشته باشد، خط‌مشی‌های Actions on Google را نقض می‌کند. اقداماتی که قلدری یا آزار را ترویج می کنند نیز رد یا حذف خواهند شد.
• به حق چاپ و مالکیت معنوی احترام بگذارید: مطمئن شوید که از حقوق کافی برای استفاده از محتوای ارائه شده توسط Action خود برخوردار هستید.
• صادق باشید: کاربران را با ادعاهای نادرست گمراه نکنید یا فریب ندهید.
• حفاظت از حریم خصوصی و امنیت کاربران: در نحوه مدیریت داده های کاربر، انتقال امن داده های کاربر و ارائه یک خط مشی رازداری شفاف باشید.
• به کاربران بدون درخواست گوش ندهید: کاربران باید بدانند که چه زمانی اقدام شما منتظر نظر آنهاست. باز گذاشتن میکروفون بدون درخواست از کاربر یک اشتباه رایج است که در خط‌مشی‌های ما ذکر شده است. اطمینان حاصل کنید که Action شما زمانی که کاربر منتظر دستوری برای کاهش خطر رد شدن Action شما است، به کاربر اطلاع می‌دهد.
• فراخوانی و نام‌های نمایشی خود را مرور کنید: مطمئن شوید که نام فراخوانی شما با نام نمایشی که در صفحه فهرست راهنمای شما نشان داده می‌شود مطابقت دارد. اطمینان حاصل کنید که هر دو نام به اندازه کافی خاص هستند که کاربران بتوانند به راحتی Action شما را فراخوانی کنند. فراخوانی و نام‌های نمایشی شما نیز باید از خط‌مشی‌های Actions on Google پیروی کنند.

فهرست کامل خط‌مشی‌ها را بررسی کنید و مطمئن شوید که برای تسریع در بررسی و تأیید Action از آنها پیروی می‌کنید.

نام نمایشی را تنظیم کنید

نام نمایشی مشخص می کند که چگونه کاربران به صراحت Action شما را فراخوانی می کنند. این نام در دایرکتوری Assistant نیز استفاده می شود.

برای تنظیم نام نمایشی خود، این مراحل را دنبال کنید:

1. به Develop > Invocation > Settings بروید.
2. نام نمایشی اکشن خود را وارد کنید.
3. برای شنیدن نحوه تلفظ نام، روی نماد Play کلیک کنید.

توجه: با کلیک بر روی نماد ویرایش می توانید تلفظ را تغییر دهید.

نام نمایشی خود را تغییر دهید

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

احتیاط: نام نمایشی که در کنسول Actions تنظیم کرده‌اید مستقیماً به نام برنامه پروژه از Google Cloud Platform مرتبط است. زمانی که کاربر یک جریان پیوند حساب را دنبال می‌کند، این نام برنامه در هنگام رضایت نشان داده می‌شود. اگر نام نمایشی Action خود را به روز کنید، نام برنامه به طور خودکار به روز می شود. اگر می خواهید نام برنامه خود را به طور مستقل از نام نمایشی خود تغییر دهید، می توانید این کار را با رفتن به صفحه رضایت OAuth کنسول Google Cloud Platform انجام دهید.

اختیاری: مکان یابی را مشخص کنید

به‌طور پیش‌فرض، اقدام شما در همه مناطق در دسترس است تا زمانی که زبان دستگاه کاربر روی یک نوع «انگلیسی» تنظیم شده باشد (مثلاً انگلیسی آمریکایی یا انگلیسی بریتانیایی).

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

درباره انتشار محلی بیشتر بخوانید.

اختیاری: قابلیت های سطح را مشخص کنید

Action شما می‌تواند روی سطوح مختلفی که دستیار پشتیبانی می‌کند، مانند تلفن‌ها (اندروید و iOS) و نمایشگرهای هوشمند ظاهر شود.

قابلیت‌های Surface به شما امکان می‌دهد کنترل کنید که آیا کاربران می‌توانند Action شما را بر اساس سطحی که استفاده می‌کنند فراخوانی کنند یا نه. اگر کاربران سعی کنند Action شما را روی یک سطح پشتیبانی نشده فراخوانی کنند، پیام خطایی دریافت می کنند که به آنها می گوید دستگاهشان پشتیبانی نمی شود.

در مورد قابلیت های سطح بیشتر بخوانید.

اختیاری: گزینه های Interactive Canvas را مشخص کنید

اگر Action شما از Interactive Canvas استفاده می‌کند، باید چند گزینه را در قسمت Develop > Interactive Canvas در پیمایش سمت چپ فعال و تنظیم کنید.

1. گزینه استفاده از Interactive Canvas با اکشن خود را فعال کنید.
2. URL را برای برنامه وب که میزبان تصاویر Action شما است وارد کنید.

با شبیه ساز تست کنید

قبل از انتشار Action خود، از شبیه ساز استفاده کنید تا تجربه کاربری اکشن خود را آزمایش کنید و مطمئن شوید که همه چیز کار می کند.

خطاها و تخلفات رایج زیر را بررسی کنید:

• انتقال وب هوک باید ایمن باشد: بررسی کنید که از رمزگذاری HTTPS (TLS) در حمل و نقل برای وب هوک های خود استفاده می کنید.
• تأیید درخواست‌های وب‌هوک: مطمئن شوید که درخواست‌های وب‌هوک خود را با استفاده از «Actions SDK» امضا کرده‌اید و آنها را در وب‌هوک خود تأیید کنید.
• نام اقدام خود را آزمایش کنید: مطمئن شوید که نام اقدامی که تنظیم کرده‌اید به طور مداوم Action شما را فعال می‌کند. از یک دستگاه سخت افزاری یا شبیه ساز وب استفاده کنید و نام فراخوانی خود را به طور مکرر در سناریوهای مختلف دنیای واقعی (به عنوان مثال با نویز در پس زمینه یا در فواصل مختلف از دستگاه) بیان کنید. در صورت امکان، از افراد با جنسیت های مختلف یا با لهجه های مختلف بخواهید که Action شما را فراخوانی کنند. اگر نام فراخوان شما به طور مداوم شناسایی نمی شود، ممکن است بخواهید آن را تغییر دهید.
• تست روی دستگاه‌های فیزیکی: اگرچه شبیه‌ساز وب برای آزمایش سریع Action شما در حین توسعه عالی است، اما همیشه باید فراخوانی و گفتگوها را در دستگاه‌های واقعی آزمایش کنید . این بهترین راه برای درک نحوه عملکرد Action شما در زندگی واقعی است و به شما کمک می کند تا تجربه کاربری را بهبود ببخشید.

برای آزمایش پیش‌نویس پروژه Actions فعلی خود، به Test در پیمایش اصلی بروید. این تضمین می‌کند که نسخه فعلی Action شما در شبیه‌ساز، کنسول و دستگاه‌های دارای Assistant استفاده می‌شود.

توجه: برای آزمایش Action خود در یک دستگاه فیزیکی، مانند Google Home یا تلفن Pixel، باید با استفاده از همان حساب Google که برای کنسول Actions استفاده می‌کنید، وارد سیستم شوید.

درباره شبیه ساز اکشن بیشتر بخوانید.

پروژه خود را آزاد کنید

هنگامی که پیش نویس پروژه خود را آزمایش کردید و از نتایج راضی بودید، می توانید آن را برای آزمایش های بیشتر در کانال های آلفا یا بتا مستقر کنید. از طرف دیگر، می‌توانید آن را برای بررسی و انتشار در اختیار کاربران دستیار ارسال کنید.

در بخش Deploy > Release کنسول، گزینه‌های زیر را برای نسخه‌ها پیدا خواهید کرد:

• آلفا : بهترین استفاده برای تکرارهای تست سریع. Action شما بین مجموعه کوچکی از کاربرانی که تعریف می‌کنید، بدون بررسی کامل Google توزیع می‌شود.
• بتا : بهترین استفاده برای توزیع Action شما بین مجموعه محدودی از کاربران پس از بررسی کامل Google است. از آنجایی که Action یک بررسی کامل را پشت سر گذاشته است، می‌توانید هر زمان که بخواهید آن را عمومی کنید.
• تولید : اقدام خود را برای بررسی کامل Google ارسال می کند. پس از تأیید، Action شما در دسترس کاربران Assistant قرار خواهد گرفت.

درباره انتشارات بیشتر بخوانید.

وضعیت استقرار

جدول زیر وضعیت‌های مختلف استقرار یک پروژه و مراحل دیگری را که ممکن است لازم باشد انجام دهید شرح می‌دهد:

وضعیت استقرار	شرح
تحت بررسی	هنگامی که یک استقرار جدید را ارسال می کنید، مراحل تأیید را طی می کند. بازبین‌ها Action شما را آزمایش می‌کنند و تأیید می‌کنند که هیچ خط‌مشی را نقض نکرده‌اید. پس از تکمیل بررسی، ایمیلی دریافت خواهید کرد که به شما می گوید آیا استقرار شما تایید شده است یا خیر. به‌روزرسانی‌های وضعیت استقرار: در حالی که اکثر بررسی‌ها در عرض 2 تا 3 روز کاری تکمیل می‌شوند، در برخی موارد ممکن است یک هفته یا بیشتر طول بکشد تا استقرارهای شما را تأیید کنیم.
تکذیب کرد	وضعیت رد شده به این معنی است که استقرار شما تأیید نشده است. باید ایمیلی دریافت کنید که توضیح دهد چرا استقرار شما رد شده است. همچنین می توانید روی چرا؟ در کنار وضعیت Denied در کنسول برای دیدن دلیل انکار.
مستقر شد	یک اقدام تأیید شده که فعال است و در حال ارائه به کاربران است. شما می توانید یک نسخه مستقر شده را در هر نقطه از کنسول "پایین" کنید.
تایید شده	اقدامی که بررسی شده است و در حال حاضر به کاربران ارائه نمی شود. هنگامی که یک Action قبلاً با موفقیت مورد بازبینی قرار گرفته باشد، می‌تواند در هر نقطه از کنسول منتشر شود، بدون اینکه بازبینی اضافی انجام شود.
ناسالم	Google مرتباً درخواست‌هایی را به نقطه پایانی Action شما ارسال می‌کند و بررسی می‌کند که ما پاسخ مناسبی دریافت کنیم. اگر متوجه شویم نقطه پایانی شما پایین است یا پاسخگو نیست، به طور موقت ارائه Action شما را به کاربران متوقف می کنیم. در این صورت، ایمیلی دریافت می‌کنید که به شما اطلاع می‌دهد نقطه پایانی شما ناسالم است و Action شما به وضعیت ناسالم منتقل شده است. به محض اینکه متوجه شدیم نقطه پایانی شما دوباره پاسخگو است، سرویس Action شما را برای کاربران از سر خواهیم گرفت. وقتی این اتفاق بیفتد، ایمیلی دریافت خواهید کرد و وضعیت استقرار شما باید به Deployed برگردد.
برداشته شده است	اگر پس از استقرار، نقض خط‌مشی را تشخیص دهیم، ممکن است Google اقدام شما را لغو کند. اگر این اتفاق بیفتد، ایمیلی دریافت خواهید کرد و همچنین بنری را در کنسول توسعه‌دهنده مشاهده خواهید کرد که به شما اطلاع می‌دهد که Action شما حذف شده است. می توانید کلیک کنید چرا؟ برای دیدن دلیل، و دیدن گزینه های خود برای رفع نقض خط مشی یا تجدید نظر در تصمیم. توجه: برخی از حذف‌ها نهایی هستند و قابل تجدیدنظر یا لغو نیستند.

نسخه سازی پروژه شما

با گذشت زمان، ممکن است بخواهید اطلاعات مربوط به Action خود را به روز کنید. برخی تغییرات در یک Action منجر به نسخه جدیدی از پروژه شما می شود. قبل از انتشار اکشن به روز شده و ارائه به عموم، هر نسخه جدید باید مجددا ارسال شود و مراحل بررسی کامل را طی کند.

انجام هر یک از تغییرات زیر مستلزم ارسال مجدد Action برای بررسی است:

• برای تغییر توضیحات پروژه، نماد یا سایر ابرداده ها، تغییری در کنسول ایجاد می شود.
• با استفاده از Actions Builder یا Actions SDK، تغییراتی را در پروژه Actions خود ایجاد کردید.
• با استفاده از Actions SDK قدیمی، تغییراتی در بسته Action خود ایجاد کردید.
• با استفاده از Dialogflow، تغییراتی را در عامل Dialogflow خود ایجاد کردید.

برای سناریوهای زیر نیازی به ارسال مجدد پروژه خود ندارید :

• شما فقط در یک وب هوک با میزبانی خارجی، ویرایشگر وب هوک درون خطی در Actions Builder یا در ویرایشگر درون خطی Dialogflow تغییراتی در کد خود ایجاد کردید.
• شما از الگوها استفاده می‌کنید و داده‌های الگوی خود را از طریق آپلود محتوا در برگه‌های Google به‌روزرسانی کرده‌اید.

برای ارسال Action به روز شده خود برای بررسی، به Deploy > Release بروید و روی ایجاد نسخه کلیک کنید. در صورت تایید، نسخه قبلی از کار افتاده و آخرین نسخه Action شما در دسترس کاربران Assistant قرار خواهد گرفت.

ردیابی و اصلاح نسخه ها

برای ردیابی و دریافت اطلاعات درباره نسخه‌های خود، به Deploy > Release بروید و روی نسخه‌ای که می‌خواهید درباره آن اطلاعات داشته باشید کلیک کنید.

جدول آخرین تاریخ اصلاح و وضعیت فعلی نسخه را نشان می دهد. بسته به وضعیت فعلی نسخه، می توانید تغییرات خاصی در وضعیت ایجاد کنید.

• اگر نسخه ای در حال بررسی است، می توانید انتخاب کنید که نسخه از بررسی خارج شود .
• اگر نسخه‌ای مستقر است، می‌توانید Undeploy را از تولید انتخاب کنید تا Action خود را حذف کنید.
• هنگامی که نسخه قبلی از کار افتاده است، می توانید Deploy to production را برای بازگشت به آن نسخه انتخاب کنید.