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

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

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

قبل إرسال الموصل للمراجعة، أكمل ما يلي في "برنامج Apps Script":

  1. مشاركة الإذن بالاطّلاع لمشروعك في "برمجة تطبيقات Google" مع ما يلي:
  2. أنشئ عملية نشر باسم Production وعدِّل عملية النشر Production إلى إصدار الرمز الذي تريد نشره.
  3. تأكَّد من تعديل عملية النشر Production إلى إصدار الرمز الذي تريد مراجعته.
  4. تأكَّد من أنّ ملف البيان يظهر في "برمجة تطبيقات Google". على يمين الصفحة، انقر على إعدادات المشروع . ضَع علامة في مربّع الاختيار عرض ملف البيان "appsscript.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، وهو خيار استضافة ننصح به.
    • سيتم رفض الموصلات التي تتضمّن رموزًا متحركة. استخدِم صورًا ثابتة.
    • ننصحك باستخدام صورة بحجم 48x48 بكسل على الأقل.
    • تجنَّب استخدام صور تتضمّن نصًا فقط ويصعب قراءتها عند تصغير حجمها إلى 48×48 بكسل.
  5. املأ الحقل sources بجميع المصادر التي يربطها الموصل. راجِع المصادر في مرجع البيان للحصول على التفاصيل.
    • يمكنك الاطّلاع على قائمة المصادر الحالية في مستودع "سجلّ البيانات". إذا لم يكن المصدر الذي تريد الربط به متوفّرًا في المستودع، أرسِل طلب سحب إلى مستودع "سجلّ البيانات" لإضافة المصدر. لن تجتاز أداة الربط عملية المراجعة إذا لم تكن المصادر في ملف البيان متوفرة في المستودع.
    • هذه بيانات وصفية إضافية للموصل سيتم فهرسته من أجل ميزة نتيجة البحث في المعرض. سيظهر الموصل في نتائج البحث عندما يبحث المستخدمون عن مصدر محدّد في المعرض.
  6. قدِّم قيمًا للسمات shortDescription وauthType وfeeType وprivacyPolicyUrl وtermsOfServiceUrl.
  7. name يجب أن يمثّل الغرض من الموصل بشكل مباشر. سيساعد الاسم الواضح المستخدمين في تحديد ما إذا كان الموصل يلبي احتياجاتهم. تجنَّب استخدام كلمة موصّل في الاسم لأنّ المستخدمين يعرفون أنّهم يبحثون عن موصّل.
    • يجب عدم تضمين رموز خاصة أو غير مرئية بهدف جذب الانتباه إلى موصلك أو تغيير موضعه.
  8. لا تستخدِم أسماء مختصرة لـ "مركز البيانات" في أي مكان في ملف البيان (مثل 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(). تختلف عملية التحقّق عن عملية مراجعة الموصل، ويتولّى فريق منفصل إدارتها، وليس فريق مركز البيانات. يُرجى الرجوع إلى الأسئلة الشائعة حول التحقّق من واجهة برمجة تطبيقات OAuth للحصول على مزيد من المعلومات. سيتم رفض الموصل إذا لم يتم إكمال عملية التحقّق من عميل OAuth.
  8. يجب الالتزام ببنود الخدمة في معارض "مركز البيانات" (المرسِل).

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

نشر Partner Connector