Hello Analytics Reporting API v4; شروع سریع جاوا اسکریپت برای برنامه های کاربردی وب

این آموزش مراحل لازم برای دسترسی به Analytics Reporting API v4 را طی می کند.

1. API را فعال کنید

برای شروع استفاده از Analytics Reporting API v4، ابتدا باید از ابزار setup استفاده کنید که شما را از طریق ایجاد پروژه در Google API Console، فعال کردن API و ایجاد اعتبارنامه راهنمایی می‌کند.

توجه: برای ایجاد شناسه سرویس گیرنده وب یا سرویس گیرنده برنامه نصب شده، باید نام محصول را در صفحه رضایت تنظیم کنید. اگر قبلاً این کار را انجام نداده اید، از شما خواسته می شود صفحه رضایت را پیکربندی کنید .

اعتبارنامه ایجاد کنید

  • صفحه اعتبارنامه را باز کنید.
  • روی Create credentials کلیک کنید و OAuth Client ID را انتخاب کنید
  • برای نوع Application Web application را انتخاب کنید.
  • نام Quickstart را به شناسه مشتری بگذارید و روی ایجاد کلیک کنید.
  • مبداهای مجاز جاوا اسکریپت را روی http://localhost:8080 تنظیم کنید
  • روی ایجاد کلیک کنید.

2. نمونه را راه اندازی کنید

شما باید یک نام فایل HelloAnalytics.html ایجاد کنید که حاوی کد HTML و جاوا اسکریپت برای مثال ما باشد.

  • کد منبع زیر را در HelloAnalytics.html کپی یا دانلود کنید .
  • شناسه مشتری خود را که در بالا ایجاد شده است جایگزین <REPLACE_WITH_CLIENT_ID> کنید.
  • <REPLACE_WITH_VIEW_ID> را با شناسه نمای جایگزین کنید. شناسه view را می توان از Account Explorer بازیابی کرد.
<!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 Analytics را بدهید.

وقتی این مراحل را تمام کردید، نمونه تعداد جلسات هفت روز گذشته را برای نمای داده شده خروجی می دهد.