Tài liệu này mô tả các tuỳ chọn, phương thức, thuộc tính và sự kiện cho tất cả thành phần API Nhúng tích hợp sẵn.
xác thực
gapi.analytics.auth
Thành phần xác thực là một singleton có thể dùng để uỷ quyền cho người dùng.
Phương thức |
|
---|---|
authorize(options:Object) |
Trả lại: Hiển thị nút đăng nhập Google Analytics bên trong vùng chứa được chỉ định để người dùng có thể đăng nhập bằng Tài khoản Google của mình. |
isAuthorized() |
Trả lại: Trả về |
signOut() |
Trả lại: Đăng xuất người dùng hiện tại. Đồng thời kích hoạt sự kiện |
getAuthResponse() |
Trả lại: Lấy dữ liệu xác thực do yêu cầu uỷ quyền ban đầu trả về. Đối tượng được trả về bao gồm mã truy cập. Mã này thường có thể dùng để thực hiện các yêu cầu đã xác thực theo cách thủ công. |
getUserProfile() |
Trả lại: Lấy thông tin cơ bản về hồ sơ của người dùng hiện đã đăng nhập. Thông tin này bao gồm tên, địa chỉ email và ảnh hồ sơ công khai của người dùng (nếu được đặt). |
Tùy chọn |
|
---|---|
clientId |
Loại: Mã ứng dụng khách của dự án của bạn trong developer console. |
container |
Loại: Mã của một phần tử HTML trong DOM sẽ lưu trữ nút đăng nhập. Bạn cũng có thể chuyển tham chiếu đến chính phần tử đó. |
userInfoLabel |
Loại: Văn bản sẽ hiển thị trước địa chỉ email của người dùng đã đăng nhập. Giá trị mặc định là |
scopes |
Loại: Danh sách phạm vi xác thực API của Google mà ứng dụng của bạn đang yêu cầu. Để xem tất cả các phạm vi có sẵn, hãy truy cập Play OAuth 2.0 Playground. Đối với phạm vi xác thực API Google Analytics, hãy xem hướng dẫn cho nhà phát triển về các tài nguyên Cấu hình và Báo cáo. |
overwriteDefaultScopes |
Loại: Cho biết lựa chọn Giá trị phạm vi mặc định là: Lưu ý: việc xác thực qua API Nhúng yêu cầu quyền truy cập vào hồ sơ cơ bản của người dùng. Không thể ghi đè các phạm vi đó. |
serverAuth.access_token |
Loại: Nếu đã có mã truy cập hợp lệ, bạn có thể chuyển trực tiếp mã đó vào phương thức cấp phép và người dùng sẽ không bị nhắc cấp phép. Để biết chi tiết về cách truy xuất mã truy cập, hãy xem tài liệu về OAuth 2.0. |
Sự kiện |
|
---|---|
signIn |
Đối số: Không có Được kích hoạt khi người dùng đã đăng nhập thành công. |
signOut |
Đối số: Không có Được kích hoạt khi người dùng đã đăng xuất thành công. |
needsAuthorization |
Đối số: Không có Khi gọi phương thức |
error |
Đối số: Được kích hoạt khi có lỗi xảy ra trong quá trình xác thực. Nếu bạn muốn nhận thông báo lỗi qua đối tượng phản hồi, thông báo lỗi sẽ nằm tại |
Sự kiện không dùng nữa | |
---|---|
success |
Đối số: Sự kiện này tồn tại với khả năng tương thích ngược và có thể bị xoá trong phiên bản sau này. Thay vào đó, hãy sử dụng sự kiện |
Ví dụ:
// Standard client-side authorization. gapi.analytics.auth.authorize({ clientId: 'XXXXXX', container: 'auth-button' }); gapi.analytics.auth.on('signIn', function() { console.log(gapi.analytics.auth.getUserProfile()); });
// Authorization using an access token obtained server-side. // You do not need to register an event handler because // authorization happens immediately. gapi.analytics.auth.authorize({ serverAuth: { access_token: 'XXXXXX' } });
Dữ liệu
gapi.analytics.report.Data
Hàm dựng | |
---|---|
Data(options:Object)
|
Thành phần Dữ liệu cho phép bạn truy vấn API Báo cáo chính của Google Analytics và nhận lại kết quả. |
Tùy chọn |
|
---|---|
query
|
Loại: Đối tượng chứa tham số truy vấn từ API Báo cáo chính. Các giá trị mặc định sau đây được dùng ngoài các giá trị mặc định thông thường do API cung cấp: { 'start-date': '7daysAgo', 'end-date': 'yesterday } |
Sự kiện |
|
---|---|
success |
Đối số: Được kích hoạt khi truy vấn đã hoàn tất thành công. |
error |
Đối số: Được kích hoạt khi có lỗi xảy ra trong quá trình truy vấn. Nếu bạn muốn nhận thông báo lỗi qua đối tượng phản hồi, thông báo lỗi sẽ nằm tại |
Ví dụ:
var report = new gapi.analytics.report.Data({ query: { ids: 'ga:XXXX', metrics: 'ga:sessions', dimensions: 'ga:city' } }); report.on('success', function(response) { console.log(response); }); report.execute();
DataChart
gapi.analytics.googleCharts.DataChart
Hàm dựng | |
---|---|
DataChart(options:Object)
|
DataChart gói một biểu đồ chuẩn của Google và một thành phần Dữ liệu để bạn có thể dễ dàng tạo hình ảnh từ truy vấn mà không cần phải tự liên kết các biểu đồ đó với nhau. |
Tùy chọn |
|
---|---|
query |
Loại: |
chart |
Loại: Xem bên dưới để biết thông tin chi tiết về từng tuỳ chọn biểu đồ. |
chart.container |
Loại: Mã của một phần tử HTML trong DOM sẽ lưu trữ DataChart. Bạn cũng có thể chuyển tham chiếu đến chính phần tử đó. |
chart.type |
Loại: Loại biểu đồ. Các tuỳ chọn có thể là: |
chart.options |
Loại: Bất kỳ lựa chọn nào có thể được chuyển đến đối tượng Google Chart tương ứng. |
Sự kiện |
|
---|---|
success |
Đối số: Được kích hoạt khi truy vấn đã hoàn tất thành công và biểu đồ đã hiển thị đầy đủ.
|
error |
Đối số: Được kích hoạt khi xảy ra lỗi trong quá trình truy vấn hoặc hiển thị. Nếu bạn muốn nhận thông báo lỗi qua đối tượng phản hồi, thông báo lỗi sẽ nằm tại |
Ví dụ:
var chart = new gapi.analytics.googleCharts.DataChart({ query: { ids: 'ga:XXXX', metrics: 'ga:sessions', dimensions: 'ga:date' }, chart: { type: 'LINE', container: 'line-chart', options: { title: 'Sessions over the past week.', fontSize: 12 } } }); chart.on('success', function(response) { // response.chart : the Google Chart instance. // response.data : the Google Chart data object. }); chart.execute();
ViewSelector
gapi.analytics.ViewSelector
Hàm dựng | |
---|---|
ViewSelector(options:Object)
|
Thành phần ViewSelector cho phép bạn chọn tài khoản, tài sản và chế độ xem qua trình đơn thả xuống. |
Tùy chọn |
|
---|---|
container |
Loại: Mã của phần tử HTML trong DOM sẽ lưu trữ ViewSelector. Bạn cũng có thể chuyển tham chiếu đến chính phần tử đó. |
Thuộc tính thực thể |
|
---|---|
ids |
Loại: Mã bảng duy nhất của biểu mẫu ga:XXXX, trong đó XXXX là mã chế độ xem (hồ sơ) Analytics. |
Sự kiện |
|
---|---|
change |
Đối số: Được kích hoạt bất cứ khi nào người dùng chọn một chế độ xem mới trên trình đơn thả xuống. Thuộc tính này cũng được kích hoạt khi phiên bản ViewSelector được hiển thị lần đầu tiên và khi chế độ xem mặc định được hiển thị. |
Ví dụ:
var viewSelector = new gapi.analytics.ViewSelector({ container: 'view-selector' }); viewSelector.on('change', function(ids) { console.log(ids); }); viewSelector.execute();
Phương thức thành phần dùng chung
Phương thức | |
---|---|
set(options) |
trả về: Đặt hoặc cập nhật các tuỳ chọn cấu hình của thành phần (bạn cũng có thể thực hiện việc này tại thời điểm tạo trong hàm khởi tạo). |
get() |
trả về: Trả về các tuỳ chọn cấu hình hiện tại của một thành phần. |
execute() |
trả về: Gọi hành động chính của thành phần đó. Thao tác này thường hiển thị nội dung nào đó trên trang hoặc chạy một báo cáo (hoặc cả hai). |
on(event, handler) |
trả về: Đăng ký một hàm để được gọi khi thành phần phát ra sự kiện được chỉ định. |
once(event, handler) |
trả về: Đăng ký một hàm để chỉ gọi vào lần xuất hiện tiếp theo của sự kiện được chỉ định. Sau khi trình xử lý chạy sau khi tự động huỷ đăng ký. |
off(opt_event, opt_handler) |
trả về: Xoá một trình xử lý sự kiện khỏi một thành phần. Nếu không có trình xử lý nào được truyền, thì thao tác này sẽ xoá tất cả trình xử lý cho sự kiện đã chuyển. Nếu không có sự kiện nào được thông qua, thì thao tác này sẽ xoá tất cả trình xử lý cho mọi sự kiện. |
emit(event, ...opt_args) |
trả về: Phát ra một sự kiện. Bạn có thể tuỳ ý chỉ định các đối số để truyền đến bất kỳ trình xử lý đã đăng ký nào. |
set
Đặt hoặc cập nhật các tuỳ chọn cấu hình của thành phần (bạn cũng có thể thực hiện việc này tại thời điểm tạo trong hàm khởi tạo).
Cách sử dụng
component.set(options);
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
options |
Object |
Các lựa chọn cấu hình cho thành phần này. Các lựa chọn đã chọn sẽ được hợp nhất với các lựa chọn hiện có. |
Giá trị trả về
this
– Thực thể của thành phần.
get
Trả về các tuỳ chọn cấu hình hiện tại của một thành phần.
Giá trị trả về
Object
– Các tuỳ chọn cấu hình hiện tại của thành phần.
execute()
Gọi hành động chính của thành phần đó. Thao tác này thường hiển thị nội dung nào đó trên trang hoặc chạy một báo cáo (hoặc cả hai).
Giá trị trả về
this
– Thực thể của thành phần.
on(event, handler)
Đăng ký một hàm để được gọi khi thành phần phát ra sự kiện được chỉ định.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
event |
string |
Tên của sự kiện. |
handler |
Function |
Hàm sẽ được gọi khi sự kiện xảy ra. (Xem từng tài liệu tham khảo sự kiện để biết thông tin chi tiết về thông số.) |
Giá trị trả về
this
– Thực thể của thành phần.
once(event, handler)
Đăng ký một hàm để chỉ gọi vào lần xuất hiện tiếp theo của sự kiện được chỉ định. Sau khi trình xử lý chạy sau khi tự động huỷ đăng ký.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
event |
string |
Tên của sự kiện. |
handler |
Function |
Hàm sẽ được gọi khi sự kiện xảy ra. (Xem từng tài liệu tham khảo sự kiện để biết thông tin chi tiết về thông số.) |
Giá trị trả về
this
– Thực thể của thành phần.
off(opt_event, opt_handler)
Xoá một trình xử lý sự kiện khỏi một thành phần. Nếu không có trình xử lý nào được truyền, thì thao tác này sẽ xoá tất cả trình xử lý cho sự kiện đã chuyển. Nếu không có sự kiện nào được thông qua, thì thao tác này sẽ xoá tất cả trình xử lý cho mọi sự kiện.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
opt_event |
string |
Tên của sự kiện. Nếu không có sự kiện nào được chỉ định, thì mọi trình xử lý cho mọi sự kiện sẽ bị xoá. Không bắt buộc. |
opt_handler |
Function |
Tham chiếu đến trình xử lý hàm cần xoá. Nếu không có hàm nào được truyền, thì mọi trình xử lý sẽ bị xoá. Không bắt buộc. |
Giá trị trả về
undefined
emit(event, ...opt_args)
Phát ra một sự kiện. Bạn có thể tuỳ ý chỉ định các đối số để truyền đến bất kỳ trình xử lý đã đăng ký nào.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
event |
string |
Tên của sự kiện. |
...opt_args |
* |
Các đối số không bắt buộc sẽ được truyền đến bất kỳ trình xử lý sự kiện nào đã đăng ký. |
Giá trị trả về
undefined