مرحبًا بالإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google"، وبدء استخدام JavaScript سريعًا لتطبيقات الويب

يوضّح هذا البرنامج التعليمي الخطوات المطلوبة للوصول إلى الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google".

1- تفعيل واجهة برمجة التطبيقات

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

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

إنشاء بيانات اعتماد

  • افتح صفحة بيانات الاعتماد.
  • انقر على إنشاء بيانات اعتماد ثم اختر معرِّف عميل OAuth.
  • بالنسبة إلى نوع التطبيق، اختَر تطبيق الويب.
  • أدخِل اسم معرّف العميل للبدء وانقر على إنشاء.
  • ضبط مصادر JavaScript المعتمَدة على http://localhost:8080
  • انقر على إنشاء.

2. إعداد النموذج

ستحتاج إلى إنشاء اسم ملف واحد (HelloAnalytics.html) يحتوي على رمز HTML ورمز JavaScript للمثال.

  • انسخ رمز المصدر التالي أو نزِّله إلى HelloAnalytics.html.
  • استبدل <REPLACE_WITH_CLIENT_ID> بمعرِّف العميل الذي تم إنشاؤه أعلاه.
  • استبدِل <REPLACE_WITH_VIEW_ID> برقم تعريف ملف شخصي. يمكن استرداد معرّف ملف شخصي من مستكشف الحسابات.
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Hello Analytics Reporting API V4</title>
  <meta name="google-signin-client_id" content="<REPLACE_WITH_CLIENT_ID>">
  <meta name="google-signin-scope" content="https://www.googleapis.com/auth/analytics.readonly">
</head>
<body>

<h1>Hello Analytics Reporting API V4</h1>

<!-- The Sign-in button. This will run `queryReports()` on success. -->
<p class="g-signin2" data-onsuccess="queryReports"></p>

<!-- The API response will be printed here. -->
<textarea cols="80" rows="20" id="query-output"></textarea>

<script>
  // Replace with your view ID.
  var VIEW_ID = '<REPLACE_WITH_VIEW_ID>';

  // Query the API and print the results to the page.
  function queryReports() {
    gapi.client.request({
      path: '/v4/reports:batchGet',
      root: 'https://analyticsreporting.googleapis.com/',
      method: 'POST',
      body: {
        reportRequests: [
          {
            viewId: VIEW_ID,
            dateRanges: [
              {
                startDate: '7daysAgo',
                endDate: 'today'
              }
            ],
            metrics: [
              {
                expression: 'ga:sessions'
              }
            ]
          }
        ]
      }
    }).then(displayResults, console.error.bind(console));
  }

  function displayResults(response) {
    var formattedJson = JSON.stringify(response.result, null, 2);
    document.getElementById('query-output').value = formattedJson;
  }
</script>

<!-- Load the JavaScript API client and Sign-in library. -->
<script src="https://apis.google.com/js/client:platform.js"></script>

</body>
</html>

3: تشغيل النموذج

  • انشر HelloAnalytics.html على خادم الويب وحمِّل الصفحة في متصفحك.
  • انقر على زر تسجيل الدخول وامنح حق الوصول إلى "إحصاءات Google".

عند الانتهاء من هذه الخطوات، ينتج عن النموذج عدد الجلسات لآخر سبعة أيام في طريقة العرض المحددة.