Uploads: get

נדרשת הרשאה

הצגת רשימה של העלאות שהמשתמש יכול לגשת אליהן. אפשר לנסות עכשיו או לראות דוגמה.

בנוסף לפרמטרים הרגילים, השיטה הזו תומכת בפרמטרים שמפורטים בטבלת הפרמטרים.

בקשה

בקשת HTTP

GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId

פרמטרים

שם הפרמטר Value התיאור
פרמטרים של נתיב
accountId string מספר החשבון שאליו רוצים לאחזר את ההעלאה.
customDataSourceId string מזהה של מקור נתונים מותאם אישית להעלאה.
uploadId string העלאת מזהה לאחזור.
webPropertyId string מזהה נכס אינטרנט להעלאה לאחזור.

הרשאות

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

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

גוף הבקשה

אל תספקו גוף הבקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב של העלאות בגוף התגובה.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

Java

משתמש בספריית הלקוח של Java.

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


// This request gets an upload for the authorized user.
try {
  analytics.management().uploads().get("123456", "UA-123456-1",
      "122333444455555", "ABBCCCDDDDEEEEE").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 Data Import Developer Guide for details.
 */

// This request gets an upload for the authorized user.
try {
  $uploads = $analytics->management_uploads->get('123456', 'UA-123456-1',
      '122333444455555', 'ABBCCCDDDDEEEEE');

} 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 Data Import Developer Guide for details.

# This request gets an upload object with a particular uploadId.
try:
  upload = analytics.management().uploads().get(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customDataSourceId='abcdefg1234567',
      uploadId='AAABBBCCCDDD111222'
  ).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 Data Import Developer Guide for details.
 */

/*
 * This request gets an existing upload.
 */
function getUpload() {
  var request = gapi.client.analytics.management.uploads.get({
    'accountId': '123456',
    'webPropertyId': 'UA-123456-1',
    'customDataSourceId': 'ABCDEFG123abcDEF123',
    'uploadId': 'AAABBBCCCDDD111222'
  });
  request.execute(function (response) { // Handle the response. });
}

רוצה לנסות?

ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה. אפשר גם לנסות את הכלי העצמאי Explorer.