Views (Profiles): update

نیاز به مجوز دارد

یک نمای (نمایه) موجود را به روز می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.

درخواست

درخواست HTTP

PUT 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 را در بدنه پاسخ برمی گرداند.

مثال ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه سرویس گیرنده جاوا استفاده می کند.

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


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

// Construct the body of the request.
Profile body = new Profile();
body.setName("Example Store");
body.setECommerceTracking(true);
body.setEnhancedECommerceTracking(true);
body.setCurrency("USD");
body.setTimezone("America/Chicago");
body.setWebsiteUrl("http://www.examplepetstore.com");

try {
  analytics.management().profiles().update("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 updates 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->update('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();
}

پایتون

از کتابخانه کلاینت پایتون استفاده می کند.

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

# This request updates an existing View (Profile).
try:
  analytics.management().profiles().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      body={
          'name': 'eCommerce Tracking View (Profile)',
          'eCommerceTracking': True,
          'enhancedECommerceTracking': True,
          'currency': 'USD',
          'timezone': 'America/Chicago',
          'websiteUrl': 'http://www.examplepetstore.com'
      }
  ).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))

جاوا اسکریپت

از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.

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

/*
 * This request updates an existing view (profile).
 */
function updateView() {
  var request = gapi.client.analytics.management.profiles.update(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'resource': {
        'name': 'eCommerce Tracking View (Profile)',
        'currency': 'USD',
        'eCommerceTracking': true,
        'websiteUrl': 'http://www.example.com'
      }
    });
  request.execute(function (response) { // Handle the response. });
}

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.