Profile Filter Links: insert

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

یک لینک فیلتر پروفایل جدید ایجاد کنید. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

درخواست

درخواست HTTP

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

مولفه های

نام پارامتر	ارزش	شرح
پارامترهای مسیر
accountId	string	شناسه حساب برای ایجاد پیوند فیلتر نمایه برای.
profileId	string	شناسه نمایه برای ایجاد پیوند فیلتر برای.
webPropertyId	string	شناسه ویژگی وب برای ایجاد پیوند فیلتر نمایه برای.

مجوز

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

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

درخواست بدن

در بدنه درخواست، یک منبع پیوندهای فیلتر پروفایل با ویژگی های زیر ارائه کنید:

نام ملک	ارزش	شرح	یادداشت
ویژگی های مورد نیاز
filterRef. id	string	شناسه فیلتر	قابل نوشتن
ویژگی های اختیاری
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 creates a new 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().insert("123456",
    "UA-123456-1", "7654321", 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 creates a new profile filter link.
try:
  analytics.management().profileFilterLinks().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.