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

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

Apps Script

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

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

מניפסט

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

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

dataStudio

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

urlFetchWhitelist

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

oauthScopes

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

מחבר

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

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

מפרסמים את Partner Connector