Filters

مجموعة "الفلاتر" هي مجموعة من موارد الفلاتر، يصف كل منها فلترًا يمكن تطبيقه على ملف شخصي.

للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.

تمثيلات الموارد

نموذج JSON لفلتر حساب "إحصاءات Google"

{
  "id": string,
  "kind": "analytics#filter",
  "selfLink": string,
  "accountId": string,
  "name": string,
  "type": string,
  "created": datetime,
  "updated": datetime,
  "parentLink": {
    "type": "analytics#account",
    "href": string
  },
  "includeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "excludeDetails": {
    "kind": "analytics#filterExpression",
    "field": string,
    "matchType": string,
    "expressionValue": string,
    "caseSensitive": boolean,
    "fieldIndex": integer
  },
  "lowercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "uppercaseDetails": {
    "field": string,
    "fieldIndex": integer
  },
  "searchAndReplaceDetails": {
    "field": string,
    "fieldIndex": integer,
    "searchString": string,
    "replaceString": string,
    "caseSensitive": boolean
  },
  "advancedDetails": {
    "fieldA": string,
    "fieldAIndex": integer,
    "extractA": string,
    "fieldB": string,
    "fieldBIndex": integer,
    "extractB": string,
    "outputToField": string,
    "outputToFieldIndex": integer,
    "outputConstructor": string,
    "fieldARequired": boolean,
    "fieldBRequired": boolean,
    "overrideOutputField": boolean,
    "caseSensitive": boolean
  }
}

اسم الموقع	القيمة	الوصف	Notes
accountId	string	رقم تعريف الحساب الذي ينتمي إليه هذا الفلتر.
advancedDetails	object	تفاصيل حول الفلتر من النوع "متقدم"
advancedDetails.caseSensitive	boolean	يشير إلى ما إذا كانت تعبيرات الفلاتر حساسة لحالة الأحرف.	قابل للكتابة
advancedDetails.extractA	string	التعبير المطلوب استخراجه من الحقل "أ".	قابل للكتابة
advancedDetails.extractB	string	التعبير المطلوب استخراجه من الحقل "ب".	قابل للكتابة
advancedDetails.fieldA	string	الحقل "أ".	قابل للكتابة
advancedDetails.fieldAIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة
advancedDetails.fieldARequired	boolean	يشير إلى ما إذا كان الحقل A مطلوبًا للمطابقة.	قابل للكتابة
advancedDetails.fieldB	string	الحقل "ب".	قابل للكتابة
advancedDetails.fieldBIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة
advancedDetails.fieldBRequired	boolean	يشير إلى ما إذا كان الحقل "ب" مطلوبًا للمطابقة.	قابل للكتابة
advancedDetails.outputConstructor	string	التعبير المستخدم لإنشاء قيمة المخرجات.	قابل للكتابة
advancedDetails.outputToField	string	حقل الإخراج.	قابل للكتابة
advancedDetails.outputToFieldIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة
advancedDetails.overrideOutputField	boolean	يشير إلى ما إذا كان يجب تجاوز القيمة الحالية لحقل الإخراج، إن وجدت، باستخدام تعبير الإخراج.	قابل للكتابة
created	datetime	وقت إنشاء هذا الفلتر
excludeDetails	nested object	تفاصيل عامل تصفية النوع "استبعاد".
excludeDetails.caseSensitive	boolean	تحدِّد هذه السياسة ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
excludeDetails.expressionValue	string	قيمة تعبير الفلتر	قابل للكتابة
excludeDetails.field	string	حقل للفلترة. القيم المتاحة: المحتوى والزيارات PAGE_REQUEST_URI، PAGE_HOSTNAME، PAGE_TITLE، REFERRAL، cost_DATA_URI (عنوان URL لاستهداف الحملة)، HIT_TYPE، INTERNAL_SEARCH_TERM، INTERNAL_SEARCH_TYPE، SOURCE_PROPERTY_TRACKING_ID, الحملة أو المجموعة الإعلانية CAMPAIGN_SOURCE، CAMPAIGN_MEDIUM، CAMPAIGN_NAME، CAMPAIGN_AD_GROUP، CAMPAIGN_TERM، CAMPAIGN_CONTENT، CAMPAIGN_CODE، CAMPAIGN_REFERRAL_PATH، التجارة الإلكترونية TRANSACTION_COUNTRY, TRANSACTION_REGION, TRANSACTION_CITY، TRANSACTION_AFFILIATION (الموقع الجغرافي للمتجر أو الطلب)، ITEM_NAME، ITEM_CODE، ITEM_VARIATION، TRANSACTION_ID، TRANSACTION_CURRENCY_CODE، PRODUCT_ACTION_TYPE، الجمهور/المستخدِمون BROWSER، BROWSER_VERSION, BROWSER_size، PLATFORM، PLATFORM_VERSION، LANGUAGE، SCREEN_RESOLUTION، SCREEN_COLORS، JAVA_Enable (الحقل المنطقي)، FLASH_VERSION، geo_SPEED (سرعة الاتصال)، VISITOR_TYPE، geo_Organization (مؤسسة مزوّد خدمة الإنترنت) Geo_DOMAIN، KPI_IP_ADDRESS، GEO_IP_VERSION, الموقع Geo_COUNTRY، Geo_region, Geo_CITY، الحدث EVENT_CATEGORY، EVENT_ACTION، EVENT_LABEL، أخرى CUSTOM_FIELD_1، CUSTOM_FIELD_2، USER_DEFINED_VALUE، التطبيق APP_ID، APP_INSTALLER_ID، APP_NAME، APP_VERSION، SCREEN، IS_APP (الحقل المنطقي)، IS_FATAL_EXCEPTION (الحقل المنطقي)، EXCEPTION_DESCRIPTION، جهاز جوّال IS_MOBILE (حقل منطقي، تم إيقافه) استخدم DEVICE_CATEGORY=mobile)، IS_TABLET (حقل منطقي، مهمل. استخدم DEVICE_CATEGORY=tablet)، DEVICE_CATEGORY، MOBILE_HAS_QWERTY_KEYBOARD (الحقل المنطقي)، MOBILE_HAS_NFC_SUPPORT (الحقل المنطقي)، MOBILE_HAS_cellULAR_ يفعل (الحقل المنطقي)، MOBILE_HAS_WIFI_SUPPORT (الحقل المنطقي)، MOBILE_BRAND_NAME، MOBILE_MODEL_NAME، MOBILE_MARKETING_NAME، MOBILE_POINTING_Method، الشبكات الاجتماعية SOCIAL_NETWORK، SOCIAL_ACTION، SOCIAL_ACTION_TARGET،	قابل للكتابة
excludeDetails.fieldIndex	integer	فهرس السمة المخصّصة. لا يتم ضبطها إلا إذا كان الحقل CUSTOM_dimension.	قابل للكتابة
excludeDetails.kind	string	قيمة النوع لتعبير الفلتر
excludeDetails.matchType	string	نوع المطابقة لهذا الفلتر القيم المحتملة هي BEGINS_WITH أو EQUAL أو ENDS_WITH أو CONTAINS أو MATCHES. يمكن للفلاتر GEO_DOMAIN أو GEO_IP_ADDRESS أو PAGE_REQUEST_URI أو PAGE_HOSTNAME استخدام أي نوع مطابقة. أما جميع الفلاتر الأخرى، فيجب أن تستخدم MATCHES.	قابل للكتابة
id	string	رقم تعريف الفلتر.
includeDetails	nested object	تفاصيل عن الفلتر من النوع INCLUDE.
includeDetails.caseSensitive	boolean	تحدِّد هذه السياسة ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
includeDetails.expressionValue	string	قيمة تعبير الفلتر	قابل للكتابة
includeDetails.field	string	حقل للفلترة. القيم المتاحة: المحتوى والزيارات PAGE_REQUEST_URI، PAGE_HOSTNAME، PAGE_TITLE، REFERRAL، cost_DATA_URI (عنوان URL لاستهداف الحملة)، HIT_TYPE، INTERNAL_SEARCH_TERM، INTERNAL_SEARCH_TYPE، SOURCE_PROPERTY_TRACKING_ID, الحملة أو المجموعة الإعلانية CAMPAIGN_SOURCE، CAMPAIGN_MEDIUM، CAMPAIGN_NAME، CAMPAIGN_AD_GROUP، CAMPAIGN_TERM، CAMPAIGN_CONTENT، CAMPAIGN_CODE، CAMPAIGN_REFERRAL_PATH، التجارة الإلكترونية TRANSACTION_COUNTRY, TRANSACTION_REGION, TRANSACTION_CITY، TRANSACTION_AFFILIATION (الموقع الجغرافي للمتجر أو الطلب)، ITEM_NAME، ITEM_CODE، ITEM_VARIATION، TRANSACTION_ID، TRANSACTION_CURRENCY_CODE، PRODUCT_ACTION_TYPE، الجمهور/المستخدِمون BROWSER، BROWSER_VERSION, BROWSER_size، PLATFORM، PLATFORM_VERSION، LANGUAGE، SCREEN_RESOLUTION، SCREEN_COLORS، JAVA_Enable (الحقل المنطقي)، FLASH_VERSION، geo_SPEED (سرعة الاتصال)، VISITOR_TYPE، geo_Organization (مؤسسة مزوّد خدمة الإنترنت) Geo_DOMAIN، KPI_IP_ADDRESS، GEO_IP_VERSION, الموقع Geo_COUNTRY، Geo_region, Geo_CITY، الحدث EVENT_CATEGORY، EVENT_ACTION، EVENT_LABEL، أخرى CUSTOM_FIELD_1، CUSTOM_FIELD_2، USER_DEFINED_VALUE، التطبيق APP_ID، APP_INSTALLER_ID، APP_NAME، APP_VERSION، SCREEN، IS_APP (الحقل المنطقي)، IS_FATAL_EXCEPTION (الحقل المنطقي)، EXCEPTION_DESCRIPTION، جهاز جوّال IS_MOBILE (حقل منطقي، تم إيقافه) استخدم DEVICE_CATEGORY=mobile)، IS_TABLET (حقل منطقي، مهمل. استخدم DEVICE_CATEGORY=tablet)، DEVICE_CATEGORY، MOBILE_HAS_QWERTY_KEYBOARD (الحقل المنطقي)، MOBILE_HAS_NFC_SUPPORT (الحقل المنطقي)، MOBILE_HAS_cellULAR_ يفعل (الحقل المنطقي)، MOBILE_HAS_WIFI_SUPPORT (الحقل المنطقي)، MOBILE_BRAND_NAME، MOBILE_MODEL_NAME، MOBILE_MARKETING_NAME، MOBILE_POINTING_Method، الشبكات الاجتماعية SOCIAL_NETWORK، SOCIAL_ACTION، SOCIAL_ACTION_TARGET،	قابل للكتابة
includeDetails.fieldIndex	integer	فهرس السمة المخصّصة. لا يتم ضبطها إلا إذا كان الحقل CUSTOM_dimension.	قابل للكتابة
includeDetails.kind	string	قيمة النوع لتعبير الفلتر
includeDetails.matchType	string	نوع المطابقة لهذا الفلتر القيم المحتملة هي BEGINS_WITH أو EQUAL أو ENDS_WITH أو CONTAINS أو MATCHES. يمكن للفلاتر GEO_DOMAIN أو GEO_IP_ADDRESS أو PAGE_REQUEST_URI أو PAGE_HOSTNAME استخدام أي نوع مطابقة. أما جميع الفلاتر الأخرى، فيجب أن تستخدم MATCHES.	قابل للكتابة
kind	string	نوع المورد لفلتر "إحصاءات Google"
lowercaseDetails	object	تفاصيل حول فلتر النوع LOWER
lowercaseDetails.field	string	الحقل المطلوب استخدامه في الفلتر	قابل للكتابة
lowercaseDetails.fieldIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة
name	string	اسم هذا الفلتر	قابل للكتابة
parentLink	object	الرابط الرئيسي لهذا الفلتر. يشير إلى الحساب الذي ينتمي إليه هذا الفلتر.
parentLink.href	string	اربط الحساب الذي ينتمي إليه هذا الفلتر.
parentLink.type	string	القيمة هي "analytics#account".
searchAndReplaceDetails	object	تفاصيل عن فلتر النوع SEARCH_AND_REPLACE.
searchAndReplaceDetails.caseSensitive	boolean	تحدِّد هذه السياسة ما إذا كان الفلتر حسّاسًا لحالة الأحرف.	قابل للكتابة
searchAndReplaceDetails.field	string	الحقل المطلوب استخدامه في الفلتر	قابل للكتابة
searchAndReplaceDetails.fieldIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة
searchAndReplaceDetails.replaceString	string	العبارة المطلوب استبدال عبارة البحث بها.	قابل للكتابة
searchAndReplaceDetails.searchString	string	عبارة البحث.	قابل للكتابة
selfLink	string	رابط لهذا الفلتر
type	string	أدخِل هذا الفلتر. القيم المحتملة هي INCLUDE وEXCLUDE وLOWERCASE وتعلُّم أحرف SEARCH_AND_REPLACE وADVANCED.	قابل للكتابة
updated	datetime	وقت آخر تعديل لهذا الفلتر
uppercaseDetails	object	تفاصيل عامل التصفية من النوع بالنسبة إلى الأحرف الكبيرة
uppercaseDetails.field	string	الحقل المطلوب استخدامه في الفلتر	قابل للكتابة
uppercaseDetails.fieldIndex	integer	فهرس السمة المخصّصة. يجب ملء هذا الحقل إذا كان الحقل CUSTOM_ بما في ذلك.	قابل للكتابة

الطُرق

حذف

حذف فلتر.

الحصول على

عرض الفلاتر التي يمكن للمستخدم الوصول إليها.

إدراج

يُرجى إنشاء فلتر جديد.

list

عرض جميع الفلاتر لحساب معيّن

تصحيح

لتحديث فلتر حالي. تدعم هذه الطريقة دلالات التصحيح.

تعديل

لتحديث فلتر حالي.