يرشدك هذا الدليل التعليمي إلى الخطوات المطلوبة للوصول إلى الإصدار 4 من Analytics Reporting API.
1- تفعيل واجهة برمجة التطبيقات
لبدء استخدام الإصدار 4 من Analytics Reporting API، عليك أولاً استخدام أداة الإعداد التي ترشدك خلال إنشاء مشروع في وحدة التحكم في Google API وتفعيل واجهة برمجة التطبيقات وإنشاء بيانات الاعتماد.
ملاحظة: لإنشاء معرِّف عميل ويب أو عميل تطبيق مثبَّت، عليك تحديد اسم منتج في شاشة الموافقة. إذا لم يسبق لك إجراء ذلك، سيُطلب منك ضبط شاشة طلب الموافقة.إنشاء بيانات اعتماد
- افتح صفحة بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد واختَر معرِّف عميل OAuth.
- في حقل نوع التطبيق، اختَر تطبيق الويب.
- أدخِل اسمًا quickstart لمعرِّف العميل وانقر على quickstart.
- ضبط مصادر 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".
عند الانتهاء من هذه الخطوات، يقوم النموذج بإخراج عدد الجلسات الخاصة بآخر سبعة أيام للعرض المحدد.