Custom Dimensions: patch

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

یک بعد سفارشی موجود را به روز می کند. این روش از معنای پچ پشتیبانی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

درخواست

درخواست HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId

مولفه های

نام پارامتر	ارزش	شرح
پارامترهای مسیر
`accountId`	`string`	شناسه حساب برای بعد سفارشی برای به‌روزرسانی.
`customDimensionId`	`string`	شناسه ابعاد سفارشی برای بروزرسانی بعد سفارشی.
`webPropertyId`	`string`	شناسه دارایی وب برای بعد سفارشی برای به روز رسانی.
پارامترهای پرس و جو اختیاری
`ignoreCustomDataSourceLinks`	`boolean`	به روز رسانی را اجباری کنید و هر گونه هشدار مربوط به بعد سفارشی را که به منبع داده / مجموعه داده سفارشی مرتبط است نادیده بگیرید. (پیش‌فرض: `false` )

مجوز

این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
`https://www.googleapis.com/auth/analytics.edit`

درخواست بدن

در بدنه درخواست، بخش‌های مربوطه از یک منبع management.customDimension را مطابق با قوانین معناشناسی وصله‌ها عرضه کنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع management.customDimension را در بدنه پاسخ برمی گرداند.

مثال ها

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

جاوا

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

/*
 * Note: This code assumes you have an authorized Analytics service object.
 */

/*
 * This request patches an existing custom dimension.
 */

// Construct the body of the request and set its properties.
CustomDimension body = new CustomDimension();
body.setName("Campaign Group");
body.setScope("SESSION");
body.setActive(true);

try {
  analytics.management().customDimensions()
      .patch("123456", "UA-123456-1", "ga:dimension2", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

پایتون

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

# Note: This code assumes you have an authorized Analytics service object.

# This request patches an existing custom dimension.
try:
  analytics.management().customDimensions().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customDimensionId='ga:dimension2',
      body={
          'name': 'Campaign Group',
          'scope': 'SESSION',
          'active': True
      }
  ).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))

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

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