نیاز به مجوز دارد
پیوند فیلتر نمایه موجود را به روز کنید. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حسابی که پیوند فیلتر نمایه به آن تعلق دارد. |
linkId | string | شناسه لینک فیلتر نمایه برای به روز رسانی. |
profileId | string | شناسه نمایه که پیوند فیلتر به آن تعلق دارد |
webPropertyId | string | شناسه ویژگی وب که پیوند فیلتر نمایه به آن تعلق دارد |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.edit |
درخواست بدن
در بدنه درخواست، یک منبع پیوندهای فیلتر پروفایل با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
ویژگی های اختیاری | |||
rank | integer | رتبه پیوند این فیلتر پروفایل نسبت به فیلترهای دیگر پیوند شده به همان نمایه. برای عملیات فقط خواندنی (یعنی لیست و دریافت)، رتبه همیشه از 1 شروع می شود. برای عملیات نوشتن (یعنی ایجاد، بهروزرسانی یا حذف)، میتوانید مقداری بین 0 تا 255 را مشخص کنید، [0، 255]. برای درج پیوند در انتهای لیست، یا رتبه ای را مشخص نکنید یا رتبه را روی عددی بزرگتر از بزرگترین رتبه در لیست قرار دهید. برای درج پیوند به ابتدای لیست، رتبه ای را مشخص کنید که کمتر یا مساوی 1 باشد. پیوند جدید تمام فیلترهای موجود را با رتبه یکسان یا پایین تر به پایین لیست منتقل می کند. پس از درج/بهروزرسانی/حذف لینک، همه لینکهای فیلتر نمایه از 1 شمارهگذاری مجدد میشوند. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش منبع پیوندهای فیلتر پروفایل را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Filters Developer Guide for details. */ /* * This request updates an existing profile filter link. */ // Construct the filter reference. FilterRef filterRef = new FilterRef(); filterRef.setId("1223334444"); // Construct the body of the request. ProfileFilterLink body = new ProfileFilterLink(); body.setFilterRef(filterRef); try { analytics.management().profileFilterLinks().update("123456", "UA-123456-1", "7654321", "11223344", 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. # See the Filters Developer Guide for details. # This request updates an existing profile filter link. try: analytics.management().profileFilterLinks().update( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', linkId='11223344', body={ 'filterRef': { 'id': '1223334444' } } ).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 زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.