एक नया फ़िल्टर बनाएं. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध करें
एचटीटीपी अनुरोध
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_बदलें, और बेहतर सेटिंग. | लिखा जा सकता है |
| ज़रूरी नहीं | |||
advancedDetails.caseSensitive |
boolean |
यह बताता है कि फ़िल्टर एक्सप्रेशन केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) हैं. | लिखा जा सकता है |
advancedDetails.extractA |
string |
फ़ील्ड A से निकालने के लिए एक्सप्रेशन. | लिखा जा सकता है |
advancedDetails.extractB |
string |
एक्सप्रेशन को फ़ील्ड B से निकालने के लिए. | लिखा जा सकता है |
advancedDetails.fieldA |
string |
फ़ील्ड A | लिखा जा सकता है |
advancedDetails.fieldAIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
advancedDetails.fieldARequired |
boolean |
यह बताता है कि फ़ील्ड A का मिलान ज़रूरी है या नहीं. | लिखा जा सकता है |
advancedDetails.fieldB |
string |
फ़ील्ड B | लिखा जा सकता है |
advancedDetails.fieldBIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
advancedDetails.fieldBRequired |
boolean |
यह बताता है कि फ़ील्ड B को मैच करने की ज़रूरत है या नहीं. | लिखा जा सकता है |
advancedDetails.outputConstructor |
string |
आउटपुट वैल्यू बनाने के लिए इस्तेमाल होने वाला एक्सप्रेशन. | लिखा जा सकता है |
advancedDetails.outputToField |
string |
आउटपुट फ़ील्ड. | लिखा जा सकता है |
advancedDetails.outputToFieldIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
advancedDetails.overrideOutputField |
boolean |
यह बताता है कि आउटपुट फ़ील्ड की मौजूदा वैल्यू, आउटपुट एक्सप्रेशन से ओवरराइड की जानी चाहिए या नहीं. | लिखा जा सकता है |
excludeDetails.caseSensitive |
boolean |
इससे तय होता है कि फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं. | लिखा जा सकता है |
excludeDetails.expressionValue |
string |
फ़िल्टर एक्सप्रेशन का मान | लिखा जा सकता है |
excludeDetails.field |
string |
फ़िल्टर करने के लिए फ़ील्ड. जितने तरह के प्लेसमेंट हो सकते हैं उनकी जानकारी यहां दी गई है:
|
लिखा जा सकता है |
excludeDetails.fieldIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. सिर्फ़ तभी सेट करें, जब फ़ील्ड CUSTOM_डाइमेंशन हो. | लिखा जा सकता है |
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_डाइमेंशन हो. | लिखा जा सकता है |
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_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
searchAndReplaceDetails.caseSensitive |
boolean |
इससे तय होता है कि फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) है या नहीं. | लिखा जा सकता है |
searchAndReplaceDetails.field |
string |
फ़िल्टर में इस्तेमाल करने के लिए फ़ील्ड. | लिखा जा सकता है |
searchAndReplaceDetails.fieldIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
searchAndReplaceDetails.replaceString |
string |
खोज के लिए इस्तेमाल होने वाले शब्द की जगह दूसरा शब्द डालें. | लिखा जा सकता है |
searchAndReplaceDetails.searchString |
string |
खोजने के लिए शब्द. | लिखा जा सकता है |
uppercaseDetails.field |
string |
फ़िल्टर में इस्तेमाल करने के लिए फ़ील्ड. | लिखा जा सकता है |
uppercaseDetails.fieldIndex |
integer |
कस्टम डाइमेंशन का इंडेक्स. अगर फ़ील्ड CUSTOM_डाइमेंशन है, तो ज़रूरी है. | लिखा जा सकता है |
जवाब
अगर यह तरीका लागू होता है, तो जवाब के मुख्य भाग में मैनेजमेंट.फ़िल्टर संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
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. });
}
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें. इसके अलावा, स्टैंडअलोन एक्सप्लोरर आज़माकर देखें.