Cần có uỷ quyền
Liệt kê tất cả bộ lọc của một tài khoản Dùng thử ngay hoặc xem ví dụ.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/filters
Tham số
Tên thông số | Giá trị | Nội dung mô tả |
---|---|---|
Tham số đường dẫn | ||
accountId |
string |
Mã tài khoản để truy xuất bộ lọc. |
Tham số truy vấn không bắt buộc | ||
max-results |
integer |
Số lượng bộ lọc tối đa được đưa vào câu trả lời này. |
start-index |
integer |
Chỉ mục của thực thể đầu tiên cần truy xuất. Sử dụng thông số này làm cơ chế phân trang cùng với thông số kết quả tối đa. |
Ủy quyền
Yêu cầu này cần được uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).
Phạm vi |
---|
https://www.googleapis.com/auth/analytics.edit |
https://www.googleapis.com/auth/analytics.readonly |
Nội dung yêu cầu
Không cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{ "kind": "analytics#filters", "username": string, "totalResults": integer, "startIndex": integer, "itemsPerPage": integer, "previousLink": string, "nextLink": string, "items": [ management.filters Resource ] }
Tên tài sản | Giá trị | Nội dung mô tả | Ghi chú |
---|---|---|---|
kind |
string |
Loại bộ sưu tập. | |
username |
string |
Mã email của người dùng đã xác thực | |
totalResults |
integer |
Tổng số kết quả cho truy vấn, bất kể số lượng kết quả trong phản hồi. | |
startIndex |
integer |
Chỉ mục bắt đầu của tài nguyên, là 1 theo mặc định hoặc được chỉ định khác bởi tham số truy vấn chỉ mục bắt đầu. | |
itemsPerPage |
integer |
Số lượng tài nguyên tối đa mà phản hồi có thể chứa, bất kể số lượng tài nguyên thực tế được trả về. Giá trị của nó dao động từ 1 đến 1.000 với giá trị là 1000 theo mặc định hoặc được chỉ định bởi tham số truy vấn kết quả tối đa. | |
previousLink |
string |
Liên kết đến trang trước của tập hợp bộ lọc này. | |
nextLink |
string |
Liên kết đến trang tiếp theo cho tập hợp bộ lọc này. | |
items[] |
list |
Danh sách bộ lọc. |
Ví dụ
Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).
Java
Sử dụng thư viện ứng dụng Java.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Filters Developer Guide for details. */ /* * Example #1: * Requests a list of all filters for the authorized user. */ try { Filters filters = analytics.management().filters().list("123456").execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * Example 2: * The results of the list method are stored in the filters object. * The following code shows how to iterate through them. */ for (Filter filter : filters.getItems()) { System.out.println("Account Id = " + filter.getAccountId()); System.out.println("Filter kind = " + filter.getKind()); System.out.println("Filter Id = " + filter.getId()); System.out.println("Filter Name = " + filter.getName()); System.out.println("Filter Created = " + filter.getCreated()); System.out.println("Filter Updated = " + filter.getUpdated()); // Get the filter type. String filterType = filter.getType(); System.out.println("filter type = " + filterType); // Print the properties if it is an "EXCLUDE" type filter. if (filterType == "EXCLUDE") { AnalyticsManagementFiltersFilterExpression details = filter.getExcludeDetails(); System.out.println("Exclude field = " + details.getField()); System.out.println("Exclude match type = " + details.getMatchType()); System.out.println("Exclude case sensitive = " + details.getCaseSensitive()); System.out.println("Exclude expression value = " + details.getExpressionValue()); // Print the properties if it is an "INCLUDE" type filter. } else if (filterType == "INCLUDE") { AnalyticsManagementFiltersFilterExpression details = filter.getIncludeDetails(); System.out.println("Include field = " + details.getField()); System.out.println("Include match type = " + details.getMatchType()); System.out.println("Include case sensitive = " + details.getCaseSensitive()); System.out.println("Include expression value = " + details.getExpressionValue()); // Print the properties if it is a "LOWERCASE" type filter. } else if (filterType == "LOWERCASE") { LowercaseDetails details = filter.getLowercaseDetails(); System.out.println("Lower case field = " + details.getField()); // Print the properties if it is an "UPPERCASE" type filter. } else if (filterType == "UPPERCASE") { UppercaseDetails details = filter.getUppercaseDetails(); System.out.println("Upper case field = " + details.getField()); // Print the details if it is a "SEARCH_AND_REPLACE" type filter. } else if (filterType == "SEARCH_AND_REPLACE") { SearchAndReplaceDetails details = filter.getSearchAndReplaceDetails(); System.out.println("Search and replace field = " + details.getField()); System.out.println("Search string = " + details.getSearchString()); System.out.println("Replace string = " + details.getReplaceString()); System.out.println("Search case sensitive = " + details.getCaseSensitive()); // Print the details if it is an "ADVANCED" type filter. } else if (filterType == "ADVANCED") { AdvancedDetails details = filter.getAdvancedDetails(); System.out.println("Advanced field A = " + details.getFieldA()); System.out.println("Advanced extract A = " + details.getExtractA()); System.out.println("Advanced field B = " + details.getFieldB()); System.out.println("Advanced extract B = " + details.getExtractB()); System.out.println("Advanced output field = " + details.getOutputToField()); System.out.println("Advanced output constructor = " + details.getOutputConstructor()); System.out.println("Advanced field A required = " + details.getFieldARequired()); System.out.println("Advanced field B required = " + details.getFieldBRequired()); System.out.println("Advanced override output field = " + details.getOverrideOutputField()); System.out.println("Advanced case sensitive = " + details.getCaseSensitive()); } }
1.199
Sử dụng thư viện ứng dụng PHP.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Filters Developer Guide for details. */ /** * Example #1: * Requests a list of all filters for the authorized user. */ try { $filters = $analytics->management_filters ->listManagementFilters('123456'); } 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(); } /** * Example #2: * The results of the list method are stored in the filters object. * The following code shows how to iterate through them. */ foreach ($filters->getItems() as $filter) { $html = <<<HTML <pre> Account id = {$filter->getAccountId()} Filter id = {$filter->getId()} Filter name = {$filter->getName()} Filter kind = {$filter->getKind()} Filter Created = {$filter->getCreated()} Filter Updated = {$filter->getUpdated()} HTML; // Get the filter type. $filterType = $filter->getType(); $html .= <<<HTML Filter Type = {$filterType} HTML; // Print the properties if it is an "EXCLUDE" type filter. if ($filterType == 'EXCLUDE') { $details = $filter->getExcludeDetails(); $html .= <<<HTML Exclude field = {$details->getField()} Exclude match type = {$details->getMatchType()} Exclude case sensitive = {$details->getCaseSensitive()} Exclude expression value = {$details->getExpressionValue()} HTML; // Print the properties if it is an "INCLUDE" type filter. } elseif ($filterType == 'INCLUDE') { $details = $filter->getIncludeDetails(); $html .= <<<HTML Include field = {$details->getField()} Include match type = {$details->getMatchType()} Include case sensitive = {$details->getCaseSensitive()} Include expression value = {$details->getExpressionValue()} HTML; // Print the properties if it is a "LOWERCASE" type filter. } elseif ($filterType == 'LOWERCASE') { $details = $filter->getLowercaseDetails(); $html .= <<<HTML Lower case field = {$details->getField()} HTML; // Print the properties if it is an "UPPERCASE" type filter. } elseif ($filterType == 'UPPERCASE') { $details = $filter->getUppercaseDetails(); $html .= <<<HTML Upper case field = {$details->getField()} HTML; // Print the details if it is a "SEARCH_AND_REPLACE" type filter. } elseif ($filterType == 'SEARCH_AND_REPLACE') { $details = $filter->getSearchAndReplaceDetails(); $html .= <<<HTML Search and replace field = {$details->getField()} Search string = {$details->getSearchString()} Replace string = {$details->getReplaceString()} Search case sensitive = {$details->getCaseSensitive()} HTML; // Print the details if it is an "ADVANCED" type filter. } elseif ($filterType == 'ADVANCED') { $details = $filter->getAdvancedDetails(); $html .= <<<HTML Advanced field A = {$details->getFieldA()} Advanced extract A = {$details->getExtractA()} Advanced field B = {$details->getFieldB()} Advanced extract B = {$details->getExtractB()} Advanced output field = {$details->getOutputToField()} Advanced output constructor = {$details->getOutputConstructor()} Advanced field A required = {$details->getFieldARequired()} Advanced field B required = {$details->getFieldBRequired()} Advanced override output field = {$details->getOverrideOutputField()} Advanced case sensitive = {$details->getCaseSensitive()} HTML; } $HTML .= '</pre>'; print $html; }
Python
Sử dụng thư viện ứng dụng Python.
# Note: This code assumes you have an authorized Analytics service object. # See the Filters Developer Guide for details. # Example #1: # Requests a list of all filters for the authorized user. try: filters = analytics.management().filters().list( accountId='123456' ).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)) # Example #2: # The results of the list method are stored in the filters object. # The following code shows how to iterate through them. for filter in filters.get('items', []): print 'Account Id = %s' % filter.get('accountId') print 'Filter Id = %s' % filter.get('id') print 'Filter Kind = %s' % filter.get('kind') print 'Filter Name = %s' % filter.get('name') print 'Filter Created = %s' % filter.get('created') print 'Filter Updated = %s' % filter.get('updated') # Get the filter type. filterType = filter.get('type') print 'Filter Type = %s' % filterType # Print the properties if the filter is of type "EXCLUDE". if filterType == 'EXCLUDE': details = filter.get('excludeDetails', {}) print 'Exclude field = %s' % detail.get('field') print 'Exclude match type = %s' % details.get('matchType') print 'Exclude expression value = %s' % details.get('expressionValue') print 'Exclude case sensitive = %s' % details.get('caseSensitive') # Print the properties if the filter is of type 'INCLUDE'. if filterType == 'INCLUDE': details = filter.get('includeDetails', {}) print 'Include field = %s' % details.get('field') print 'Include match type = %s' % details.get('matchType') print 'Include expression value = %s' % details.get('expressionValue') print 'Include case sensitive = %s' % details.get('caseSensitive') # Print the properties if the filter is of type 'LOWERCASE'. if filterType == 'LOWERCASE': details = filter.get('lowercaseDetails', {}) print 'Lowercase field = %s' % details.get('field') # Print the properties if the filter is of type 'UPPERCASE'. if filterType == 'UPPERCASE': details = filter.get('uppercaseDetails', {}) print 'Uppercase field = %s' % details.get('field') # Print the properties if the filter is of type 'SEARCH_AND_REPLACE'. if filterType == 'SEARCH_AND_REPLACE': details = filter.get('searchAndReplaceDetails', {}) print 'Search and replace field = %s' % details.get('field') print 'Search string = %s' % details.get('searchString') print 'Replace string = %s' % details.get('replaceString') print 'Search and replace case sensitive = %s' % details.get('caseSensitive') # Print the properties if the filter is of type 'ADVANCED'. if filterType == 'ADVANCED': details = filter.get('advancedDetails', {}) print 'Advanced field A = %s' % details.get('fieldA') print 'Advanced extract A = %s' % details.get('extractA') print 'Advanced field B = %s' % details.get('fieldB') print 'Advanced extract B = %s' % details.get('extractB') print 'Advanced output field = %s' % details.get('outputToField') print 'Advanced output constructor = %s' % details.get('outputConstructor') print 'Advanced field A required = %s' % details.get('fieldARequired') print 'Advanced field B required = %s' % details.get('fieldBRequired') print 'Advanced override output field = %s' % details.get('overrideOutputField') print 'Advanced case sensitive = %s' % details.get('caseSensitive')
JavaScript
Sử dụng thư viện ứng dụng JavaScript.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Filters Developer Guide for details. */ /* * Example 1: * Requests a list of all filters for the authorized user. */ function listFilters() { var request = gapi.client.analytics.management.filters.list({ 'accountId': '123456' }); request.execute(printFilters); } /* * Example 2: * The results of the list method are passed as the results object. * The following code shows how to iterate through them. */ function printFilters(results) { if (results && !results.error) { var filters = results.items; for (var i = 0, filter; filter = filters[i]; i++) { console.log('Account Id: ' + filter.accountId); console.log('Filter Id: ' + filter.id); console.log('Filter Kind: ' + filter.kind); console.log('Filter Name: ' + filter.name); console.log('Filter Created: ' + filter.created); console.log('Filter Updated: ' + filter.updated); // Get the filter type. var filterType = filter.type; console.log('Filter Type: ' + filter.type); // Print the properties if the filter is of type 'Exclude'. if (filterType == 'EXCLUDE') { var details = filter.excludeDetails; console.log('Exclude field: ' + details.field); console.log('Exclude match type: ' + details.matchType); console.log('Exclude expression value: ' + details.expressionValue); console.log('Exclude case sensitive: ' + details.caseSensitive); } // Print the properties if the filter is of type 'INCLUDE'. if (filterType == 'INCLUDE') { var details = filter.includeDetails; console.log('Include field: ' + details.field); console.log('Include match type: ' + details.matchType); console.log('Include expression value: ' + details.expressionValue); console.log('Include case sensitive: ' + details.caseSensitive); } // Print the properties if the filter is of type 'LOWERCASE'. if (filterType == 'LOWERCASE') { var details = filter.lowercaseDetails; console.log('Lowercase field: ' + details.field); } // Print the properties if the filter is of type 'UPPERCASE'. if (filterType == 'UPPERCASE') { var details = filter.lowercaseDetails; console.log('Uppercase field: ' + details.field); } // Print the properties if the filter is of type 'SEARCH_AND_REPLACE'. if (filterType == 'SEARCH_AND_REPLACE') { var details = filter.searchAndReplaceDetails; console.log('Search and replace field: ' + details.field); console.log('Search string: ' + details.searchString); console.log('Replace string: ' + details.replaceString); console.log('Search case sensitive: ' + details.caseSensitive); } // Print the properties if the filter is of type 'ADVANCED'. if (filterType == 'ADVANCED') { var details = filter.advancedDetails; console.log('Advanced field A: ' + details.fieldA); console.log('Advanced extract A: ' + details.extractA); console.log('Advanced field B: ' + details.fieldB); console.log('Advanced extract B: ' + details.extractB); console.log('Advanced output field: ' + details.outputToField); console.log('Advanced output constructor: ' + details.outputConstructor); console.log('Advanced field A required: ' + details.fieldARequired); console.log('Advanced field B required: ' + details.fieldBRequired); console.log('Advanced override output field: ' + details.overrideOutputField); console.log('Advanced case sensitive: ' + details.caseSensitive); } } } }
Hãy dùng thử!
Sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi. Ngoài ra, hãy dùng thử Trình khám phá độc lập.