Uploads: deleteUploadData

נדרשת הרשאה

מחיקת הנתונים שמשויכים להעלאה קודמת. אפשר לנסות עכשיו או לראות דוגמה.

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

בקשה

בקשת HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData

פרמטרים

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

אישור

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

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

גוף הבקשה

בגוף הבקשה, מספקים נתונים במבנה הבא:

{
  "customDataImportUids": [
    string
  ]
}

שם הנכס	ערך	תיאור	הערות
customDataImportUids[]	list	רשימה של מזהי UID (מזהה ייחודי) שהועלו.

תשובה

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

דוגמאות

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

Java

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

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


// Construct a list of file ids to delete.
List<String> filesToDelete = Arrays.asList("ZYXABC123zyxabc",
    "lmnopEFGXYZ123a", "999AAA888bbb777");

// Construct the body of the Delete Request and set the file ids.
AnalyticsDataimportDeleteUploadDataRequest body = new
    AnalyticsDataimportDeleteUploadDataRequest();
body.setCustomDataImportUids(filesToDelete);

// This request deletes three uploaded files for the authorized user.
try {
  analytics.management().uploads().deleteUploadData("123456",
      "UA-123456-1", "122333444455555", 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 Data Import Developer Guide for details.
 */

// Construct a list of upload ids to delete.
$uploadIds = array('ABBCCCDDDDEEEEE');

// Construct the body of the Delete Request and set the upload ids.
$body = new
    Google_Service_Analytics_AnalyticsDataimportDeleteUploadDataRequest();
$body->setCustomDataImportUids($uploadIds);

// This request deletes the uploads.
try {
  $uploads = $analytics->management_uploads->deleteUploadData('123456',
      'UA-123456-1', '122333444455555', $body);

} 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 deletes a list of uploads.
try:
  analytics.management().uploads().deleteUploadData(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customDataSourceId='ABCDEFG123456abcdefg',
      body={
          'customDataImportUids': ['ZYXABC123zyxabc',
                                   'lmnopEFGXYZ123a',
                                   '999AAA888bbb777']
      }
  ).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 deletes a list of existing uploads.
 */
function deleteUploads() {
  var request = gapi.client.analytics.management.uploads.deleteUploadData({
    'accountId': '123456',
    'webPropertyId': 'UA-123456-1',
    'customDataSourceId': 'ABCDEFG123abcDEF123',
    'resource': {
      'customDataImportUids': ['AAABBBCCCDDD111222',
                               'xLh4wXtzQT6uxe-_OWelog']
    }
  });
  request.execute(function (response) { // Handle the response. });
}

רוצה לנסות?

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