Unsampled Reports: insert

يجب تقديم تفويض

إنشاء تقرير جديد غير مستند إلى عينات. اطّلِع على مثال.

الطلب

طلب HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
accountId string رقم تعريف الحساب لإنشاء تقرير غير مستند إلى عينات له.
profileId string رقم تعريف الملف الشخصي (الملف الشخصي) لإنشاء تقرير غير مستند إلى عينات له.
webPropertyId string رقم تعريف الموقع الإلكتروني لإنشاء تقرير غير مستند إلى عينات له.

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

نص الطلب

في نص الطلب، أدخِل management.unsampledReport بالسمات التالية:

اسم الموقع القيمة الوصف Notes
الخصائص المطلوبة
end-date string تاريخ انتهاء التقرير غير المستند إلى عينات. قابل للكتابة
metrics string مقاييس التقرير غير المستند إلى عينات. قابل للكتابة
start-date string تاريخ بدء التقرير غير المستند إلى عينات. قابل للكتابة
title string عنوان التقرير غير المستند إلى عينات. قابل للكتابة
الخصائص الاختيارية
dimensions string سمات التقرير غير المستند إلى عينات. قابل للكتابة
filters string فلاتر التقرير غير المستند إلى عينات. قابل للكتابة
segment string شريحة التقرير غير المستند إلى عينات. قابل للكتابة

الإجابة

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

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

تستخدم مكتبة عميل Java.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Unsampled Reports Developer Guide for details.
 */

/*
 * This example creates a new unsampled report.
 */
UnsampledReport body = new UnsampledReport();
body.setTitle("A test report");
body.setStartDate("2013-01-01");
body.setEndDate("2013-03-31");
body.setMetrics("ga:pageviews,ga:bounces");
body.setDimensions("ga:browser");
body.setFilters("ga:bounces>=100");
body.setSegment("gaid:-1");
try {
  analytics.management().unsampledReports().insert("123456",
      "UA-123456-1",
      "7654321",
      body
      ).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

PHP

لاستخدام مكتبة برامج PHP.

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Unsampled Reports Developer Guide for details.
 */

/**
 * This request creates a new Unsampled Report.
 */

// Construct an unsampled report object.
$unsampledReport = new Google_Service_Analytics_UnsampledReport();
$unsampledReport->setTitle('A test report');
$unsampledReport['start-date'] = '2013-01-01';
$unsampledReport['end-date'] = '2013-03-31';
$unsampledReport->setMetrics('ga:pageviews,ga:bounces');
$unsampledReport->setDimensions('ga:browser');
$unsampledReport->setFilters('ga:bounces>=100');
$unsampledReport->setSegment('gaid:-1');

try {
  $analytics->management_unsampledReports->insert('123456', 'UA-123456-1',
      '7654321', $unsampledReport);

} catch (apiServiceException $e) {
  print 'There was an Analytics API service error '
      . $e->getCode() . ':' . $e->getMessage();

} catch (apiException $e) {
  print 'There was a general API error '
      . $e->getCode() . ':' . $e->getMessage();
}

Python

تستخدم مكتبة برامج Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the Unsampled Reports Developer Guide for details.


# This request creates an new unsampled report.
try:
  reports = analytics.management().unsampledReports().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      body={
          'title': 'A test Report',
          'start-date': '2013-01-01',
          'end-date': '2013-01-31',
          'metrics': 'ga:pageviews,ga:bounces',
          'dimensions': 'ga:browser',
          'filters': 'ga:bounces>=100',
          'segment': 'gaid::-1'
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

JavaScript

تستخدم مكتبة عميل JavaScript.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Unsampled Reports Developer Guide for details.
 */

/*
 * This request creates an new unsampled report.
 */
function insertView() {
  var request = gapi.client.analytics.management.unsampledReports.insert(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'resource': {
        'title': 'A test Report',
        'start-date': '2013-01-01',
        'end-date': '2013-01-31',
        'metrics': 'ga:pageviews,ga:bounces',
        'dimensions': 'ga:browser',
        'filters': 'ga:bounces>=100',
        'segment': 'gaid::-1'
      }
    });
  request.execute(function (response) { /* Handle the response. */ });
}