نیاز به مجوز دارد
یک سنجه سفارشی موجود را به روز می کند. این روش از معنای پچ پشتیبانی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حساب برای سنجه سفارشی برای بهروزرسانی. |
customMetricId | string | شناسه متریک سفارشی برای بهروزرسانی سنجه سفارشی. |
webPropertyId | string | شناسه دارایی وب برای سنجه سفارشی برای به روز رسانی. |
پارامترهای پرس و جو اختیاری | ||
ignoreCustomDataSourceLinks | boolean | بهروزرسانی را اجباری کنید و هر گونه هشدار مربوط به متریک سفارشی را که به منبع داده یا مجموعه داده سفارشی مرتبط است نادیده بگیرید. (پیشفرض: false ) |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.edit |
درخواست بدن
در بدنه درخواست، بخشهای مربوطه از یک منبع management.customMetric را مطابق با قوانین وصله معنایی ارائه کنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع management.customMetric را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: This code assumes you have an authorized Analytics service object. */ /* * This request patches an existing custom metric. */ // Construct the body of the request and set its properties. CustomMetric body = new CustomMetric(); body.setName("Level Completions"); body.setScope("HIT"); body.setType("INTEGER"); body.setActive(true); try { analytics.management().customMetrics() .patch("123456", "UA-123456-1", "ga:metric2", 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 metric. try: analytics.management().customMetrics().patch( accountId='123456', webPropertyId='UA-123456-1', customMetricId='ga:metric2', body={ 'name': 'Level Completions', 'scope': 'HIT', 'type': 'INTEGER', '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 زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.