Views (Profiles): patch

נדרשת הרשאה

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

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

בקשה

בקשת HTTP

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

פרמטרים

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

אישור

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

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

גוף הבקשה

בגוף הבקשה, מספקים את החלקים הרלוונטיים של משאבmanagement.profile בהתאם לכללי הסמנטיקה של התיקונים.

תשובה

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

דוגמאות

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

Java

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

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the View (Profile) Developer Guide for details.
 */


/*
 * This request patches an existing View (Profile).
 */

// Construct the body of the request.
Profile body = new Profile();
body.setECommerceTracking(true);
body.setEnhancedECommerceTracking(true);
body.setTimezone("America/Chicago");

try {
  analytics.management().profiles().patch("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 View (Profile) Dev Guide for details.
 */

/**
 * This request patches an existing view (profile).
 */

// Construct the body of the request.
$profile = new Google_Service_Analytics_Profile();
$profile->setName('eCommerce View');
$profile->setECommerceTracking(True);
$profile->setEnhancedECommerceTracking(True);

try {
  $analytics->management_profiles->patch('123456', 'UA-123456-1',
      '7654321', $profile);

} 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 View (Profile) Developer Guide for details.

# This request patches an existing View (Profile).
try:
  analytics.management().profiles().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      body={
          'eCommerceTracking': True,
          'enhancedECommerceTracking': True,
          'timezone': 'America/Chicago'
      }
  ).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 View (Profiles) Developer Guide for details.
 */

/*
 * This request patches an existing view (profile).
 */
function patchView() {
  var request = gapi.client.analytics.management.profiles.patch(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'resource': {
        'eCommerceTracking': true,
        'timezone': 'America/Chicago'
      }
    });
  request.execute(function (response) { // Handle the response. });
}

רוצה לנסות?

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