Unsampled Reports: insert

נדרשת הרשאה

יוצרים דוח חדש ללא דגימה. צפייה בהדגמה

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר Value התיאור
פרמטרים של נתיב
accountId string מספר החשבון שעבורו יש ליצור את הדוח ללא דגימה.
profileId string מזהה התצוגה המפורטת (פרופיל) שעבורו יש ליצור את הדוח שמבוסס על כל הנתונים.
webPropertyId string מזהה נכס אינטרנט שעבורו יש ליצור את הדוח ללא דגימה.

הרשאות

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (למידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

גוף הבקשה

בגוף הבקשה, מספקים משאב Management.unsampledReport עם המאפיינים הבאים:

שם הנכס Value התיאור הערות
מאפיינים נדרשים
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. */ });
}