Cần có uỷ quyền
Tạo mục tiêu mới. Thử ngay hoặc xem ví dụ.
Ngoài các thông số chuẩn, phương thức này còn hỗ trợ các thông số được liệt kê trong bảng thông số.
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals
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 để tạo mục tiêu. |
profileId |
string |
Mã chế độ xem (Hồ sơ) để tạo mục tiêu. |
webPropertyId |
string |
Mã thuộc tính web để tạo mục tiêu. |
Ủy quyền
Yêu cầu này cần được uỷ quyền với phạm vi sau (đọc thêm về việc xác thực và uỷ quyền).
Phạm vi |
---|
https://www.googleapis.com/auth/analytics.edit |
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp tài nguyênmanagement.mục tiêu.
Phản hồi
Nếu thành công, phương thức này sẽ trả về một tài nguyênmanagement.mục tiêu trong nội dung phản hồi.
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 Goals Developer Guide for details. */ /* * This request creates a new Goal. */ // Construct the body of the request. Goal body = new Goal(); body.setId("3"); body.setActive(true); body.setType("VISIT_TIME_ON_SITE"); // Construct the time on site details. VisitTimeOnSiteDetails details = new VisitTimeOnSiteDetails(); details.setComparisonType("GREATER_THAN"); details.setComparisonValue((long) 300.0); // Set the time on site details. body.setVisitTimeOnSiteDetails(details); try { analytics.management().goals().insert("123456", "UA-123456-1", "7654321", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
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 Goal Developer Guide for details. */ /** * This request creates a new Goal. */ // Construct the body of the request. $goal = new Google_Service_Analytics_Goal(); $goal->setId('2'); $goal->setActive(True); $goal->setType('VISIT_TIME_ON_SITE'); $goal->setName('Time on site goal'); // Construct the time on site details. $details = new Google_Service_Analytics_GoalVisitTimeOnSiteDetails(); $details->setComparisonType('GREATER_THAN'); $details->setComparisonValue(300.0); //Set the time on site details. $goal->setVisitTimeOnSiteDetails($details); try { $analytics->management_goals->insert('123456', 'UA-123456-1', '756321', $goal); } 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
Sử dụng thư viện ứng dụng Python.
# Note: This code assumes you have an authorized Analytics service object. # See the Goal Developer Guide for details. # This request creates a new Goal. try: analytics.management().goals().insert( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', body={ 'id': 2, 'active': True, 'name': 'My Goal', 'type': 'VISIT_TIME_ON_SITE', 'visitTimeOnSiteDetails': { 'comparisonType': 'GREATER_THAN', 'comparisonValue': 300 } } ).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
Sử dụng thư viện ứng dụng JavaScript.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Goals Developer Guide for details. */ /* * This request creates a new goal. */ function insertGoal() { var request = gapi.client.analytics.management.goals.insert( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'profileId': '7654321', 'resource': { 'id': '7', 'active': false, 'name': 'My Goal', 'type': 'VISIT_TIME_ON_SITE', 'visitTimeOnSiteDetails': { 'comparisonType': 'GREATER_THAN', 'comparisonValue': 300 } } }); request.execute(function (response) { // Handle the response. }); }
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.