متطلّبات "موصِّل الشريك"

راجِع نظرة عامة على النشر للتعرّف على المزايا ومستوى الالتزام المطلوب لنشر موصِّل. لنشر موصل شريك، يجب أن يستوفي الموصل جميع المتطلبات الموضحة أدناه.

برمجة تطبيقات

قبل إرسال الموصِّل للمراجعة، أكمل ما يلي في برمجة التطبيقات:

  1. يمكنك مشاركة الإذن بالاطّلاع على مشروعك في "برمجة التطبيقات" مع ما يلي:
  2. أنشِئ عملية نشر باسم Production وعدِّل عملية النشر Production إلى إصدار الرمز الذي تنوي نشره.
  3. تأكَّد من تحديث عملية نشر Production إلى إصدار الرمز الذي تريد مراجعته.
  4. تأكّد من أن ملف البيان مرئي في لغة "برمجة تطبيقات Google". على يمين الصفحة، انقر على إعدادات المشروع . حدِّد مربع الاختيار إظهار ملف البيان "appsscript.json" في المحرر.

البيان

ضمِّن ما يلي في بيان الموصِّل وتأكَّد من إعداد مشروع "برمجة تطبيقات Google" لعرض ملف بيان 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 بكسل على الأقل.
    • تجنَّب استخدام الصور النصية فقط التي تصعب قراءتها عند تصغير حجمها إلى 48×48 بكسل.
  5. عليك تعبئة السمة sources بجميع المصادر التي يتصل بها الموصِّل. يمكنك الاطّلاع على المصادر في مرجع البيان لمعرفة التفاصيل.
    • يمكنك الاطّلاع على قائمة المصادر الحالية في مستودع سجلّ البيانات. إذا كان المصدر الذي تتصل به غير متوفّر في المستودع، أرسِل طلب سحب إلى مستودع سجلّ البيانات لإضافة المصدر. لن يفشل الموصل في عملية المراجعة إذا لم تكن المصادر في البيان الخاص بك موجودة في المستودع.
    • هذه بيانات وصفية إضافية للموصل التي ستتم فهرستها لميزة البحث في المعرض. سيظهر الموصل في نتائج البحث عندما يبحث المستخدمون عن مصدر معين في المعرض.
  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 وقدِّم التفاصيل في حقل النموذج استثناء 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(). تُعد عملية التحقق عملية مختلفة عن مراجعة الموصل ويعالجها فريق منفصل، وليس Looker Studio. يمكنك الرجوع إلى الأسئلة الشائعة للتحقق من واجهة برمجة تطبيقات OAuth للاطّلاع على مزيد من المعلومات. سيتم رفض الموصِّل في حال عدم اكتمال عملية التحقّق من عميل OAuth.
  8. التأكَّد من الالتزام ببنود الخدمة في "معارض Looker Studio" (المرسِل).

بعد استيفاء جميع المتطلبات، انقر على الزر التالي لطلب مراجعة الموصِّل:

نشر موصل الشريك