الزامات اتصال شریک

برای درک مزایا و سطح تعهد لازم برای انتشار یک رابط، نمای کلی انتشار را مرور کنید. برای انتشار یک رابط شریک ، رابط شما باید همه شرایطی را که در زیر توضیح داده شده است، برآورده کند.

اسکریپت برنامه ها

قبل از ارسال رابط خود برای بررسی، موارد زیر را در Apps Script تکمیل کنید:

  1. دسترسی مشاهده پروژه Apps Script خود را با موارد زیر به اشتراک بگذارید :
  2. یک استقرار به نام Production ایجاد کنید و استقرار Production را به نسخه کدی که قصد انتشار آن را دارید به روز کنید.
  3. تأیید کنید که استقرار Production را به نسخه کدی که می‌خواهید بازبینی کنید، به‌روزرسانی کرده‌اید.
  4. تأیید کنید که فایل مانیفست در Apps Script قابل مشاهده است. در سمت چپ، روی تنظیمات پروژه کلیک کنید. کادر بررسی نمایش فایل مانیفست "appsscript.json" در ویرایشگر را انتخاب کنید.

آشکار

موارد زیر را در مانیفست رابط خود وارد کنید و تأیید کنید که پروژه Apps Script شما برای نمایش فایل مانیفست appsscript.json در ویرایشگر پیکربندی شده است.

برای اطلاعات بیشتر ، مرجع مانیفست Connector Community را مشاهده کنید.

dataStudio

  1. description باید اطلاعات و دستورالعمل هایی را برای درک اولیه کانکتور و نحوه استفاده از آن ارائه دهد. رابط هایی با توضیحات مبهم و ناقص رد می شوند.
  2. addOnUrl باید یک صفحه میزبان اختصاصی در مورد رابط شما باشد، ترجیحاً در دامنه خود میزبانی شود. صفحه باید شامل موارد زیر باشد:
    • یک خط‌مشی رازداری و شرایط استفاده یا پیوندی به این محتوا، در همان دامنه addOnUrl .
    • جزئیاتی که کاربر برای استفاده از رابط شما باید بداند.
    • پیوند ثبت نام، در صورتی که برای استفاده از رابط شما نیاز به حساب کاربری دارید،.
    • محتوایی که ترجیحاً در دامنه شما میزبانی می شود. میزبانی در https://sites.google.com/ مجاز نیست.
    • صفحات نمونه از شرکای موجود را ببینید: Funnel ، Supermetrics ، CallRail .
  3. supportUrl باید یک صفحه میزبان برای دریافت پشتیبانی از کانکتور شما باشد. این نمی تواند یک پیوند ایمیل یا نامه به ایمیل باشد.
  4. logoUrl باید به یک تصویر ثابت که تحت کنترل شما میزبانی می شود اشاره کند. شما نمی توانید از تصاویر ارائه شده توسط سرویس های Google در دامنه هایی مانند *.gstatic.com ، *.ggpht.com ، *.google.com ، *.googleusercontent.com استفاده کنید. استفاده از Google Cloud Storage برای ارائه تصاویر از دامنه *.googleapis.com قابل قبول است و یک گزینه میزبانی توصیه شده است.
    • اتصالات دارای نمادهای متحرک رد خواهند شد. از تصاویر ثابت استفاده کنید.
    • توصیه می شود حداقل از یک تصویر 48x48 پیکسل استفاده کنید.
    • از تصاویر فقط متنی که خواندن آنها با کوچک شدن تا 48x48 پیکسل دشوار است خودداری کنید.
  5. sources را پر کنید دارایی با تمام منابعی که کانکتور شما به آنها متصل است. برای جزئیات بیشتر به منابع در مرجع مانیفست مراجعه کنید.
    • می‌توانید فهرست منابع موجود را در Data Registry Repository مشاهده کنید. اگر منبعی که به آن متصل می شوید در مخزن وجود ندارد، یک درخواست کشش به مخزن ثبت داده ارسال کنید تا منبع را اضافه کنید. اگر منابع موجود در مانیفست شما در مخزن وجود نداشته باشند، کانکتور شما فرآیند بررسی را با شکست مواجه خواهد کرد.
    • این ابرداده اضافی برای رابط است که برای ویژگی جستجو در گالری نمایه می شود. هنگامی که کاربران منبع خاصی را در گالری جستجو می کنند، رابط شما در نتایج جستجو نشان داده می شود.
  6. ارائه مقادیر برای shortDescription ، authType ، feeType ، privacyPolicyUrl ، و termsOfServiceUrl .
  7. name باید به طور مستقیم هدف اتصال را نشان دهد. یک نام واضح به کاربران کمک می کند تا تشخیص دهند که آیا رابط شما نیازهای آنها را برآورده می کند یا خیر. از استفاده از کلمه اتصال در نام خودداری کنید زیرا کاربران از قبل می دانند که به یک رابط نگاه می کنند.
    • نویسه‌های خاص یا غیرقابل مشاهده را به قصد جلب توجه یا تغییر بالقوه موقعیت کانکتور خود وارد نکنید.
  8. از نام های کوتاه برای Looker Studio در هیچ کجای مانیفست استفاده نکنید (مانند GDS، DS، و غیره).
  9. ایموجی ها در هیچ فیلد مانیفست مجاز نیستند ( description ، shortDescription ، name ، و غیره). به طور کلی، کاراکترهای خاص یا غیر قابل مشاهده را به قصد جلب توجه به رابط خود وارد نکنید.
  10. اگر کانکتور شما طرحی ثابت دارد، یک الگوی گزارش برای رابط خود ایجاد کنید و آن را به مانیفست اضافه کنید. اشتراک گذاری با پیوند را برای گزارش فعال کنید.

urlFetchWhitelist

  1. تعداد نقاط پایانی فراخوانی شده توسط UrlFetchApp را به نقاط پایانی که برای عملکرد رابط ضروری هستند محدود کنید. ویژگی urlFetchWhitelist را به سطح ریشه مانیفست خود اضافه کنید. برای اطلاعات بیشتر ، مرجع urlFetchWhitelist را مشاهده کنید.
    • شامل تمام نقاط پایانی مورد استفاده با سرویس UrlFetchApp باشد.
    • اگر رابط شما منابع را با استفاده از سرویس UrlFetchApp واکشی نمی کند، urlFetchWhitelist روی یک لیست خالی [] تنظیم کنید.
    • اگر رابط شما به مجموعه‌ای از نقاط پایانی ثابت وصل نمی‌شود یا پیشوند نقطه پایانی متفاوت است، ویژگی urlFetchWhitelist را حذف کنید و هنگام ارسال درخواست بررسی، جزئیات را در قسمت فرم Exception for urlFetchWhitelist ارائه دهید.

oauthScopes

  1. محدوده های OAuth صریح را در مانیفست تنظیم کنید . رابط‌های بدون محدوده OAuth صریح رد خواهند شد.

رابط

  1. اگر کاربر برای استفاده از رابط نیاز به یک حساب دارد، مطمئن شوید که description رابط یا پیوند addOnUrl دستورالعمل‌هایی برای کمک به کاربر در ایجاد آن ارائه می‌دهد.
  2. رابط شما نمی تواند در وضعیت ناتمام یا بتا باشد. باید یک کانکتور کامل و کاربردی منتشر کنید. همیشه می‌توانید کانکتور خود را به‌روزرسانی کنید، اما استقرار تولیدی که برای کاربران منتشر می‌شود باید آزمایش شود و ویژگی کامل شود.
  3. هنگامی که کاربران با خطای داخلی Connector مواجه می‌شوند، پیام‌های خطای معنی‌دار و کاربردی را به کاربران ارائه دهید. این شامل مواردی می شود که کاربر ورودی نامعتبر/خالی را در پیکربندی ارائه می دهد.
  4. shortDescription ، description ، پیوند addOnUrl ، پیوند supportUrl و صفحه OAuth (در صورت وجود) باید عاری از اشتباهات املایی و دستوری باشد.
  5. shortDescription نمی تواند حاوی URL باشد.
  6. از روش های احراز هویت ارائه شده توسط getAuthType() استفاده کنید. از طریق getConfig() درخواست اعتبار نکنید.
  7. فرآیند تأیید مشتری OAuth را تکمیل کنید. تایید برای همه کانکتورها بدون توجه به روش احراز هویت در getAuthType() اجباری است. فرآیند تأیید فرآیندی متفاوت از بررسی رابط است و توسط یک تیم جداگانه، نه استودیو Looker اداره می‌شود. برای اطلاعات بیشتر ، سؤالات متداول تأیید OAuth API را ببینید. اگر فرآیند تأیید مشتری OAuth تکمیل نشود، رابط شما رد خواهد شد.
  8. اطمینان حاصل کنید که به شرایط خدمات استودیو Looker Galleries (ارسال کننده) پایبند هستید.

هنگامی که تمام شرایط مورد نیاز را برآورده کردید، روی دکمه زیر کلیک کنید تا کانکتور خود را بررسی کنید:

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