Filters: insert

इसके लिए, अनुमति लेना ज़रूरी है

एक नया फ़िल्टर बनाएं. इसे अभी आज़माएं या उदाहरण देखें.

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/filters

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
पाथ पैरामीटर
accountId string वह खाता आईडी जिसके लिए फ़िल्टर बनाना है.

अनुमति देना

इस अनुरोध के लिए नीचे दिए गए दायरे के साथ अनुमति की ज़रूरत है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/analytics.edit

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ management.filter संसाधन की जानकारी दें:

प्रॉपर्टी का नाम वैल्यू ब्यौरा ज़रूरी जानकारी
ज़रूरी प्रॉपर्टी
name string इस फ़िल्टर का नाम. लिखने योग्य
type string इस फ़िल्टर का टाइप. संभावित वैल्यू शामिल की जा सकती हैं. इनमें INCLUDE, EXCLUDE, LOWERCASE, अंग्रेज़ी, SEARCH_AND_REPLACE, और बेहतर हैं. लिखने योग्य
वैकल्पिक प्रॉपर्टी
advancedDetails.caseSensitive boolean यह बताता है कि फ़िल्टर एक्सप्रेशन केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) हैं या नहीं. लिखने योग्य
advancedDetails.extractA string एक्सप्रेशन को फ़ील्ड A से एक्सट्रैक्ट करना है. लिखने योग्य
advancedDetails.extractB string एक्सप्रेशन को फ़ील्ड B से एक्सट्रैक्ट करना है. लिखने योग्य
advancedDetails.fieldA string फ़ील्ड A. लिखने योग्य
advancedDetails.fieldAIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य
advancedDetails.fieldARequired boolean यह बताता है कि फ़ील्ड A का मैच होना ज़रूरी है या नहीं. लिखने योग्य
advancedDetails.fieldB string फ़ील्ड B. लिखने योग्य
advancedDetails.fieldBIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य
advancedDetails.fieldBRequired boolean यह बताता है कि फ़ील्ड B का मिलान करना ज़रूरी है या नहीं. लिखने योग्य
advancedDetails.outputConstructor string आउटपुट वैल्यू बनाने के लिए इस्तेमाल किया गया एक्सप्रेशन. लिखने योग्य
advancedDetails.outputToField string आउटपुट फ़ील्ड. लिखने योग्य
advancedDetails.outputToFieldIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य
advancedDetails.overrideOutputField boolean यह बताता है कि आउटपुट फ़ील्ड की मौजूदा वैल्यू, अगर कोई है, तो उसे आउटपुट एक्सप्रेशन से बदला जाना चाहिए या नहीं. लिखने योग्य
excludeDetails.caseSensitive boolean इससे यह पता चलता है कि फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं. लिखने योग्य
excludeDetails.expressionValue string फ़िल्टर एक्सप्रेशन का मान लिखने योग्य
excludeDetails.field string फ़िल्टर करने के लिए फ़ील्ड. संभावित मान:
  • सामग्री और ट्रैफ़िक
    • PAGE_REQUEST_uri,
    • PAGE_HostNAME,
    • PAGE_TITLE,
    • रेफ़रल,
    • लागत_DATA_uri (कैंपेन का टारगेट यूआरएल)
    • 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,
    • प्रॉडक्ट_ACTION_TYPE,
  • ऑडियंस/उपयोगकर्ता
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • प्लैटफ़ॉर्म,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ANCHOR (बूलियन फ़ील्ड),
    • Flash_VERSION,
    • GEO_LEVEL (कनेक्शन की गति),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION (आईएसपी संगठन),
    • GEO_DOMAIN,
    • GEO_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,
    • स्क्रीन,
    • IS_APP (बूलियन फ़ील्ड),
    • IS_FATAL_EXCEPTION (बूलियन फ़ील्ड),
    • EXCEPTION_DESCRIPTION,
  • मोबाइल डिवाइस
    • IS_MOBILE (बूलियन फ़ील्ड, बहिष्कृत. device_CATEGORY=mobile का इस्तेमाल करें),
    • IS_TABLET (बूलियन फ़ील्ड, बहिष्कृत. device_CATEGORY=tablet का इस्तेमाल करें),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYबोर्ड (बूलियन फ़ील्ड),
    • MOBILE_HAS_NFC_SUPPORT (बूलियन फ़ील्ड),
    • MOBILE_HAS_CellularULAR_Radio (बूलियन फ़ील्ड),
    • 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.matchType string इस फ़िल्टर के लिए मैच टाइप. इसकी वैल्यू BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS या MATCHES हो सकती हैं. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI या PAGE_HOSTNAME फ़िल्टर किसी भी मैच टाइप का इस्तेमाल कर सकते हैं; बाकी सभी फ़िल्टर में MATCHES का इस्तेमाल करना ज़रूरी है. लिखने योग्य
includeDetails.caseSensitive boolean इससे यह पता चलता है कि फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं. लिखने योग्य
includeDetails.expressionValue string फ़िल्टर एक्सप्रेशन का मान लिखने योग्य
includeDetails.field string फ़िल्टर करने के लिए फ़ील्ड. संभावित मान:
  • सामग्री और ट्रैफ़िक
    • PAGE_REQUEST_uri,
    • PAGE_HostNAME,
    • PAGE_TITLE,
    • रेफ़रल,
    • लागत_DATA_uri (कैंपेन का टारगेट यूआरएल)
    • 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,
    • प्रॉडक्ट_ACTION_TYPE,
  • ऑडियंस/उपयोगकर्ता
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • प्लैटफ़ॉर्म,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ANCHOR (बूलियन फ़ील्ड),
    • Flash_VERSION,
    • GEO_LEVEL (कनेक्शन की गति),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION (आईएसपी संगठन),
    • GEO_DOMAIN,
    • GEO_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,
    • स्क्रीन,
    • IS_APP (बूलियन फ़ील्ड),
    • IS_FATAL_EXCEPTION (बूलियन फ़ील्ड),
    • EXCEPTION_DESCRIPTION,
  • मोबाइल डिवाइस
    • IS_MOBILE (बूलियन फ़ील्ड, बहिष्कृत. device_CATEGORY=mobile का इस्तेमाल करें),
    • IS_TABLET (बूलियन फ़ील्ड, बहिष्कृत. device_CATEGORY=tablet का इस्तेमाल करें),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYबोर्ड (बूलियन फ़ील्ड),
    • MOBILE_HAS_NFC_SUPPORT (बूलियन फ़ील्ड),
    • MOBILE_HAS_CellularULAR_Radio (बूलियन फ़ील्ड),
    • 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.matchType string इस फ़िल्टर के लिए मैच टाइप. इसकी वैल्यू BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS या MATCHES हो सकती हैं. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI या PAGE_HOSTNAME फ़िल्टर किसी भी मैच टाइप का इस्तेमाल कर सकते हैं; बाकी सभी फ़िल्टर में MATCHES का इस्तेमाल करना ज़रूरी है. लिखने योग्य
lowercaseDetails.field string फ़िल्टर में इस्तेमाल करने के लिए फ़ील्ड. लिखने योग्य
lowercaseDetails.fieldIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य
searchAndReplaceDetails.caseSensitive boolean इससे यह पता चलता है कि फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं. लिखने योग्य
searchAndReplaceDetails.field string फ़िल्टर में इस्तेमाल करने के लिए फ़ील्ड. लिखने योग्य
searchAndReplaceDetails.fieldIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य
searchAndReplaceDetails.replaceString string खोज के लिए शब्द को इससे बदलने वाला शब्द. लिखने योग्य
searchAndReplaceDetails.searchString string खोज करने के लिए शब्द. लिखने योग्य
uppercaseDetails.field string फ़िल्टर में इस्तेमाल करने के लिए फ़ील्ड. लिखने योग्य
uppercaseDetails.fieldIndex integer कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_DIMENSION है, तो यह ज़रूरी है. लिखने योग्य

जवाब

कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में management.filter संसाधन दिखाता है.

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

Java

Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Filters Developer Guide for details.
 */

/*
 * This example creates a new filter.
 */

// Construct the filter Expression object.
AnalyticsManagementFiltersFilterExpression details = new
    AnalyticsManagementFiltersFilterExpression();
details.setField("GEO_DOMAIN");
details.setMatchType("EQUAL");
details.setExpressionValue("example.com");
details.setCaseSensitive(false);

// Construct the body of the request.
Filter body = new Filter();
body.setName("My Domain Filter");
body.setType("EXCLUDE");
body.setExcludeDetails(details);

try {
  analytics.management().filters().insert("123456", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

PHP

PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Filters Developer Guide for details.
 */

/**
 * This request creates a new filter.
 */
try {

  // Construct the filter expression object.
  $details = new Google_Service_Analytics_FilterExpression();
  $details->setField("GEO_DOMAIN");
  $details->setMatchType("EQUAL");
  $details->setExpressionValue("example.com");
  $details->setCaseSensitive(false);

  // Construct the filter and set the details.
  $filter = new Google_Service_Analytics_Filter();
  $filter->setName("My Domain Filter");
  $filter->setType("EXCLUDE");
  $filter->setExcludeDetails($details);
  $analytics->management_filters->insert('123456', $filter);
} catch (apiServiceException $e) {
  print 'There was an Analytics API service error '
      . $e->getCode() . ':' . $e->getMessage();
} catch (apiException $e) {
  print 'There was a general API error '
      . $e->getCode() . ':' . $e->getMessage();
}

Python

Python क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.

# Note: This code assumes you have an authorized Analytics service object.
# See the Filters Developer Guide for details.

# This request creates a new filter.
try:
  analytics.management().filters().insert(
      accountId='123456',
      body={
          'name': 'My Domain Filter',
          'type': 'EXCLUDE',
          'excludeDetails': {
              'field': 'GEO_DOMAIN',
              'matchType': 'EQUAL',
              'expressionValue': 'example.com',
              'caseSensitive': False
              }
      }
  ).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))

JavaScript

JavaScript क्लाइंट लाइब्रेरी का इस्तेमाल करती हो.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Filters Developer Guide for details.
 */

/*
 * This request creates a new filter.
 */
function insertFilter() {
  var request = gapi.client.analytics.management.filters.insert(
    {
      'accountId': '123456',
      'resource': {
        'name': 'My Domain Filter',
        'type': 'EXCLUDE',
        'excludeDetails': {
          'field': 'GEO_DOMAIN',
          'matchType': 'EQUAL',
          'expressionValue': 'example.com',
          'caseSensitive': false
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

इसे आज़माएं!

इस तरीके को लाइव डेटा पर कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें. इसके अलावा, Standalone Explorer का इस्तेमाल भी किया जा सकता है.