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

مقدمة

توفِّر واجهة برمجة التطبيقات Linking API واجهة موثوقًا بها لضبط إعدادات المستخدمين وإعادة توجيههم. مباشرةً إلى تقرير Looker Studio من خلال عنوان URL عندما يتّبع المستخدمون واجهة برمجة تطبيقات للربط سيكون لديهم تجربة سلسة للاطّلاع عليها والتفاعل معها بسرعة. بياناتها.

يوضِّح هذا المستند التنسيق المطلوب لعناوين URL الخاصة بواجهة برمجة التطبيقات وروابط. والمعلمات المتوفرة.

حالة الاستخدام والمزايا

يمكن استخدام Reporting API من أجل تقديم تقارير تم إعدادها مسبقًا لعملائك. لعرض بياناتهم والتفاعل معها. في ما يلي المزايا الرئيسية لواجهة برمجة تطبيقات الربط: التالي:

• تجربة إنشاء التقارير بنقرة واحدة لعملائك:
  • يتم توفير إعدادات البيانات في عنوان URL حتى لا يحتاج المستخدمون إلى تكوين التقرير لبياناتهم.
  • يمكن للمستخدمين حفظ التقرير بنقرة واحدة وإعادة زيارة التقرير على في أي وقت.
• إنشاء التقارير على نطاق واسع: تعمل واجهة برمجة التطبيقات Linking API على تقليل الوقت اللازم وتكرارها أو إنشاء تقارير جديدة.
• تفعيل عمليات دمج المنتجات: تسمح لك الواجهة الثابتة دمج Looker Studio في سير عمل المنتج.

آلية العمل

يوضّح ما يلي كيفية تفاعل المطوّرين والمستخدمين مع Linking API.

ربط سير عمل مطوِّر واجهة برمجة التطبيقات

يُعِدّ المطوّر تقارير النموذج ومصادر البيانات وتنسيق عملية الربط. عنوان URL لواجهة برمجة التطبيقات. في ما يلي خطوات سير العمل النموذجية للمطوّرين:

1. حدّد ما إذا كنت تريد استخدام تقرير فارغ أو نموذج التقرير التلقائي المتوفّر من خلال Looker Studio أو إنشاء تقرير Looker Studio القالب. ويشمل ذلك ضبط مصادر بيانات النماذج.
2. يجب تنسيق عنوان URL لواجهة برمجة تطبيقات الربط لحالة الاستخدام المحدّدة. إذا كان ذلك ممكنًا، فقم بتحديد نموذج التقرير والمَعلمات الأخرى، بما في ذلك اسم التقرير وبياناته اسم المصدر وإعدادات مصدر البيانات.
3. استخدِم عنوان URL المرتبط بواجهة برمجة التطبيقات من أجل توجيه المستخدمين إلى التقرير.

ربط تجربة مستخدم واجهة برمجة التطبيقات

يتّبع المستخدم عنوان URL لواجهة برمجة تطبيقات الربط، والذي تم ضبطه بشكلٍ صحيح من خلال مطوِّر البرامج، إلى تقرير Looker Studio الذي يتيح له الاطّلاع على والتفاعل مع البيانات التي يمكنهم الوصول إليها. قد تكون تجربة المستخدم النموذجية مثل التالي:

1. في المتصفّح، يزور المستخدم خدمة تكاملت مع عملية الربط. واجهة برمجة التطبيقات.
2. وتدعو عبارة تحث المستخدم على اتخاذ إجراء المستخدم إلى النقر على رابط لعرض بياناته Looker Studio
3. يتّبع المستخدم الرابط ويتم توجيهه إلى تقرير Looker Studio. تشير رسالة الأشكال البيانية تحميل التقارير ويتمكن المستخدم من عرض بياناته والتفاعل معها.
4. ينقر المستخدم على "تعديل ومشاركة". يتم حفظ التقرير في Looker Studio الحساب.
5. يتمتع المستخدم الآن بإمكانية الوصول الكامل والتحكم في نسخته الخاصة من التقرير. ويمكنهم العرض والتعديل والمشاركة في أي وقت.

المتطلبات

لضمان عمل عنوان URL لواجهة برمجة التطبيقات للربط على النحو المتوقَّع، يجب توفّر ما يلي:

1. تقرير لاستخدامه كنموذج في حال عدم توفيره، يتم تقديم تقرير فارغ أو الذي يوفّره Looker Studio.
2. يجب أن يكون لدى مستخدمي عنوان URL لواجهة برمجة تطبيقات الربط، على الأقل، إذن بالاطّلاع على نموذج تقرير. استنادًا إلى نوع مصادر البيانات المستخدَمة في التقرير والإعدادات المقدّمة من خلال Linking API، قد يطلب المستخدمون أيضًا وعرض الوصول إلى مصادر البيانات. الاطّلاع على أذونات النماذج للحصول على التفاصيل.
3. يجب أن يتيح نوع الموصّل لكل مصدر بيانات إجراء عملية الضبط من خلال واجهة برمجة التطبيقات للربط. يمكنك الرجوع إلى مرجع الموصّل للحصول على قائمة بالسمات المتوافقة موصلات.
4. يجب أن يتمكّن مستخدمو عنوان URL الخاص بواجهة برمجة التطبيقات من الوصول إلى البيانات التي تم ضبطها في ربط عنوان URL لواجهة برمجة التطبيقات. إذا لم يكن لدى المستخدم إذن الوصول إلى البيانات الأساسية عرض أي من مكونات التقارير التابعة لخطأ.

ملاحظة: لا تغيّر واجهة برمجة التطبيقات Linking API إعدادات الوصول الحالية إلى البيانات أو إعدادات المشاركة أو نماذج التقارير الأصلية وإعدادات مصدر البيانات

معلمات عنوان URL

يجب أن يكون عنوان URL لواجهة برمجة التطبيقات للربط بالصيغة التالية:

https://lookerstudio.google.com/reporting/create?parameters

من المتوقع استخدام عنوان URL في سياق متصفح الويب، عادةً بواسطة عندما ينقر المستخدم على رابط أو تتم إعادة توجيهه إلى عنوان URL يمكن أيضًا استخدامها تضمين تقرير

مثال على عنوان URL

في ما يلي مثال على ربط عنوان URL لواجهة برمجة التطبيقات. تم تعيين اسم التقرير تم ضبط مصدر بيانات BigQuery:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.connector=bigQuery
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

ملاحظة: ننصح بترميز المَعلمات باستخدام عنوان URL. للحصول على تفاصيل حول إنشاء عنوان URL صالح، راجِع ترميز عنوان URL.

تكون مَعلمات عناوين URL معيّنة مطلوبة، في حين يكون بعضها اختياريًا. فيما يلي قائمة بالمَعلمات المستخدَمة لتحديد عنوان URL لواجهة برمجة التطبيقات للربط:

معلمات التحكّم

تحدِّد مَعلمات التحكّم حالة التقرير عند عرضه من خلال عملية الربط. عنوان URL لواجهة برمجة التطبيقات.

اسم المعلَمة	الوصف
c.reportId	اختياريّ. رقم تعريف النموذج الخاص بالتقرير سيتم فتح أداة Looker Studio وإعدادها. التقرير المحدد. للحصول على تفاصيل حول كيفية العثور على رقم التعريف، يمكنك الاطّلاع على معرّف البلاغ: في حال عدم تحديد نوع المحتوى هذا، سيكون تقرير فارغ أو استخدام نموذج التقرير الافتراضي، فراجع استخدام فارغة أو تقرير تلقائي لمزيد من التفاصيل.
c.pageId	اختياريّ. رقم تعريف الصفحة الأولية المطلوب تحميلها في التقرير. الإعدادات التلقائية على الصفحة الأولى من التقرير في حال عدم تحديد
c.mode	اختياريّ. وضع التقرير الأولي. أحد view أو edit ويتم ضبط القيمة التلقائية على view في حال عدم تحديدها.
c.explain	اختياريّ. إذن الوصول إلى مربّع حوار المعلومات/تصحيح الأخطاء ضبط على true لإظهار زر مربّع الحوار. الإعدادات التلقائية على false إذا لم يتم تحديده عرض تحديد مشاكل الضبط وحلّها للتعرّف على مزيد من المعلومات

مثال

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &c.pageId=g7u8s9
  &c.mode=edit
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

معلمات التقارير

تلغي مَعلمات التقرير خصائص التقرير.

اسم المعلَمة	الوصف
r.reportName	اختياريّ. لضبط اسم التقرير. إذا لم يتم تحديده، يتم ضبطه تلقائيًا على باسم تقرير القالب.
r.measurementId	اختياريّ. تضبط أرقام تعريف القياس في "إحصاءات Google" على القياس للإبلاغ عن الاستخدام. استخدِم فاصلة لفصل المعرّفات المتعددة. إذا كانت r.measurementId وr.keepMeasurementId غير محدّدة، يوفّر تقرير أرقام تعريف القياس في "إحصاءات Google" القيمة التلقائية على "إلغاء الضبط". إذا r.measurementId و تم ضبط r.keepMeasurementId، r.keepMeasurementId وتكون له الأولوية لضبط المُعرّف.
r.keepMeasurementId	اختياريّ. يجب الضبط على true لاستخدام نموذج التقرير أرقام تعريف القياس في "إحصاءات Google" القيمة التلقائية هي false. إذا لم يتم تحديدها. إذا كانت r.measurementId وr.keepMeasurementId غير محدّدة، يوفّر تقرير أرقام تعريف القياس في "إحصاءات Google" القيمة التلقائية على "إلغاء الضبط". إذا r.measurementId و تم ضبط r.keepMeasurementId، r.keepMeasurementId وتكون له الأولوية لضبط المُعرّف.

مثال

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &r.measurementId=G-XXXXXXXXXX
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

مَعلمات مصدر البيانات

تسمح لك مَعلمات مصدر البيانات بتحديد إعدادات مصدر بيانات البيانات التي يمكن الوصول إليها من مصادر البيانات في تقرير القالب.

يتم استخدام alias للإشارة إلى مصدر بيانات في تقرير حالي. استخدام يسمح الاسم المستعار بالتوافق مع الأنظمة القديمة في حال إضافة مصدر بيانات أو إزالته من تقرير القالب.

لمعرفة تفاصيل عن كيفية العثور على مصدر بيانات alias، يُرجى الاطّلاع على الاسم المستعار لمصدر البيانات.

ملاحظة: إذا كان تقرير النموذج يحتوي على مصدر بيانات واحد، يكون الاسم المستعار لمصدر البيانات. غير مطلوبة بشدة. ومع ذلك، يُوصى بتحديد الاسم المستعار للمساعدة إزالة غموض عمليات ضبط مصدر البيانات عند فحص عنوان URL لواجهة برمجة التطبيقات للربط مصادر البيانات المرتبطة بها

مَعلمات مصدر البيانات

المعلمات التالية شائعة عبر جميع أنواع الموصلات:

الاسم	الوصف
ds.alias.datasourceName	اختياريّ. لضبط اسم مصدر البيانات. إذا ds.datasourceName و لم يتم تحديد ds.keepDatasourceName، اسم مصدر البيانات على اصطلاح تسمية يتضمن نوع الموصل وقت الإنشاء (مثلاً عيّنات - 12/12/21، 10:53 مساءً) في حال حذف ds.datasourceName وds.keepDatasourceName هي معيّنة، تكون الأولوية لـ ds.datasourceName لضبط البيانات. اسم المصدر.
ds.alias.keepDatasourceName	اختياريّ. يجب الضبط على true لاستخدام مصدر بيانات النموذج. الاسم. ويتم ضبط القيمة التلقائية على false في حال عدم تحديدها. إذا ds.datasourceName و لم يتم تحديد ds.keepDatasourceName، اسم مصدر البيانات على اصطلاح تسمية يتضمن نوع الموصل وقت الإنشاء (مثلاً عيّنات - 12/12/21، 10:53 مساءً) في حال حذف ds.datasourceName وds.keepDatasourceName هي معيّنة، تكون الأولوية لـ ds.datasourceName لضبط البيانات. اسم المصدر.
ds.alias.connector	اختياريّ. نوع الموصِّل لمصدر البيانات. لمزيد من المعلومات حول أنواع الموصلات المتوافقة، راجع قسم الموصل المرجع. في حالة الضبط، يصبح كل ما يلي مَعلمات الموصِّل لنوع الموصل سيتم ربط عنوان URL لواجهة برمجة التطبيقات وإعدادات مصدر بيانات النموذج. بالكامل. إذا لم يتم تحديد قيمة، عندها يكون صفرًا أو أكثر مَعلمات الموصل الخاصة بنوع الموصِّل في ربط عنوان URL لواجهة برمجة التطبيقات. سيتم استخدام إعدادات مصدر بيانات النموذج للأغراض التالية: تحديد أي معلمات لم يتم توفيرها في عنوان URL لواجهة برمجة التطبيقات للربط. للحصول على التفاصيل حول كيفية تحديد نوع موصل مصدر بيانات القالب، راجع نوع الموصّل: لمزيد من المعلومات عن كيفية تأثير معلَمة ds.connector ما إذا كان قد تم استبدال إعدادات مصدر بيانات النموذج بالكامل أو استخدامها لتعديل معلَمات غير محدّدة، الاستبدال مقابل التحديث.
ds.alias.refreshFields	اختياريّ. يجب الضبط على true لاستخدام إعدادات مصدر البيانات. المحددة من خلال Reporting API تحديث حقول مصدر البيانات وتعديل عناصر التقرير باستخدام حقل جديد المحددة. true عادةً المحددة عند تبديل نوع الموصل أو لأنواع الموصلات التي يؤدي فيها تغيير التهيئة إلى ظهور حقول مختلفة (على سبيل المثال، غالبًا ما تتغير حقول مصادر بيانات BigQuery من خلال جدول مختلف. الإعدادات). يجب ضبط القيمة على false لمغادرة حقول مصدر البيانات. بدون تغيير من تقرير القالب. false عادةً يتم تحديدها عندما تؤدي تهيئة البيانات الجديدة إلى عرض الحقول نفسها بالضبط وتفضل الإبقاء على أي تغييرات أجريتها على الحقول لمصدر بيانات القالب. في حال عدم تحديد نوع الوصلة، تختلف الإعدادات التلقائية حسب نوع الوصلة. مراجعة مرجع الموصّل الخاص بالموصِّل في حال أردت إلغاء السلوك التلقائي. الاعتبارات الواجب مراعاتها عند استخدام "refreshFields": إذا تم ضبط refreshFields على false إعدادات مصدر البيانات المحدّدة من خلال عمليات الربط التي تؤدي إلى تحقيق واجهة برمجة تطبيقات الحقول المختلفة عن تلك المستخدمة في تقرير النموذج، سوف يظهر على الأرجح خطأ في تهيئة المكونات المتأثرة. التغييرات على الحقول في مصدر بيانات النموذج (مثل الاسم والنوع التجميع وما إلى ذلك) لا تنتقل إلى مصادر بيانات جديدة عندما تمّ ضبط refreshFields على true. ضبط من refreshFields إلى false للحفاظ على الحقل من مصدر بيانات النموذج. الحقول المحسوبة سيتم دائمًا نسخ المَعلمات المحدّدة في مصادر بيانات النموذج. بمصادر البيانات المنشأة حديثًا ولا تتأثر بقيمة refreshFields
ds.alias.connectorParameters	مَعلمة مطلوبة. تسمح إعدادات مصدر البيانات نوع الموصل. للحصول على تفاصيل حول كيفية تحديد الموصل المستخدم لإنشاء مصدر بيانات، راجع نوع الموصّل: للحصول على تفاصيل حول البيانات تتوفر معلمات المصدر لكل نوع موصل، فراجع مرجع الموصّل:

الاستبدال في مقابل التعديل: إعدادات مصدر البيانات

عند تعيين مَعلمات مصدر البيانات، فإن وجود تشير مَعلمة ds.connector في عنوان URL لواجهة برمجة التطبيقات للربط إلى تريد استبدال أو تعديل إعدادات مصدر بيانات النموذج، على التوالي.

يوضح الجدول التالي كيفية تأثير مَعلمة ds.connector في ما إذا كان يتم استبدال إعدادات مصدر بيانات النموذج بالكامل أو استخدامها لتعديل معلمات غير محددة:

هل تم ضبط ds.connector؟	الإعدادات والسلوك المتوقَّعان	معدّل الاستخدام
نعم	استبدال. يتم استبدال إعداد مصدر بيانات النموذج في تمامًا، باستخدام معلمات مصدر البيانات المحددة في رابط عنوان URL لواجهة برمجة التطبيقات. يجب تحديد جميع المعلمات المطلوبة نوع الموصل. راجِع المعلَمات المطلوبة عندما تم ضبط ds.connector.	عند تغيير نوع الموصِّل لمصدر بيانات. مثلاً: إذا كنت ضبطت مصدر بيانات BigQuery في تقرير النموذج ولكنك تريد يمكنك إعداد مصدر بيانات في "جداول بيانات Google" من خلال Reporting API. سيتطلب ذلك تهيئة موصل جديدة ليتم تحديدها بالكامل. عندما تريد ضمان ضبط مصدر بيانات. يؤدي استبدال الإعدادات إلى تجنُّب أي قيم غير معروفة قد تكون غير معروفة يتم استخدامها من مصدر بيانات القالب.
لا	تعديل: سيتم استخدام إعدادات مصدر بيانات النموذج للأغراض التالية: تحديد أي معلمات لم يتم توفيرها في عنوان URL لواجهة برمجة التطبيقات للربط. كل الموصِّلات تكون المعلمات لنوع الموصل اختيارية، ما لم يُذكر خلاف ذلك. يؤدّي ذلك إلى تبسيط عنوان URL الخاص بواجهة برمجة التطبيقات، ويُنصح عادةً باستخدامه عند على دراية بتهيئة مصدر بيانات النموذج ويريدون فقط إلغاء مجموعة فرعية من المعلمات.	عندما تريد فقط تقديم قيم معلَمات تختلف عن وهو مصدر بيانات القالب، ولا بأس في الاعتماد على بيانات القالب مصدر أي معلمات موصل غير محددة. مثلاً: تغيير فقط رقم تعريف مشروع الفوترة لإعداد مصدر بيانات BigQuery واستخدام إعدادات النموذج لجميع المَعلمات الأخرى.

المَعلمات المطلوبة عند ضبط ds.connector

إذا تم تحديد مَعلمة ds.connector لمصدر البيانات، عندها: يجب تحديد جميع مَعلمات الموصِّل المحدّدة على أنّها مطلوبة ومصدرها. إذا كانت مَعلمة ds.connector لمصدر البيانات هي: غير محددة، فإن جميع معلمات الموصل، حتى تلك المعينة على أنها مطلوبة، يمكن اعتبارها اختيارية، ما لم يُنص على خلاف ذلك.

أمثلة

تعمل هذه السياسة على إعداد تقرير باستخدام مصدر بيانات BigQuery واحد (ds0) واستبدال ضبط مصدر البيانات بالكامل:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare

يمكن حذف الاسم المستعار لمصدر البيانات عندما يحتوي التقرير على مصدر بيانات واحد. يمكن تبسيط عنوان URL أعلاه إلى ما يلي:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.datasourceName=MyNewDataSource
  &ds.connector=bigQuery
  &ds.type=TABLE
  &ds.projectId=bigquery-public-data
  &ds.datasetId=samples
  &ds.tableId=shakespeare

تضبط تقريرًا باستخدام مصدر بيانات BigQuery واحد (ds0). يعدّل معرّف مشروع الفوترة فقط مصدر البيانات:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

تحدِّد هذه السياسة تقريرًا يحتوي على مصدرَي بيانات، وهما مصدر بيانات BigQuery (ds0). مصدر بيانات "إحصاءات Google" (ds1). إعدادات مصدر بيانات BigQuery هي بالكامل، بينما تقوم تهيئة Google Analytics بتحديث واحدة وتعتمد على مصدر بيانات نموذج ds1 لأي معلمات موصل غير محددة:

https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &r.reportName=MyNewReportWithMultipleDataSources
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds1.viewId=92320289

الإنشاء مقابل الإضافة

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

1. مصدر البيانات قابل لإعادة الاستخدام (راجع مصادر البيانات المضمّنة في مقابل مصادر البيانات القابلة لإعادة الاستخدام)
2. لا يشير عنوان URL إلى مصدر البيانات باستخدام اسم مستعار
3. لا يستخدم عنوان URL اسمًا مستعارًا بحرف بدل (راجِع حرف البدل البديل لمصدر البيانات).

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

حرف بدل الاسم المستعار لمصدر البيانات

لتطبيق مَعلمة ربط واجهة برمجة التطبيقات على مصادر بيانات متعدّدة، يجب استخدام عنوان البريد الإلكتروني البديل لحرف البدل. يمكن استخدام ds.* بدلاً من العنوان البديل لمصدر البيانات.

ويمكن الاستفادة من ذلك في إزالة المعلمات المتكررة من عنوان URL. بالنسبة على سبيل المثال، إذا كان لديك نموذج مرفق به ثلاثة مصادر بيانات من BigQuery، تريد استبدال projectId وdatasetId في مع الاحتفاظ بقيمة tableId، فيمكنك كتابتها على النحو التالي:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.ds1.projectId=client-project
  &ds.ds1.datasetId=client-dataset
  &ds.ds2.projectId=client-project
  &ds.ds2.datasetId=client-dataset
  &ds.ds3.projectId=client-project
  &ds.ds3.datasetId=client-dataset

أو باستخدام حرف البدل ds.*، يمكنك استخدام عنوان URL المكافئ التالي:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

إنّ المَعلمات التي يتم توفيرها لواجهة برمجة تطبيقات الربط ولا تستخدم حرف البدل ds.* هي: تحظى بالأولوية على غيرها. في المثال أعلاه، يمكنك إضافة الاسم المستعار لمصدر البيانات المحدد لإلغاء القيمة من حرف البدل.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset
  &ds.ds1.datasetId=client-dataset

بشكل أكثر عمومية، يكون ترتيب أولوية المعلمات هو:

1. مَعلمة تم منحها لاسم مستعار محدّد (ds.ds1.datasetId)
2. معلمة تم تقديمها باستخدام حرف البدل (ds.*.datasetId)
3. قيمة مشتقة من مصدر بيانات النموذج، إذا لم يتم توفير ds.connector (راجِع الاستبدال مقابل التحديث)
4. القيمة التلقائية للمَعلمة، إذا كانت اختيارية.

مرجع موصّل

تتيح واجهة برمجة تطبيقات الربط أدوات الربط وعمليات الضبط التالية. لكل منها موصّل البيانات، يتم توفير قائمة مَعلمات مصدر البيانات المتاحة.

BigQuery

يتوافق موصل BigQuery مع نوعين من طلبات البحث، استعلام TABLE، يمكنك توفير معرّف الجدول للاستعلام وCUSTOM_QUERY، حيث تقوم بتقديم عبارة SQL للاستعلام عن جدول.

استعلامات TABLE

يتم تطبيق المَعلمات التالية عند ضبط type على TABLE ويمكنك توفر معرف الجدول للاستعلام.

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على bigQuery في BigQuery . في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ المقدمة من تهيئة BigQuery. عرض الاستبدال مقابل التحديث.
ds.alias.type	مطلوب** نوع طلب البحث. ضبط على TABLE
ds.alias.projectId	مطلوب** رقم تعريف المشروع الوارد في الجدول للاستعلام.
ds.alias.datasetId	مطلوبة** رقم تعريف مجموعة البيانات للجدول طلب البحث.
ds.alias.tableId	مطلوب** رقم تعريف الجدول للجدول الجداول المقسّمة للتواريخ: * (حرف بدل) أو YYYYMMDD مسموح به عند الاستعلام عن الجداول المجزّأة للتاريخ. إذا تم تحديد جدول بوصفه Google "إحصاءات Google" أو Firebase Analytics أو Firebase Crashlytics، حقول تلقائية ما لم يتم تحديد نموذج. يمكنك الاطّلاع على المَعلمات ذات الصلة بجدول نموذج الحقول
ds.alias.billingProjectId	اختياريّ. رقم تعريف المشروع المطلوب استخدامه للفوترة. إذا لم يتم ضبطها، سيتم استخدام projectId.
ds.alias.isPartitioned	اختياريّ. اضبط القيمة على true إذا تم تقسيم الجدول وكنت تريد استخدام عمود التقسيم كسمة للنطاق الزمني. هذا هو ينطبق فقط على التقسيم المستند إلى الوقت (على سبيل المثال، استخدام وقت عمود التقسيم أو العمود الزائف _PARTITIONTIME) و لا يعمل مع الجداول المقسّمة على نطاق أعداد صحيحة. الإعدادات التلقائية على false إذا لم يتم تحديده لمزيد من المعلومات، يُرجى مراجعة مقدّمة عن الجداول المقسَّمة
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

نموذج الحقول لكل من "إحصاءات Google" و"إحصاءات Firebase" وCrashlytics

بالنسبة إلى الجداول المحدّدة على أنّها "إحصاءات Google" أو "إحصاءات Firebase" أو Firebase Crashlytics، تتوفر معلمات إضافية لضبط نموذج الحقول. في حال حذف غير محدد، فسيتم تحديد نموذج افتراضي.

الاسم	الوصف
ds.alias.gaTemplateLevel	اختياريّ. نموذج حقول "إحصاءات Google" المطلوب استخدامه. سارٍ فقط عند طلب البحث عن جدول BigQuery Export في "إحصاءات Google" وَاحِدْ من أصل ALL، SESSION، HITS. لـ Google يتم ضبط جداول "إحصاءات Google" تلقائيًا على ALL في حال عدم تحديد نوعها.
ds.alias.firebaseTemplateLevel	اختياريّ. نموذج حقول "إحصاءات Firebase" المطلوب استخدامه. سارٍ فقط عند طلب البحث عن جدول BigQuery Export for Firebase Analytics يمكن ضبطها على EVENTS فقط. بالنسبة إلى جداول "إحصاءات Firebase": ويتم ضبط القيمة التلقائية على EVENTS في حال عدم تحديده.
ds.alias.crashlyticsTemplateLevel	نموذج حقول Firebase Crashlytics المطلوب استخدامه يمكن ضبطها فقط على DEFAULT لا ينطبق إلا عند إجراء تصدير باستخدام BigQuery لبرنامج Firebase يتم الاستعلام عن جدول Crashlytics. بالنسبة إلى جداول Firebase Crashlytics ويتم ضبط القيمة التلقائية على DEFAULT في حال عدم تحديده.

CUSTOM طلب بحث

يتم تطبيق المَعلمات التالية عند ضبط type على CUSTOM_QUERY تقوم بتقديم عبارة SQL للاستعلام عن جدول.

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على bigQuery في BigQuery . في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ المقدمة من تهيئة BigQuery. عرض الاستبدال مقابل التحديث.
ds.alias.type	مطلوب** نوع طلب البحث. ضبط على CUSTOM_QUERY
ds.alias.sql	مطلوب** طلب SQL المطلوب تنفيذه.
ds.alias.billingProjectId	اختياريّ. رقم تعريف المشروع المطلوب استخدامه للفوترة. إذا لم يتم ضبطها، سيتم استخدام projectId. إذا لم يتم ضبط projectId فسيتم استخدام مشروع الجدول الذي يتم الاستعلام عنه.
ds.alias.sqlReplace	اختياريّ. قائمة بالأنماط وسلاسل الاستبدال مفصولة بفواصل تطبيقها على استعلام SQL. لا يتم تطبيق استبدال السلسلة إلا إذا كان هناك تطابق النمط. استخدم فاصلة لفصل النمط وسلسلة الاستبدال أزواج. مثلاً: stringPattern1,replacementString1, stringPattern2,replacementString2
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

أمثلة

إعداد من النوع TABLE حيث يتم تحديد طلب البحث باستخدام رقم تعريف جدول:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

إعداد من النوع TABLE للاستعلام عن جدول مجزأ بالتاريخ باستخدام حرف البدل لاحقة الحرف:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_*
  

إعداد من النوع TABLE للاستعلام عن جدول تم تقسيمه حسب التاريخ باستخدام YYYYMMDD اللاحقة:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD
  

ضبط من النوع TABLE لطلب البحث في BigQuery Export لخدمة "إحصاءات Google" باستخدام نموذج حقول SESSION:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=my-gabq-project
  &ds.ds0.datasetId=1234567
  &ds.ds0.tableId=ga_sessions_YYYYMMDD
  &ds.ds0.gaTemplateLevel=SESSION
  

إعداد من النوع TABLE لطلب جدول مقسّم لوقت العرض استخدام عمود التقسيم كسمة للنطاق الزمني:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=acme-co-logs
  &ds.ds0.datasetId=logs
  &ds.ds0.tableId=logs_table
  &ds.ds0.isPartitioned=true

إعداد من النوع CUSTOM_QUERY حيث يتم تحديد طلب البحث باستخدام لغة الاستعلامات البنيوية (SQL) العبارة:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=CUSTOM_QUERY
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
  &ds.ds0.billingProjectId=myProject

يشير هذا المصطلح إلى إعدادات من النوع CUSTOM_QUERY يتم فيها تعديل عبارة SQL فقط. يتم استخدام مصدر بيانات النموذج لبقية الإعدادات:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60

إعداد من النوع CUSTOM_QUERY حيث يمكن استخدام عبارة SQL لبيانات النموذج تم تعديل المصدر باستخدام sqlReplace:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset

# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
#   SELECT word, word_count FROM big-query-public-data.samples.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
#   SELECT word, word_count FROM new-project.new-dataset.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM new-project.new-dataset.raleigh

Cloud Spanner

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط على cloudSpanner في سحابة أداة ربط البيانات في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ تم توفير إعداد Cloud Spanner. عرض الاستبدال مقابل التحديث.
ds.alias.projectId	مطلوبة** رقم تعريف المشروع.
ds.alias.instanceId	مطلوب** رقم تعريف المثيل.
ds.alias.databaseId	مطلوب** رقم تعريف قاعدة البيانات.
ds.alias.sql	مطلوب** طلب SQL المطلوب تنفيذه.
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. راجع refreshFields للحصول على التفاصيل.

مثال

ضبط Cloud Spanner باستخدام عبارة SQL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=456def
  &ds.ds1.connector=cloudSpanner
  &ds.ds1.projectId=myProject
  &ds.ds1.instanceId=production
  &ds.ds1.datasetId=transactions
  &ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B

موصِّلات المنتديات

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. الضبط على community للحصول على موصِّل المنتدى: في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ "موصِّل المنتديات" المُقدَّم. التكوين. عرض الاستبدال مقابل التحديث.
ds.alias.connectorId	مطلوب** موصِّل المنتدى connectorId (يُعرف أيضًا باسم deploymentId)
ds.alias.parameters	اختياريّ. المعلمات الإضافية الخاصة بالموصل، كما هو موضح بواسطة موصل المجتمع إعدادات الموصل.
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

مثال

الاتصال بموصِّل أمان من خلال الإعدادات state وcity المَعلمات:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=community
  &ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
  &ds.ds5.state=CA
  &ds.ds5.city=Sacramento

ملاحظة: لا تتطلب المعالجة الخاصة للموصلات التي تستخدم الإعداد المتدرج.

إحصاءات Google

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على googleAnalytics في Google موصِّل "إحصاءات Google" في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ إعدادات "إحصاءات Google" المقدَّمة. عرض الاستبدال مقابل التحديث.
ds.alias.accountId	مطلوب** رقم تعريف الحساب.
ds.alias.propertyId	مطلوب** رقم تعريف الموقع.
ds.alias.viewId	رقم تعريف الملف الشخصي. مطلوب** للحساب العام مواقع "إحصاءات Google". لا يتم ضبطها لمواقع "إحصاءات Google 4".
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على false في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

ملاحظة: تكون إعدادات Universal Analytics (UA) و"إحصاءات Google 4" هي غير متوافق نظرًا لأن لديهم مجموعات مختلفة من السمات والمقاييس. الإعداد إعدادات Universal Analytics لمصدر بيانات تمّ إنشاؤه لموقع على "إحصاءات Google 4" لا يعمل والعكس صحيح. ننصحك بضبط مَعلمة ds.refreshFields على true إذا كنت تريد أن يعمل نموذج التقرير مع أيّ من الموقعَين.

أمثلة

إعداد "إحصاءات Google" لموقع على Universal Analytics:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=UA-54516992-1
  &ds.ds2.viewId=92320289

ضبط "إحصاءات Google" لموقع على "إحصاءات Google 4":

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=213025502

Google Cloud Storage

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. تم الضبط على "googleCloudStorage" Google موصل Cloud Storage في حال ضبط هذه السياسة، سيتم استبدال مصدر البيانات. مع إعدادات Google Cloud Storage المقدَّمة. عرض الاستبدال مقابل التحديث.
ds.alias.pathType	مطلوب** نوع المسار. استخدام يمكنك FILE لاختيار ملف واحد أو FOLDER لاختياره. جميع الملفات للمسار المحدد.
ds.alias.path	مطلوب** مسار الملف (على سبيل المثال، MyBucket/MyData/MyFile.csv) إذا كانت pathType FILE أو مسار المجلد (مثل *MyBucket/MyData) إذا تاريخ pathType هو FOLDER.
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. راجع refreshFields للحصول على التفاصيل.

مثال

إعدادات Google Cloud Storage لملف واحد:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FILE
  &ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv

إعدادات Google Cloud Storage لكل الملفات في المسار:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FOLDER
  &ds.ds50.path=MyBucket%2FMyData

جداول بيانات Google

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على googleSheets في Google موصِّل "جداول بيانات Google". في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ تقديم تهيئة جداول بيانات Google. عرض الاستبدال مقابل التحديث.
ds.alias.spreadsheetId	مطلوبة** رقم تعريف جدول البيانات.
ds.alias.worksheetId	مطلوبة** معرّف ورقة البيانات.
ds.alias.hasHeader	اختياريّ. اضبط القيمة على true لاستخدام الصف الأول كرؤوس. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. يجب أن تكون رؤوس الأعمدة فريدة من نوعها. ولن تتم إضافة الأعمدة التي تحتوي على رؤوس فارغة إلى مصدر البيانات.
ds.alias.includeHiddenCells	اختياريّ. يمكنك الضبط على true لتضمين الخلايا المخفية. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها.
ds.alias.includeFilteredCell	اختياريّ. تم ضبط القيمة على true لتضمين الخلايا التي تمت فلترتها. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها.
ds.alias.range	اختياريّ. نطاق، مثال A1:B52.
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على true في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

أمثلة

تهيئة جداول بيانات Google:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437

تهيئة جداول بيانات Google مع استخدام الصف الأول كرؤوس ومخفية تضمنت الخلايا التي تمت تصفيتها:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.hasHeader=true
  &ds.ds3.includeHiddenCells=true
  &ds.ds3.includeFilteredCells=true

تهيئة "جداول بيانات Google" بنطاق (A1:D20):

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.range=A1%3AD20

Looker

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على looker في موصل Looker في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ تم تقديم تهيئة Looker. عرض الاستبدال مقابل التحديث.
ds.alias.instanceUrl	مطلوب** عنوان URL لنسخة Looker.
ds.alias.model	مطلوبة** نموذج Looker.
ds.alias.explore	مطلوبة** استكشاف Looker.
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على false في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

مثال

الربط بأداة Looker Explore:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=looker
  &ds.ds5.instanceUrl=my.looker.com
  &ds.ds5.model=thelook
  &ds.ds5.explore=orders

Search Console

اسم المعلَمة	الوصف
ds.alias.connector	اختياريّ. ضبط الخيار على searchConsole في شبكة البحث موصِّل وحدة التحكّم في حال ضبط هذه السياسة، يتم استبدال مصدر البيانات بـ تم توفير إعدادات Search Console. عرض الاستبدال مقابل التحديث.
ds.alias.siteUrl	مطلوبة** تشير إلى عنوان URL للموقع الإلكتروني. بالنسبة إلى النطاق السمة، البادئة بـ sc-domain\:.
ds.alias.tableType	مطلوب** لضبط نوع الجدول. يمكن أن يكون واحد من SITE_IMPRESSION أو URL_IMPRESSION.
ds.alias.searchType	مطلوب** لتحديد نوع البحث. يمكن أن يكون واحد من WEB أو IMAGE أو VIDEO أو NEWS
ds.alias.refreshFields	اختياريّ. ويتم ضبط القيمة التلقائية على false في حال عدم تحديدها. عرض يُرجى refreshFields الحصول على التفاصيل.

مثال

إعدادات Search Console لموقع إلكتروني يحمل بادئة عنوان URL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

إعدادات Search Console لموقع إلكتروني على النطاق:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=sc-domain%3Aexample.com
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

أذونات النموذج

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

يوفّر الجدول التالي إمكانية الوصول إلى مصدر البيانات الأمثل تجربة المستخدم استنادًا إلى مصادر بيانات النموذج وLink API التكوين:

نوع مصدر البيانات	ربط ضبط واجهة برمجة التطبيقات لمصدر البيانات	اقتراح بشأن أذونات مصدر البيانات	ملاحظات
مدمجة	استبدال	لا ينطبق - سيتم اكتساب حق الوصول إلى العرض من التقرير.	إذا كان لدى المستخدم الإذن بالاطّلاع على تقرير النموذج، سيتم تلقائيًا الحصول على إذن بالاطّلاع على أي مصدر بيانات مضمَّن
مدمجة	تعديل	لا ينطبق - سيتم اكتساب حق الوصول إلى العرض من التقرير.	إذا كان لدى المستخدم الإذن بالاطّلاع على تقرير النموذج، سيتم تلقائيًا الحصول على إذن بالاطّلاع على أي مصدر بيانات مضمَّن
قابلة لإعادة الاستخدام	استبدال	لا يحتاج المستخدم إلى إذن بالاطّلاع.	بما أنّه يتم استبدال إعدادات مصدر البيانات بالكامل عبر ربط واجهة برمجة التطبيقات، لا يلزم الوصول إلى العرض.
قابلة لإعادة الاستخدام	تعديل	يتطلب المستخدم إذن وصول للعرض.	يجب الحصول على إذن بالاطّلاع على مصدر البيانات من أجل ضبط واجهة برمجة التطبيقات Linking API. من قراءة واستخدام التهيئة من مصدر بيانات القالب. في حال حذف ليس لدى المستخدمين إذن بالاطّلاع، وسيتلقّون رسالة خطأ عند تحميل التقرير.

استخدام تقرير فارغ أو تلقائي

لاستخدام تقرير فارغ أو التقرير التلقائي، عليك ضبط واجهة برمجة التطبيقات Linking API على النحو التالي: التالي:

نوع التقرير	ضبط مَعلمة التحكّم reportId	ضبط معلمات مصدر البيانات (ds)	ملاحظات
تقرير فارغ	لا	لا
التقرير التلقائي	لا	نعم	يتم تقديم التقرير التلقائي من خلال Looker Studio. ليس من الضروري استخدام اسم مستعار لمصدر بيانات عند تحديد معلمات مصدر البيانات للتقرير الافتراضي، نظرًا لأن التقرير الافتراضي يحتوي على مصدر بيانات مضمّن واحد.

نقطة رئيسية: مَعلمات Control، بخلاف reportId، يمكن ضبط مَعلمات Report عند استخدام حقل فارغ أو تلقائي.

تعرض الأمثلة التالية عناوين URL المختلفة لواجهة برمجة التطبيقات للربط بالعناوين التي تستخدم القيم الفارغة أو التلقائية. إبلاغ.

بدء سير عمل إنشاء التقارير باستخدام تقرير فارغ:

https://lookerstudio.google.com/reporting/create

بدء سير عمل إنشاء التقارير من خلال تقرير فارغ وإعداد التقرير الاسم:

https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport

استخدِم نموذج التقرير التلقائي مع إعداد موصِّل "جداول بيانات Google":

https://lookerstudio.google.com/reporting/create?
  ds.connector=googleSheets
  &ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
  &ds.worksheetId=0

تضمين تقرير

لتضمين تقرير تم إنشاؤه باستخدام واجهة برمجة تطبيقات الربط، اضبط معلمات عنوان URL وتتضمن المسار /embed/. واجهة برمجة تطبيقات للربط يجب أن يكون عنوان URL المضمّن بالصيغة التالية:

https://lookerstudio.google.com/embed/reporting/create?parameters

البحث عن أرقام التعريف والأسماء المستعارة

معرّف التقرير

للعثور على رقم تعريف التقرير:

1. افتح التقرير الذي تريد استخدامه كنموذج. يجب فحص عنوان URL إبلاغ. الجزء بين reporting/ و/page هو رقم تعريف التقرير. بالنسبة على سبيل المثال، في عنوان URL التالي، يمثل 0B_U5RNpwhcE6SF85TENURnc4UjA التقرير المعرِّف:

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

ابحث عن رقم تعريف التقرير في عنوان URL الخاص بالتقرير.

الاسم المستعار لمصدر البيانات

يمكن أن يكون للتقرير عدة مصادر بيانات. يجب الإشارة إلى مصدر البيانات عن طريق والاسم المستعار لها.

للعثور على اسم مستعار لمصدر بيانات:

1. عدِّل التقرير.
2. من شريط الأدوات، حدد المورد > إدارة مصادر البيانات المُضافة
3. تحقَّق من عمود الاسم المستعار للعثور على معلومات الاسم المستعار لكل مصدر بيانات.

يمكنك تعديل أسماء الأسماء المستعارة لضمان التوافق مع الأنظمة القديمة عندما يكون مصدر البيانات تمت إضافتها أو إزالتها.

العثور على الاسم المستعار لمصدر البيانات في إدارة مصادر البيانات

نوع الموصّل

يمكن أن يحتوي التقرير على عدّة مصادر بيانات، يتم إنشاء كلّ منها عن طريق ضبط وصلة البيانات. للعثور على نوع الموصِّل المستخدَم لإنشاء مصدر بيانات:

1. عدِّل التقرير.
2. من شريط الأدوات، حدد المورد > إدارة مصادر البيانات المُضافة
3. افحص عمود نوع الموصّل لتحديد الموصل المستخدم في إنشاء مصدر بيانات.

ابحث عن نوع موصل مصدر البيانات في مصادر البيانات. إدارة الحساب.

تحديد المشاكل وحلّها ونصائح ذات صلة

إذا واجهت مشكلة، راجِع التفاصيل أدناه لتحديد المشاكل المحتملة. والتهيئات الخاطئة الشائعة.

مربّع حوار تصحيح الأخطاء

استخدِم مربّع حوار تصحيح الأخطاء لمراجعة ضبط واجهة برمجة تطبيقات الربط كما تمّ تفسيره من خلال Looker Studio يمكن أن يساعد ذلك في تصحيح أخطاء واجهة برمجة التطبيقات.

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

  

• إذا لم يتوفر زر معلومات، يمكنك تفعيله من خلال إلحاق المَعلمة &c.explain=true بنهاية أي عنوان URL لواجهة برمجة التطبيقات للربط.

الأذونات

تأكَّد من ضبط أذونات النماذج الصحيحة لأنواع مصادر البيانات. وربط واجهة برمجة التطبيقات. الاطّلاع على أذونات النماذج للحصول على التفاصيل.

التحديث مقابل الاستبدال

في حال تعديل إعدادات مصدر بيانات من نموذج مصدر بيانات، راجِع إعدادات مصدر بيانات النموذج وإعدادات واجهة برمجة التطبيقات الربط لضمان فإنهما متوافقان. تأكَّد من أنّ الحقول الناتجة من الإعدادات الجديدة متوافقة مع مكونات التقرير وتهيئته.

عند إجراء تحديث مقابل استبدال، من الممكن تعيين قيمة غير صالحة التكوين بسلوك غير محدد. عرض الاستبدال مقابل التحديث لمعرفة التفاصيل.

إعادة تحميل الحقول

في حال ضبط أسماء حقول أو أنواع أو تجميعات لبيانات نموذج لن يتم تطبيق هذه التغييرات إلا على البيانات التي تم إعدادها لواجهة برمجة تطبيقات الربط. المصدر إذا تم ضبط المَعلمة ds.refreshFields على false

راجِع مَعلمة مصدر البيانات ds.refreshFields الخاصة ربط عنوان URL لواجهة برمجة التطبيقات. إذا تم حذفها، فتأكد من أن القيمة الافتراضية لمعلمة يكون كل نوع موصل صحيحًا لحالة الاستخدام لديك.

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

على سبيل المثال، إذا كانت أداة Looker Studio أثناء إنشاء نموذج تقرير، حقلاً لمصدر بيانات معيّنًا من النوع Number ويمكنك تغييره إلى النوع السنة، أصبح تغيير ضبط الحقل هذا جزءًا من بيانات النموذج المصدر. أي رسم بياني في نموذج التقرير يستخدم الحقل المصحَّح نتوقع قيمة السنة وإذا كان الرسم البياني يستند إلى الوقت، قد لا يتم عرضه بطريقة أخرى. في حال حذف يتم استخدام واجهة برمجة تطبيقات الربط لتوفير إعدادات مصدر بيانات جديدة تحقّق الحقول نفسها بالضبط، تكون هناك نتيجتان بناءً على قيمة مَعلمة refreshFields:

• في حال ضبط هذه السياسة على true، سيتم ضبط إعدادات الحقل من مصدر بيانات النموذج على ما يلي: عدم ترحيل البيانات، وقد يتعذّر تحميل الرسوم البيانية إذا كانت تعتمد في إعدادات الحقل نفسها (أي يُتوقَّع توفّر حقل من النوع Year).

• في حال ضبط هذه السياسة على false، سيتم ضبط الحقل من مصدر بيانات النموذج. البيانات إلى مصدر البيانات الجديد، وستتلقّى الرسوم البيانية للتقارير نفس الحقول بنفس التكوين والتحميل بنجاح.

نقطة رئيسية: الحقول المحسوبة والمَعلمات المحدَّدة في مصادر بيانات النماذج يتم نقلها دائمًا إلى مصادر البيانات المنشأة حديثًا ولا تتأثر بقيمة refreshFields.

الملاحظات والدعم

استخدِم أداة تتبُّع المشاكل للإبلاغ عن مشاكل مرتبطة بواجهة برمجة التطبيقات أو لتقديم ملاحظات. عرض الدعم للمراجع العامة حول الحصول على المساعدة وطرح الأسئلة.

سجلّ التغييرات

2023-06-06

• تمت إضافة r.measurementId و مَعلمات التقرير المطلوب ضبطها r.keepMeasurementId إعداد تقرير أرقام تعريف القياس في "إحصاءات Google"
• تمت إضافة ds.keepDatasourceName للتحكّم في إعادة استخدام اسم مصدر بيانات القالب.
• تمت إضافة قسم تضمين التقرير.
• موصِّل BigQuery
  • تمت إضافة sqlReplace. يتيح لك تحديد نمط وسلاسل بديلة لتعديل استعلام SQL (لغة الاستعلام البنيوية) للنموذج ومصدرها.

2023-05-22

• تمت إضافة دعم لموصِّل Looker.
• تمت إضافة دعم موصِّلات المنتدى.

2022-11-21

• تمت إضافة إمكانية استخدام تقرير فارغ. عرض استخدام تقرير فارغ أو تلقائي
• تمت إضافة قسم "refreshFields" إلى نصائح و تحديد المشاكل وحلّها.

2022-11-14

• تمت إزالة مرجع موصِّل "استطلاعات Google" بسبب إيقاف "استطلاعات Google".

2022-06-15

• انتهاء الفترة التجريبية
  • تمت إعادة تسمية واجهة برمجة التطبيقات Integration API لتصبح Linking API.
  • لم تنتهِ ميزة ربط واجهة برمجة التطبيقات مرحلة تجريبية.
• تمت إضافة مَعلمة التحكّم pageId للسماح بالربط بتقرير معيّن. .
• تمت إضافة مَعلمة التحكّم mode لضبط حالة التقرير على View أو وضع التعديل عند التحميل.
• يمكن الآن استبدال إعدادات مصادر البيانات كليًا أو جزئيًا تحديث. يتم تحديد هذا السلوك من خلال ما إذا كان تم ضبط المَعلمة ds.connector. راجِع الاستبدال مقابل التحديث. لمزيد من التفاصيل.
• يتم الآن استخدام نموذج تلقائي إذا لم يتم توفير نموذج تقرير يستخدم مَعلمة c.reportId.
• تمت إضافة معلَمة مصدر البيانات ds.refreshFields. يتيح لك ذلك التحكّم في إعادة تحميل حقول مصدر البيانات عند تحميل مصدر بيانات التكوين.
• موصِّل BigQuery
  • السمة projectId غير مطلوبة عند ضبط السمة type على CUSTOM_QUERY.
  • في حال ترك billingProjectId بدون ضبط، سيتم تنفيذ ما يلي من خلال مشروع الفوترة: العودة إلى projectId أو مشروع الجدول المطلوب البحث عنه
  • تمت إضافة إمكانية استخدام الجداول المقسَّمة حسب التاريخ. ضبط isPartitioned إلى true لاستخدام حقل القسم كنطاق زمني البعد.
  • تمت إضافة إمكانية إجراء طلبات بحث في الجداول المقسَّمة حسب التاريخ باستخدام حرف البدل. حرف أو لاحقة جدول YYYYMMDD.
  • تم توفير إمكانية إجراء طلبات بحث في "إحصاءات Google" أو Firebase Analytics جداول Crashlytics واختيار نموذج حقول
• جداول بيانات Google
  • يتم ضبط hasHeader تلقائيًا على true، بما يتوافق مع الإعدادات التلقائية لواجهة مستخدم الويب.
  • تم تقسيم includeHiddenAndFilteredCell إلى includeHiddenCells و
  • includeFilteredCells يتم الآن ضبط الإعداد التلقائي على true، بما يتوافق مع الإعداد التلقائي لواجهة مستخدم الويب.
• أداة ربط البيانات في Search Console
  • تمت إعادة تسمية المعلَمة propertyType إلى searchType.
• أداة ربط الاستطلاعات
  • يقبل surveyId الآن رقم تعريف واحدًا للاستطلاع أو قائمة مفصولة بفواصل من معرّفات الاستبيانات.

2021-12-16

• الإصدار الأولي من Integration API
  • يتيح الربط بتقرير حالي وضبط اسم التقرير.
  • يمكن ضبط مصادر بيانات متعدّدة ويمكن إعداد كل اسم لمصدر بيانات. تعيين.
  • دعم أنواع الموصلات التالية: BigQuery، وCloud Spanner، "إحصاءات Google" وGoogle Cloud Storage و"جداول بيانات Google" و"استطلاعات Google" Search Console.