הכנה לפרסום הפעולה

לפני שמפרסמים את הפעולה למשתמשים, צריך לבדוק אותה ביסודיות, לציין את הפלטפורמות, המיקומים והמכשירים לטירגוט ולוודא שהיא תואמת למדיניות של Google לגבי פעולות. הדף הזה כולל סקירה כללית של המשימות שצריך לבצע כהכנה לשליחת הפעולה לבדיקה, כדי לקבל אישור לשחרורה בערוצי בטא או בייצור.

בדיקה לאיתור הפרות מדיניות

יש לוודא שהפעולה תואמת למדיניות של Actions on Google. באופן כללי, חשוב להקפיד על ההנחיות הבאות לגבי התוכן:

• הקפדה על קונקרטיות: המשתמשים צריכים להיות מסוגלים להפעיל את הפעולה באופן ספציפי. אל תהיו רחבים או כלליים מדי בבחירת שם לתצוגה או הגייה. לדוגמה, השתמשו בביטוי "Talk to WeatherApp כדי לבדוק את מזג האוויר ב[city]" במקום "Check the weather for [city]" כביטוי לפעולה. מומלץ לפעול לפי ההנחיות להוספת ביטויים מוצלחים לפעולה.
• הימנעות מפרסום תוכן אסור: פעולות שכוללות תוכן מיני, אלים, לא חוקי או מלא שנאה במפורש מפירות את המדיניות של Actions on Google, אלא אם המטרה היא מדעית, אומנותית, תיעודית או חינוכית. גם פעולות שמקדמות בריונות או הטרדה יידחו או יוסרו.
• לכבד זכויות יוצרים וקניין רוחני: חשוב לוודא שיש לכם את הזכויות המתאימות לשימוש בתוכן שמציע הפעולה.
• כנות: אין להטעות או להונות משתמשים באמצעות טענות שקריות.
• הגנה על הפרטיות והאבטחה של המשתמשים: חשוב לנהל בשקיפות את הטיפול בנתוני משתמשים, לשדר נתוני משתמשים בצורה מאובטחת ולספק מדיניות פרטיות.
• לא להקשיב למשתמשים שלא מתבקשים לעשות זאת: המשתמשים צריכים להבין מתי הפעולה ממתינה לקלט שלהם. טעות נפוצה שמתוארת במדיניות שלנו היא להשאיר את המיקרופון פתוח בלי לבקש מהמשתמש הנחיות. חשוב לוודא שהפעולה מיידעת את המשתמש כשהוא ממתין לפקודה כדי להפחית את הסיכון שהפעולה תידחה.
• בדיקת השמות המוצגים ושמות ההפעלה: ודאו ששם ההפעלה תואם לשם המוצג בדף הספרייה של Assistant. חשוב לוודא ששני השמות ספציפיים מספיק כדי שהמשתמשים יוכלו להפעיל את הפעולה בקלות. שמות ההפעלה והשמות לתצוגה חייבים גם הם לעמוד בכללי המדיניות של Actions on Google.

מומלץ לעיין ברשימה המלאה של כללי המדיניות ולוודא שאתם מצייתים להם כדי לזרז את הבדיקה והאישור של הפעולה.

הגדרת השם המוצג

השם המוצג מגדיר את האופן שבו המשתמשים מפעילים את הפעולה באופן מפורש. השם הזה משמש גם בספרייה של Assistant.

כדי להגדיר את שם התצוגה:

1. עוברים אל פיתוח > הפעלה > הגדרות.
2. מזינים את השם המוצג של הפעולה.
3. לוחצים על הסמל הפעלה play_circle_filled כדי לשמוע איך הוגים את השם.

שינוי השם המוצג

ניתן לשנות את השם המוצג של הפעולה בכל שלב. עם זאת, הפעולה תעבור תהליך בדיקה מלא נוסף לפני שהמשתמשים יוכלו להפעיל את הפעולה באמצעות השם החדש.

אופציונלי: ציון של טירגוט למיקום גיאוגרפי

כברירת מחדל, הפעולה זמינה בכל האזורים, כל עוד הגדרת השפה של המכשיר של המשתמש היא בווריאנט 'אנגלית' (לדוגמה, אנגלית אמריקאית או אנגלית בריטית).

ההגדרה טירגוט למיקום גיאוגרפי קובעת את הזמינות האזורית של הפעולה.

למידע נוסף על פרסום מקומי.

אופציונלי: ציון היכולות של הפלטפורמה

הפעולה יכולה להופיע במגוון פלטפורמות שנתמכות על ידי Assistant, כמו טלפונים (Android ו-iOS) ומסכים חכמים.

בעזרת יכולות פני השטח תוכלו לקבוע אם משתמשים יוכלו להפעיל את הפעולה על סמך הפלטפורמה שבה הם משתמשים. אם משתמשים ינסו להפעיל את הפעולה במשטח לא נתמך, הם יקבלו הודעת שגיאה על כך שהמכשיר שלהם לא נתמך.

למידע נוסף על יכולות של שטחי פרסום.

אופציונלי: ציון אפשרויות של לוח ציור אינטראקטיבי

אם הפעולה מבוססת על Interactive Canvas, צריך להפעיל ולהגדיר שתי אפשרויות בקטע פיתוח > לוח שיתופי אינטראקטיבי בתפריט הניווט הימני.

1. צריך להפעיל את האפשרות להשתמש בלוח הציור האינטראקטיבי עם הפעולה.
2. מזינים את כתובת ה-URL של אפליקציית האינטרנט שמארחת את הרכיבים החזותיים של הפעולה.

בדיקה באמצעות הסימולטור

לפני פרסום הפעולה, כדאי להשתמש בסימולטור כדי לבדוק את חוויית המשתמש בפעולה ולוודא שהכל עובד.

מחפשים את השגיאות וההפרות הנפוצות הבאות:

• העברת תגובה לפעולה מאתר אחר (webhook) צריכה להיות מאובטחת: עליכם לוודא שאתם משתמשים בהצפנת HTTPS (TLS) בהעברה של ה-webhooks.
• אימות בקשות ל-webhook: חשוב להקפיד לחתום על בקשות webhook באמצעות Actions SDK ולאמת אותן ב-webhook.
• בדיקת שם הפעולה: חשוב לוודא ששם הפעולה שהגדרתם מפעיל באופן עקבי את הפעולה. משתמשים במכשיר חומרה או בסימולטור האינטרנט ואומרים שוב ושוב את שם ההפעלה בתרחישים שונים בעולם האמיתי (למשל, עם רעש ברקע או במרחקים שונים מהמכשיר). אם אפשר, בקשו מאנשים ממגדרים שונים או עם סימנים דיאקריטיים שונים להפעיל את הפעולה. אם שם הקריאה לא מזוהה באופן עקבי, כדאי לשנות אותו.
• בדיקה במכשירים פיזיים: אף על פי שסימולטור האינטרנט הוא כלי מעולה לבדיקת הפעולה במהירות במהלך הפיתוח, תמיד כדאי לבדוק את ההפעלה ותיבות הדו-שיח במכשירים אמיתיים. זו הדרך הטובה ביותר להבין איך הפעולה פועלת בחיים האמיתיים, ולעזור לכם לשפר את חוויית המשתמש.

כדי לבדוק את הטיוטה של פרויקט הפעולות הנוכחי, עוברים אל בדיקה בסרגל הניווט הראשי. כך ניתן להבטיח שמשתמשים בגרסה הנוכחית של הפעולה בסימולציה, במסוף ובמכשירים עם Assistant מובנית.

מידע נוסף על סימולטור הפעולות.

שחרור הפרויקט

אחרי שבדקתם את טיוטת הפרויקט ואתם מרוצים מהתוצאות, תוכלו לפרוס אותה בערוצי אלפא או בטא כדי לבצע בדיקות נוספות. לחלופין, אפשר לשלוח אותה לבדיקה ולשלוח אותה למשתמשי Assistant.

בקטע Deploy > Release (פריסה > גרסה) במסוף מופיעות האפשרויות הבאות לגבי גרסאות:

• אלפא: משמש בצורה הטובה ביותר לביצוע בדיקות חוזרות. הפעולה מופצת לקבוצה קטנה של משתמשים שאתם מגדירים, בלי לעבור בדיקה מלאה של Google.
• בטא: המתאימה ביותר להפצת הפעולה לקבוצה מוגבלת של משתמשים, לאחר בדיקה מלאה של Google. מכיוון שהפעולה עברה בדיקה מלאה, תוכלו להגדיר אותה כגלויה לכולם בכל שלב.
• הפקה: שליחת הפעולה לבדיקה מלאה של Google. לאחר שהפעולה תאושר, היא תהיה זמינה למשתמשי Assistant.

מידע נוסף על פריטי תוכן

סטטוס פריסה

בטבלה הבאה מפורטים הסטטוסים השונים של הפריסה של פרויקטים, ופעולות נוספות שצריך לבצע:

ניהול גרסאות של הפרויקט

במשך הזמן, כדאי לעדכן את פרטי הפעולה. חלק מהשינויים ב-Action יוצרים גרסה חדשה של הפרויקט. צריך לשלוח מחדש כל גרסה חדשה ולעבור את תהליך הבדיקה המלא לפני שהפעולה המעודכנת תפורסם ותוצג לציבור.

ביצוע כל אחד מהשינויים הבאים מחייב אותך לשלוח מחדש פעולה לבדיקה:

• במסוף מתבצע שינוי כדי לשנות את התיאור, הסמל או מטא-נתונים אחרים של הפרויקט.
• ביצעתם שינויים בפרויקט Actions באמצעות Actions Builder או Actions SDK.
• באמצעות ה-Actions SDK מדור קודם, ביצעת שינויים בחבילת הפעולות שלך.
• ביצעת שינויים בנציג של Dialogflow באמצעות Dialogflow.

אין צורך לשלוח מחדש את הפרויקט במקרים הבאים:

• שינית את הקוד רק ב-webhook באירוח חיצוני, בעורך webhook שמוטבע ב-Actions Builder או בעורך המוטבע של Dialogflow.
• אתם משתמשים ב-Templates ועדכנתם את נתוני התבנית על ידי העלאת תוכן ל-Google Sheets.

כדי לשלוח את הפעולה המעודכנת לבדיקה, עוברים אל פריסה > גרסה ולוחצים על יצירת גרסה. אם הבקשה תאושר, הגרסה הקודמת לא תהיה זמינה יותר והגרסה האחרונה של הפעולה תהיה זמינה למשתמשי Assistant.

מעקב אחר גרסאות ושינוי שלהן

כדי לעקוב אחר הגרסאות ולקבל מידע עליהן, עוברים אל פריסה > גרסה ולוחצים על הגרסה שעליה רוצים לקבל מידע.

בטבלה מוצגים תאריך השינוי האחרון והסטטוס הנוכחי של הגרסה. אפשר לבצע שינויים ספציפיים בסטטוס, בהתאם לסטטוס הנוכחי של הגרסה.

• אם גרסה מסוימת נמצאת בבדיקה, תוכלו לבטל את הבדיקה של הגרסה.
• אם גרסה מסוימת פרוסה, תוכלו לבחור באפשרות ביטול פריסה מהייצור כדי להסיר את הפעולה.
• כשגרסה קודמת לא פרוסה, אפשר לבחור באפשרות פריסה לסביבת ייצור כדי לחזור לגרסה הזו.