अनुमति की ज़रूरत है
नया फ़िल्टर बनाएं. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध
एचटीटीपी अनुरोध
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, WARNINGCASE, UpCASE, SEARCH_AND_REMOVE, और Advanced. | लिखा जा सकता है |
| वैकल्पिक प्रॉपर्टी | |||
advancedDetails.caseSensitive |
boolean |
यह बताता है कि फ़िल्टर एक्सप्रेशन केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) हैं या नहीं. | लिखा जा सकता है |
advancedDetails.extractA |
string |
एक्सप्रेशन को फ़ील्ड A से एक्सट्रैक्ट करना है. | लिखा जा सकता है |
advancedDetails.extractB |
string |
एक्सप्रेशन को फ़ील्ड B से एक्सट्रैक्ट करना है. | लिखा जा सकता है |
advancedDetails.fieldA |
string |
फ़ील्ड ए. | लिखा जा सकता है |
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 |
फ़िल्टर करने के लिए फ़ील्ड. संभावित वैल्यू:
|
लिखा जा सकता है |
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 |
फ़िल्टर करने के लिए फ़ील्ड. संभावित वैल्यू:
|
लिखा जा सकता है |
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 का इस्तेमाल भी किया जा सकता है.