API Reference

API MANAGEMENT

Đây là hướng dẫn tham khảo cho API Quản lý phiên bản 3.0. Trang này cung cấp đầy đủ thông tin chi tiết về các cụm từ tìm kiếm và phản hồi cho dữ liệu cấu hình của Google Analytics. Để được hướng dẫn về các khái niệm và cấu trúc của dữ liệu cấu hình, hãy xem phần Tổng quan.

Mỗi phần của hướng dẫn này xác định phương thức yêu cầu và phản hồi cho một loại thực thể trong dữ liệu cấu hình cho người dùng đã xác thực. Tất cả các yêu cầu đều hiển thị ở định dạng REST. Ở cuối trang của mỗi phương thức, bạn có thể thử yêu cầu một cách tương tác trong APIs Explorer bằng cách sử dụng đường liên kết "Dùng thử!".

Loại tài nguyên

  1. Tóm tắt về tài khoản
  2. Đường liên kết người dùng của tài khoản
  3. Tài khoản
  4. Đường liên kết đến AdWords
  5. Nguồn dữ liệu tuỳ chỉnh
  6. Phương diện tùy chỉnh
  7. Chỉ số tuỳ chỉnh
  8. Thử nghiệm
  9. Bộ lọc
  10. Mục tiêu
  11. Mã ứng dụng khách
  12. Đường liên kết đến bộ lọc hồ sơ
  13. Đường liên kết đến hồ sơ người dùng
  14. Đối tượng tái tiếp thị
  15. Phân khúc
  16. Báo cáo chưa được lấy mẫu
  17. Tệp tải lên
  18. Chế độ xem (Hồ sơ)
  19. Thuộc tính web
  20. Đường liên kết đến người dùng của thuộc tính web

Tóm tắt tài khoản

Để biết thông tin chi tiết về Tài nguyên tóm tắt của tài khoản, hãy xem trang trình bày tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
list GET  /management/accountSummaries Liệt kê các bản tóm tắt tài khoản (cây nhỏ bao gồm tài khoản/tài sản/hồ sơ) mà người dùng có quyền truy cập.

Để biết chi tiết về Tài nguyên liên kết người dùng cấp tài khoản, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/entityUserLinks/linkId Xoá một người dùng khỏi tài khoản cụ thể.
chèn POST  /management/accounts/accountId/entityUserLinks Thêm người dùng mới vào tài khoản đã cho nếu người dùng đó có ít hơn 100 tài khoản.
list GET  /management/accounts/accountId/entityUserLinks Liệt kê các đường liên kết người dùng tài khoản cho một tài khoản cụ thể.
cập nhật PUT  /management/accounts/accountId/entityUserLinks/linkId Cập nhật quyền cho người dùng hiện tại trên tài khoản cụ thể.

Tài khoản

Để biết chi tiết về Tài nguyên tài khoản, hãy xem trang đại diện về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
list GET  /management/accounts Liệt kê tất cả tài khoản mà người dùng có quyền truy cập.

Để biết chi tiết về Tài nguyên liên kết của AdWords, hãy xem trang đại diện cho tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Xóa liên kết thuộc tính web- AdWords.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Trả về liên kết thuộc tính web – AdWords mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Tạo liên kết webProperty- AdWords.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Liệt kê các liên kết webProperty- AdWords cho một thuộc tính web nhất định.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Cập nhật liên kết webProperty- AdWords hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Cập nhật liên kết webProperty- AdWords hiện có.

Nguồn dữ liệu tùy chỉnh

Để biết thông tin chi tiết về Tài nguyên của nguồn dữ liệu tuỳ chỉnh, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources Liệt kê các nguồn dữ liệu tuỳ chỉnh mà người dùng có quyền truy cập.

Phương diện tuỳ chỉnh

Để biết thông tin chi tiết về Tài nguyên dành cho Phương diện tùy chỉnh, hãy xem trang đại diện cho tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Nhận một phương diện tuỳ chỉnh mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Tạo một phương diện tuỳ chỉnh mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Liệt kê các phương diện tuỳ chỉnh mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Cập nhật một phương diện tuỳ chỉnh hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Cập nhật một phương diện tuỳ chỉnh hiện có.

Chỉ số tuỳ chỉnh

Để biết chi tiết về Tài nguyên chỉ số tùy chỉnh, hãy xem trang trình bày tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Nhận chỉ số tuỳ chỉnh mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Tạo một chỉ số tuỳ chỉnh mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Liệt kê các chỉ số tuỳ chỉnh mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Cập nhật một chỉ số tuỳ chỉnh hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Cập nhật một chỉ số tuỳ chỉnh hiện có.

Thử nghiệm

Để biết thông tin chi tiết về tài nguyên thử nghiệm, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Xoá một thử nghiệm.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Trả về một thử nghiệm mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Tạo thử nghiệm mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Liệt kê các thử nghiệm mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Cập nhật một thử nghiệm hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Cập nhật một thử nghiệm hiện có.

Bộ lọc

Để biết thông tin chi tiết về tài nguyên đối với bộ lọc, hãy xem trang trình bày tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/filters/filterId Xoá bộ lọc.
nhận GET  /management/accounts/accountId/filters/filterId Trả về một bộ lọc mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/filters Tạo bộ lọc mới.
list GET  /management/accounts/accountId/filters Liệt kê tất cả bộ lọc của một tài khoản
bản vá PATCH  /management/accounts/accountId/filters/filterId Cập nhật bộ lọc hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/filters/filterId Cập nhật bộ lọc hiện có.

Bàn thắng

Để biết chi tiết về Tài nguyên mục tiêu, hãy xem trang đại diện cho tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Nhận mục tiêu mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Tạo mục tiêu mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Liệt kê các mục tiêu mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Cập nhật mục tiêu hiện tại. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Cập nhật mục tiêu hiện tại.

Client ID

Để biết thông tin chi tiết về tài nguyên Management.clientId, hãy xem trang trình bày tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
hashClientId POST  /management/clientId:hashClientId Hàm băm ID ứng dụng khách đã cho.

Để biết thông tin chi tiết về tài nguyên của đường liên kết đến bộ lọc hồ sơ, hãy xem trang nội dung trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Xoá đường liên kết đến bộ lọc hồ sơ.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Trả về một liên kết bộ lọc hồ sơ.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Tạo liên kết bộ lọc hồ sơ mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Liệt kê tất cả các liên kết lọc hồ sơ của một hồ sơ.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Cập nhật đường liên kết đến bộ lọc hồ sơ hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Cập nhật đường liên kết đến bộ lọc hồ sơ hiện có.

Để biết thông tin chi tiết về tài nguyên liên kết người dùng trong hồ sơ, hãy xem trang biểu thị tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Xoá người dùng khỏi chế độ xem đã cho (hồ sơ).
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Thêm người dùng mới vào chế độ xem đã cho (hồ sơ).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Liệt kê các liên kết người dùng hồ sơ cho một chế độ xem đã cho (hồ sơ).
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Cập nhật quyền cho người dùng hiện tại trên chế độ xem đã cho (hồ sơ).

Đối tượng tiếp thị lại

Để biết chi tiết về Tài nguyên dành cho đối tượng tái tiếp thị, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Xoá đối tượng tái tiếp thị.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Lấy đối tượng tái tiếp thị mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Tạo đối tượng tái tiếp thị mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Liệt kê các đối tượng tái tiếp thị mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Cập nhật đối tượng tái tiếp thị hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Cập nhật đối tượng tái tiếp thị hiện có.

Phân đoạn

Để biết chi tiết về Tài nguyên phân đoạn, hãy xem trang đại diện tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
list GET  /management/segments Liệt kê các phân khúc mà người dùng có quyền truy cập.

Báo cáo chưa được lấy mẫu

Để biết thông tin chi tiết về Tài nguyên báo cáo chưa được lấy mẫu, hãy xem trang đại diện cho tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Xoá báo cáo chưa được lấy mẫu.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Trả về một báo cáo chưa được lấy mẫu.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Tạo báo cáo chưa được lấy mẫu mới.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Liệt kê những báo cáo chưa được lấy mẫu mà người dùng có quyền truy cập.

Video tải lên

Để biết thông tin về tài nguyên tải lên, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData Xoá dữ liệu được liên kết với video đã tải lên trước đó.
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId Liệt kê các tệp tải lên mà người dùng có quyền truy cập.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads Liệt kê các tệp tải lên mà người dùng có quyền truy cập.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Tải dữ liệu lên cho một nguồn dữ liệu tuỳ chỉnh.

Chế độ xem (Hồ sơ)

Đối với thông tin chi tiết về tài nguyên của Chế độ xem (Hồ sơ), hãy xem trang nội dung trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Xoá chế độ xem (hồ sơ).
nhận GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Lấy chế độ xem (hồ sơ) mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/profiles Tạo chế độ xem mới (hồ sơ).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles Liệt kê chế độ xem (hồ sơ) mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Cập nhật chế độ xem hiện có (hồ sơ). Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Cập nhật chế độ xem hiện có (hồ sơ).

Thuộc tính web

Để biết thông tin chi tiết về tài nguyên thuộc tính web, hãy xem trang mô tả tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
nhận GET  /management/accounts/accountId/webproperties/webPropertyId Lấy một tài sản mà người dùng có quyền truy cập.
chèn POST  /management/accounts/accountId/webproperties Tạo tài sản mới.
list GET  /management/accounts/accountId/webproperties Liệt kê các thuộc tính mà người dùng có quyền truy cập.
bản vá PATCH  /management/accounts/accountId/webproperties/webPropertyId Cập nhật một tài sản hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId Cập nhật một tài sản hiện có.

Để biết thông tin chi tiết về Tài nguyên đường liên kết người dùng của thuộc tính Web, hãy xem trang trình bày về tài nguyên.

Phương thức Yêu cầu HTTP Nội dung mô tả
URI liên quan đến https://www.googleapis.com/analytics/v3, trừ khi có lưu ý khác
xóa DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Xoá một người dùng khỏi tài sản web đã cho.
chèn POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Thêm người dùng mới vào thuộc tính web đã cho.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Liệt kê các đường liên kết webProperty-người dùng cho một tài sản web nhất định.
cập nhật PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Cập nhật quyền cho người dùng hiện tại trên thuộc tính web nhất định.