موصل Data Studio المخصص: متى تبنونه، وكيف يعمل، وكم يكلّف

ما هو موصل Data Studio المخصص؟

هو شيفرة تعلّم Data Studio كيف يسجّل الدخول إلى مصدر، وما الحقول التي يوفرها، وكيف يجلب الصفوف عند الطلب. تسمي وثائق المطورين لدى Google هذه الموصلات «موصلات المجتمع» (community connectors) (واحتفظت بهذا الاسم طوال سنوات Looker Studio)، وهي تُكتب بـ Google Apps Script وفق Connector API من Google.

يجب أن يعرّف كل موصل أربع دوال. تخبر getAuthType الـ Data Studio بطريقة تسجيل دخول المستخدم. وتطلب getConfig من المستخدم الإعدادات، مثل معرّف الحساب أو اشتراط نطاق زمني. وتعيد getSchema قائمة الأبعاد والمقاييس مع أنواعها. وتعيد getData الصفوف للحقول التي طلبها المخطط فعلًا. وبعد النشر، يظهر الموصل كمصدر بيانات مثل موصلَي GA4 وGoogle Ads الأصليين، وتعمل تقاريركم وحقولكم المحسوبة وعوامل التصفية والإرسال المجدول فوقه كالمعتاد.

تذكر وثائق Google سبعة أنواع مصادقة مدعومة: OAuth 2.0 وUSER_PASS وUSER_TOKEN وKEY وPATH_USER_PASS وPATH_KEY وNONE. ويجب تخزين بيانات الاعتماد في خصائص المستخدم نفسه (PropertiesService.getUserProperties)، لا كتابتها في حقول الإعدادات، كي لا يظهر مفتاح API أبدًا لمحرري التقرير الآخرين.

هل تحتاجون إلى موصل مخصص أم موصل شركاء أم مسار بيانات؟

معظم الفرق التي تطلب مني موصلًا مخصصًا تحتاج في النهاية إلى شيء آخر. وقبل كتابة أي شيفرة، أعرض المصدر على ثلاثة أسئلة: هل يوجد موصل له بالفعل، وكم من البيانات يحتاج كل تقرير، وما مدى حداثة البيانات المطلوبة؟

يتصل Data Studio أصليًا بـ GA4 وGoogle Ads وSearch Console وSheets وBigQuery وYouTube وCampaign Manager 360 وDisplay and Video 360 وAd Manager وCloud SQL وMySQL وPostgreSQL وSQL Server وRedshift. وتغطي موصلات الشركاء من مزودين مثل Supermetrics وWindsor.ai وPorter Metrics وFunnel وPower My Analytics وCatchr مئات المنصات الشائعة مقابل رسوم شهرية. ولا يكون البناء المخصص منطقيًا إلا حيث لا يغطي أيٌّ منهما مصدركم، أو حيث لا يستطيع المزود تشكيل البيانات بالطريقة التي تحتاجها تقاريركم.

بماذا يمكن لموصل المجتمع أن يتصل؟

بأي شيء تقريبًا يمكن الوصول إليه عبر الإنترنت. تذكر وثائق Google أربعة مسارات: واجهات الويب API، وقواعد بيانات JDBC، والملفات المسطحة بصيغ CSV أو JSON أو XML، وخدمات Apps Script الأخرى. وعمليًا تنقسم الطلبات التي أراها إلى ثلاث مجموعات.

الأولى نظام داخلي له واجهة API، مثل منصة طلبات أو محرك حجوزات أو أداة لإدارة وثائق التأمين. والثانية منتج SaaS متخصص لا يدعمه كبار مزودي الموصلات. والثالثة شركة منتجات تريد أن يعدّ عملاؤها تقارير عن بياناتها في Data Studio، وهي الحالة التي يكون فيها نشر الموصل للعموم منطقيًا.

• واجهات REST API داخلية بمصادقة بمفتاح أو رمز.
• أدوات SaaS قطاعية لها واجهة API لكن دون موصل شركاء.
• قواعد بيانات يمكن الوصول إليها عبر JDBC ولا تغطيها الموصلات الأصلية.
• ملفات CSV أو JSON أو XML مستضافة تتحدّث وفق جدول زمني.

كيف يُبنى موصل Data Studio المخصص خطوة بخطوة؟

البناء نفسه هو الجزء الأصغر. فمعظم الجهد يكمن في الاتفاق على الحقول، والتعامل مع خصوصيات المصدر، والاختبار مقابل أرقام تثق بها الشركة بالفعل. وهذا هو التسلسل الذي أتبعه.

• النطاق: حصر التقارير التي يغذيها الموصل، وكل حقل تحتاجه، ونوعه، والمجاميع التي ستتم المطابقة معها.
• مراجعة API: طريقة المصادقة، والتقسيم إلى صفحات، وحدود المعدل، والتصفية حسب التاريخ، ومدى عمق البيانات التاريخية.
• المصادقة: اختيار نوع المصادقة المناسب وتخزين بيانات الاعتماد في خصائص المستخدم، مع رسائل خطأ واضحة عند انتهاء صلاحية المفتاح.
• الإعدادات والمخطط: تعريف الإعدادات التي يختارها المستخدمون ومخطط محدد الأنواع، بأبعاد ومقاييس مسماة بالطريقة التي يتحدث بها فريقكم.
• getData: جلب الحقول والنطاق الزمني المطلوبين فقط، والتنقل بين صفحات النتائج، ومطابقتها مع المخطط.
• التخزين المؤقت: حفظ الاستجابات الحديثة كي لا تستدعي تحميلات المخططات المتكررة الـ API مرة أخرى.
• الأخطاء: إعادة رسائل مفهومة بدلًا من مخطط فارغ، لأن Data Studio لا يعطي أي تحذير عند تعطل الموصل.
• النشر والاختبار: إنشاء نشر بإصدار محدد، وربطه في تقرير تجريبي، ومطابقة المجاميع، ثم مشاركته مع فريقكم.
• التسليم: الشيفرة في حساب Google الخاص بكم، ووثيقة موجزة بالحقول والحدود، وشرح مصوّر.

ما الحدود التي يجب التخطيط لها قبل بناء موصل؟

تضع حصص Apps Script السقف، لذا قارنوها أولًا بحجم بياناتكم. الأرقام أدناه مأخوذة من صفحة حصص Apps Script ومرجع خدمة Cache لدى Google، وقد اطّلعت عليهما في أكتوبر 2026. ورقم URL Fetch يومي للحساب الذي يشغّل السكربت، وهذا مهم عندما يفتح كثير من المشاهدين تقريرًا في الوقت نفسه.

وتبقى حدود Data Studio نفسه سارية فوق ذلك. فعمليات الدمج تستوعب حتى 5 مصادر بيانات بروابط تساوٍ فقط، والاستعلامات الكبيرة جدًا تعيد أخطاء «عدد الصفوف كبير جدًا». ولا يرفع الموصل أيًا من هذين الحدين.

لماذا تكون الموصلات المخصصة بطيئة، وكيف تحافظون على سرعتها؟

كل طلب بيانات يشغّل Apps Script قبل أن يُسأل مصدركم أصلًا، والصفحات ذات المخططات والمشاهدين الكثيرين تُنتج طلبات كثيرة. وفي نقاش بتاريخ يوليو 2025 على منتدى المطورين لدى Google (discuss.google.dev، بعنوان Custom Connectors Very Slow)، أفاد مطوّر بأن المخططات استغرقت أكثر من 10 ثوانٍ لتظهر حتى عندما أعاد الموصل نتيجة صغيرة ثابتة في الشيفرة، ولم يُنشر في النقاش أي حل. وهذا يطابق ما أراه: عبء ثابت لكل استدعاء، مضروب في عدد المخططات في الصفحة.

والحلول في معظمها قرارات تصميم لا شيفرة ذكية. فتقليل المخططات في الصفحة، وعوامل التصفية التي تضيّق الطلب، والاستجابات المجمّعة قبل وصولها إلى Data Studio، كلها تساعد. وحيث تكون البيانات كبيرة أو الـ API بطيئة، فالحل الأفضل هو تحميلها إلى BigQuery وفق جدول زمني وتوجيه Data Studio إلى جدول مقسّم، مما يُخرج Apps Script من مسار العرض تمامًا.

• أعيدوا فقط الحقول والنطاق الزمني اللذين طلبهما المخطط.
• اجمعوا البيانات في الـ API أو في طبقة تخزين مؤقت، لا صفًا بصف في Data Studio.
• خزّنوا مؤقتًا لكل مستخدم ولكل استعلام كي لا تصل الزيارات المتكررة إلى الـ API.
• اقتصروا في الصفحات على المخططات التي يقرؤها الناس فعلًا.
• انتقلوا إلى تحميل مجدول في BigQuery عندما يزداد الحجم أو عدد المشاهدين.

هل يبقى الموصل خاصًا أم يُنشر في المعرض؟

أبقوه خاصًا إذا كان يقرأ بيانات شركتكم. تؤكد وثائق Google أن الموصل يمكن مشاركته مباشرة مع أي مستخدم، وهذا كل ما يحتاجه فريق تقارير داخلي، كما يجنّبكم عملية مراجعة مصممة للمنتجات العامة.

وانشروه إذا كنتم شركة برمجيات وتريدون أن يعدّ عملاؤكم تقارير عن بياناتكم. ومتطلبات Google لموصلات الشركاء محددة: نشر من نوع Production، ومشاركة صلاحية العرض مع عناوين المراجعة لدى Google، وصفحة مستضافة على نطاقكم الخاص تتضمن سياسة الخصوصية وشروط الاستخدام، وصفحة دعم بدلًا من رابط بريد إلكتروني، وشعار مستضاف تحت سيطرتكم، ونطاقات OAuth صريحة، وإتمام التحقق من عميل OAuth، وموصل مكتمل لا في مرحلة تجريبية. خصصوا وقتًا لهذه المراجعة إضافة إلى وقت البناء.

كم يكلّف موصل Data Studio المخصص؟

البناء هو التكلفة الرئيسية، وتكاليف التشغيل عادةً صغيرة. فلا رسوم ترخيص على Apps Script ضمن الحصص المذكورة أعلاه، وData Studio مجاني للمنشئين والمشاهدين. أما Data Studio Pro، بسعر 9$ لكل مستخدم لكل مشروع شهريًا، فلا يلزم إلا إذا أراد فريقكم مساحات عمل Pro ومحتوى تملكه المؤسسة، لا لاستخدام موصل.

ما يحرّك سعر البناء هو المصدر لا المخططات. فواجهة API بمصادقة بمفتاح وJSON نظيف وتصفية حسب التاريخ مهمة متواضعة. أما OAuth، والتقسيم العميق إلى صفحات، وأسماء الحقول غير المتسقة، والبيانات التاريخية الناقصة، أو حدود المعدل الصارمة، فكل منها يضيف عملًا، ويضيف التقديم إلى المعرض المزيد. وللمقارنة، تضع الأسعار التي تنشرها وكالات مثل halo-lab.com أجر مستشاري Data Studio المستقلين عند نحو 100$ إلى 200$ في الساعة، وإن كان السعر الثابت مقابل نطاق مكتوب أسهل في المقارنة.

أجروا المقارنة بصدق. فإذا كان موصل شركاء يغطي منصتكم بالفعل، فغالبًا ما يكون اشتراكه أرخص من بناء شيفرتكم الخاصة وصيانتها، وسأقول ذلك صراحةً في المراجعة.

أخطاء شائعة، ومتى لا ينبغي بناء موصل مخصص

تشترك معظم مشاريع الموصلات الفاشلة في الأسباب نفسها، وليس أيٌّ منها في الشيفرة. إنها مشكلات في تحديد النطاق والملكية تظهر بعد أشهر، عادةً عندما يغادر أحدهم أو تتغير واجهة API المصدر.

وأحيانًا يكون الجواب الصحيح ألا تبنوا موصلًا أصلًا. فلشركة وساطة تأمين أسترالية كانت تتلقى ملفات .xls غير مرتبة من عدة شركات تأمين، أتمت مشروع قدته في Greenwolf Tech Labs نقل الملفات إلى Google Drive، ومطابقتها في جدول Google Sheets مركزي مع تطبيق قواعد العمل، وتغذية اللوحة من هناك. انخفض وقت إعداد التقارير من 4 إلى 5 ساعات إلى أقل من 5 دقائق، وارتفعت دقة التقارير من نحو 75% إلى 99%. ما كان الموصل ليصلح تلك الملفات؛ أما المسار فأصلحها.

• البناء لمنصة يدعمها موصل شركاء بالفعل.
• جلب الصفوف الخام وتجميعها في Data Studio، مما يستنفد الحصص بسرعة.
• ترك السكربت في الحساب الشخصي لمتعاقد خارجي.
• وضع مفاتيح API في حقول الإعدادات بدلًا من خصائص المستخدم.
• تخطي المطابقة، فلا يثق أحد بالتقرير الأول.
• لا تبنوا موصلًا عندما يكون المصدر ملف تصدير، أو تكون البيانات كبيرة جدًا، أو لن يتولى أحد صيانة الشيفرة بعد الإطلاق.

كيف أعمل على مشاريع الموصلات

تعملون معي مباشرة، من المراجعة الأولى حتى التسليم. أبدأ بقراءة وثائق الـ API لديكم أو ملف تصدير نموذجي والتقارير التي تريدونها، ثم أوصي بأرخص مسار يصمد: موصل شركاء، أو موصل مخصص، أو مسار عبر Sheets أو BigQuery. وتحصلون على عرض سعر ثابت لهذا المسار بعد مراجعة مجانية، مع إدراج تكاليف التشغيل بشكل منفصل.

تكون الشيفرة وعمليات النشر ومصادر البيانات في حساب Google الخاص بكم من اليوم الأول، فلا يعتمد شيء على استمرار مشاركتي. وإذا كان الموصل يغذي لوحة بيانات جديدة، فأبنيها أيضًا، وإذا تعطل تقرير قائم بعد تغيير في المصدر، فيمكنني إصلاحه بدلًا من ذلك.