הדרישות למחבר השותפים

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

Apps Script

לפני ששולחים את המחבר לבדיקה, צריך לבצע את הפעולות הבאות ב-Apps Script:

  1. שיתוף גישת צפייה בפרויקט Apps Script עם הגורמים הבאים:
  2. יוצרים פריסה בשם Production ומעדכנים את הפריסה Production לגרסת הקוד שרוצים לפרסם.
  3. מוודאים שעדכנתם את הפריסה Production לגרסת הקוד שאתם רוצים לבדוק.
  4. מוודאים שקובץ המניפסט מוצג ב-Apps Script. בצד ימין, לוחצים על הגדרות הפרויקט . מסמנים את תיבת הסימון הצגת קובץ המניפסט 'Appscript.json' בעורך.

מניפסט

צריך לכלול את הפרטים הבאים במניפסט של המחבר ולוודא שהפרויקט ב-Apps Script מוגדר להצגת קובץ המניפסט appsscript.json בעורך.

מידע נוסף זמין במאמר בנושא מניפסט של מחבר לקהילה.

dataStudio

  1. description צריך לספק מידע והוראות שיאפשרו להבין את המחבר ואת אופן השימוש בו. מחברים עם תיאורים לא ברורים או לא מלאים יידחו.
  2. ‫addOnUrl צריך להיות דף ייעודי שמתאר את המחבר, רצוי שהוא יתארח בדומיין שלכם. הדף חייב לכלול את הפרטים הבאים:
    • מדיניות פרטיות ותנאים והגבלות או קישור לתוכן הזה, באותו דומיין כמו addOnUrl.
    • פרטים שהמשתמש צריך לדעת כדי להשתמש במחבר.
    • הקישור להרשמה, אם נדרש חשבון כדי להשתמש במחבר.
    • תוכן שעדיף לארח בדומיין שלכם. אסור לארח ב-https://sites.google.com/.
    • דוגמאות לדפים של שותפים קיימים: Funnel, ‏ Supermetrics,‏ CallRail.
  3. supportUrl צריך להיות דף מארח כדי לקבל תמיכה בנוגע למחבר. אסור להשתמש בכתובת אימייל או בקישור mailto.
  4. ‫logoUrl צריך להפנות לתמונה סטטית שמתארחת בשליטתכם. אי אפשר להשתמש בתמונות שמוצגות על ידי שירותי Google בדומיינים כמו *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com. מותר להשתמש ב-Google Cloud Storage כדי להציג תמונות מהדומיין *.googleapis.com, וזו אפשרות מומלצת לאירוח.
    • מחברים עם סמלים מונפשים יידחו. השתמשו בתמונות סטטיות.
    • מומלץ להשתמש בתמונה בגודל של ‎48 x 48 פיקסלים לפחות.
    • אל תשתמשו בתמונות שמכילות טקסט בלבד, שקשה לקרוא כשהן מוקטנות לגודל של 48x48 פיקסלים.
  5. מאכלסים את הנכס sources בכל המקורות שהמחבר מתחבר אליהם. פרטים נוספים זמינים במאמר מקורות בהפניה למניפסט.
    • אפשר לראות את רשימת המקורות הקיימת במאגר נתוני הרישום. אם המקור שאליו אתם מתחברים לא קיים במאגר, אתם יכולים לשלוח בקשת משיכה למאגר של מרשם הנתונים כדי להוסיף את המקור. המחבר שלכם ייכשל בתהליך הבדיקה אם המקורות במניפסט לא קיימים במאגר.
    • אלה מטא-נתונים נוספים של המחבר שיעברו אינדוקס כדי שיהיה אפשר לחפש אותם בגלריה. המחבר שלכם יופיע בתוצאות החיפוש כשמשתמשים יחפשו מקור ספציפי בגלריה.
  6. צריך לספק ערכים לפרמטרים shortDescription,‏ authType,‏ feeType,‏ privacyPolicyUrl ו-termsOfServiceUrl.
  7. name צריך לייצג באופן ישיר את המטרה של המחבר. שם ברור יעזור למשתמשים להבין אם המחבר עונה על הצרכים שלהם. אל תשתמשו במילה connector (מחבר) בשם, כי המשתמשים כבר יודעים שהם מסתכלים על מחבר.
    • אל תכללו תווים מיוחדים או תווים לא גלויים במטרה למשוך תשומת לב למחבר או לשנות את המיקום שלו.
  8. אל תשתמשו בשמות מקוצרים של Data Studio בשום מקום בקובץ המניפסט (למשל GDS,‏ DS וכו').
  9. אסור להשתמש באמוג'י בשום שדה במניפסט (description, shortDescription, name וכו'). באופן כללי, אל תכללו תווים מיוחדים או תווים לא גלויים במטרה למשוך תשומת לב למחבר.
  10. אם למחבר שלכם יש סכימה קבועה, יוצרים תבנית דוח למחבר ומוסיפים אותה למניפסט. מפעילים את האפשרות שיתוף באמצעות קישור בדוח.

urlFetchWhitelist

  1. הגבלת מספר נקודות הקצה שמופעלות על ידי UrlFetchApp לאלה שנדרשות באופן מוחלט לפונקציונליות של המחבר. מוסיפים את המאפיין urlFetchWhitelist לרמת השורש של המניפסט. מידע נוסף זמין במאמר בנושא רשימת ההיתרים של urlFetch.
    • צריך לכלול את כל נקודות הקצה שמשמשות עם השירות UrlFetchApp.
    • אם המחבר לא מאחזר משאבים באמצעות UrlFetchApp השירות, צריך להגדיר את urlFetchWhitelist לרשימה ריקה [].
    • אם המחבר לא מתחבר לקבוצה של נקודות קצה קבועות או אם הקידומת של נקודת הקצה משתנה, צריך להשמיט את המאפיין urlFetchWhitelist ולספק פרטים בשדה הטופס Exception for urlFetchWhitelist כששולחים את בקשת הבדיקה.

oauthScopes

  1. הגדרת היקפי הרשאות מפורשים של OAuth במניפסט. מחברים ללא היקפי הרשאות מפורשים של OAuth יידחו.

גשר בין אנשים

  1. אם המשתמש צריך חשבון כדי להשתמש במחבר, צריך לוודא שהמחברdescription או הקישור addOnUrl מספקים הוראות שיעזרו למשתמש ליצור חשבון.
  2. המחבר לא יכול להיות במצב לא גמור או בגרסת בטא. אתם צריכים לפרסם מחבר מלא ופונקציונלי. תמיד אפשר לעדכן את המחבר, אבל צריך לבדוק את הפריסה בסביבת הייצור שמופצת למשתמשים ולוודא שהיא כוללת את כל התכונות.
  3. כשמשתמשים נתקלים בשגיאה פנימית של המחבר, צריך להציג להם הודעות שגיאה משמעותיות שכוללות הוראות לפתרון הבעיה. כולל מקרים שבהם משתמש מספק קלט לא תקין או ריק במהלך ההגדרה.
  4. הקישור shortDescription, הקישור description, הקישור addOnUrl, הקישור supportUrl והדף של OAuth (אם רלוונטי) צריכים להיות נקיים משגיאות כתיב ודקדוק.
  5. השדה shortDescription לא יכול להכיל כתובות URL.
  6. שימוש בשיטות אימות שסופקו על ידי getAuthType(). אין לבקש פרטי כניסה דרך getConfig().
  7. משלימים את תהליך אימות לקוח OAuth. האימות הוא חובה לכל המחברים, ללא קשר לשיטת האימות ב-getAuthType(). תהליך האימות הוא תהליך שונה מביקורת המחבר, והוא מטופל על ידי צוות נפרד, לא על ידי Data Studio. למידע נוסף, אפשר לעיין בשאלות הנפוצות בנושא אימות אפליקציות באמצעות OAuth API. המחבר שלך יידחה אם לא תשלים את תהליך האימות של לקוח OAuth.
  8. חשוב לוודא שאתם עומדים בתנאים ובהגבלות של גלריות Data Studio (לשולחים).

אחרי שתוודאו שאתם עומדים בכל הדרישות, תוכלו ללחוץ על הלחצן הבא כדי לבקש בדיקה של המחבר:

פרסום של מחבר השותפים