Method: analytics.agentPerformances.list

Liệt kê dữ liệu về hiệu suất của nhân viên hỗ trợ mà người gọi có thể truy cập.

Mỗi kết quả đại diện cho các chỉ số hiệu suất của một nhân viên cụ thể ở một quốc gia cụ thể. Nếu một đại lý không có đủ dữ liệu cho một quốc gia cụ thể, thì sẽ không có bản ghi hiệu suất nào cho cặp đại lý-quốc gia đó được trả về.

Yêu cầu HTTP

GET https://businesscommunications.googleapis.com/v1/analytics/agentPerformances

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
pageSize

integer

Không bắt buộc. Chỉ định số lượng kết quả tối đa mà máy chủ sẽ trả về. Máy chủ có thể hạn chế thêm số lượng kết quả tối đa được trả về trong một trang. Nếu pageSize là 0, máy chủ sẽ quyết định số lượng kết quả cần trả về. pageSize tối đa là 1000.
pageToken

string

Không bắt buộc. Giá trị nextPageToken được trả về từ một yêu cầu List trước đó (nếu có).

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Trả về danh sách hiệu suất của nhân viên hỗ trợ.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "agentPerformances": [
    {
      object (AgentPerformance)
    }
  ],
  "nextPageToken": string
}
Trường
agentPerformances[]

object (AgentPerformance)

Danh sách hiệu suất của nhân viên.
nextPageToken

string

Không bắt buộc. Mã thông báo phân trang để truy xuất trang kết quả tiếp theo. Nếu giá trị là "", tức là không có kết quả nào khác cho yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/businesscommunications

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

AgentPerformance

Các chỉ số hiệu suất của một đại lý ở một quốc gia.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "countryCode": string,
  "agentUseCase": enum (AgentUseCase),
  "reputation": enum (Reputation),
  "trafficLimit": integer,
  "metricsPeriodEndTime": string,
  "spamTrendDays7": enum (TrendDirection),
  "spamTrendDays28": enum (TrendDirection),
  "agentUnsubscribeReasonMetricsDays7": {
    object (AgentUnsubscribeReasonMetrics)
  },
  "agentUnsubscribeReasonMetricsDays28": {
    object (AgentUnsubscribeReasonMetrics)
  }
}
Trường
name

string

Giá trị nhận dạng riêng biệt của nhân viên.

Do nền tảng xác định.
displayName

string

Bắt buộc. Tên mà nhân viên hỗ trợ hiển thị cho người dùng. Tối đa 40 ký tự.

Không thể sửa đổi sau khi xác minh nhân viên hỗ trợ.
countryCode

string

Phương diện quốc gia cho các chỉ số hiệu suất nhất định. Được cung cấp dưới dạng mã quốc gia ISO 3166 Alpha-2. Ví dụ: "US" cho Hoa Kỳ.
agentUseCase

enum (AgentUseCase)

Trường hợp sử dụng của nhân viên hỗ trợ
reputation

enum (Reputation)

Danh tiếng của nhân viên hỗ trợ ở quốc gia cụ thể.
trafficLimit

integer

Giới hạn lưu lượng truy cập cho nhân viên hỗ trợ (số lượng tin nhắn trên mỗi người dùng mỗi tháng) ở quốc gia cụ thể. Nếu không có giới hạn lưu lượng truy cập đối với tác nhân, thì giá trị sẽ không được đặt.
metricsPeriodEndTime

string (Timestamp format)

Dấu thời gian biểu thị thời điểm kết thúc khoảng thời gian tính toán các chỉ số. Các chỉ số, bao gồm cả danh tiếng, được tính dựa trên dữ liệu cho đến dấu thời gian này. Dấu thời gian này là nửa đêm gần đây nhất theo Giờ Thái Bình Dương (PT).

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
spamTrendDays7

enum (TrendDirection)

Xu hướng về tin nhắn rác trong khoảng thời gian 7 ngày.
spamTrendDays28

enum (TrendDirection)

Xu hướng về tin nhắn rác trong khoảng thời gian 28 ngày.
agentUnsubscribeReasonMetricsDays7

object (AgentUnsubscribeReasonMetrics)

Chỉ số về lý do huỷ đăng ký của nhân viên hỗ trợ trong khoảng thời gian 7 ngày.
agentUnsubscribeReasonMetricsDays28

object (AgentUnsubscribeReasonMetrics)

Các chỉ số về lý do huỷ đăng ký của nhân viên hỗ trợ trong khoảng thời gian 28 ngày.

Danh tiếng

Uy tín của đại lý ở quốc gia cụ thể.

Enum
REPUTATION_UNSPECIFIED Danh tiếng không xác định.
LOW Danh tiếng thấp.
MEDIUM Danh tiếng trung bình. Đây là danh tiếng mặc định.
HIGH Danh tiếng tốt.

TrendDirection

Cho biết sự thay đổi của một chỉ số trong một khoảng thời gian nhất định.

Enum
TREND_DIRECTION_UNSPECIFIED Hướng xu hướng không xác định.
DOWN Xu hướng giảm.
NEUTRAL Xu hướng này không thay đổi.
UP Xu hướng tăng.

AgentUnsubscribeReasonMetrics

Số liệu về lý do huỷ đăng ký của nhân viên hỗ trợ trong một khoảng thời gian nhất định.

Biểu diễn dưới dạng JSON 
{
  "notSignedUpPercentage": integer,
  "tooManyMessagesPercentage": integer,
  "noLongerInterestedPercentage": integer,
  "spamPercentage": integer,
  "otherPercentage": integer
}
Trường
notSignedUpPercentage

integer

Tỷ lệ phần trăm người dùng chọn "Chưa đăng ký" làm lý do huỷ đăng ký.
tooManyMessagesPercentage

integer

Tỷ lệ phần trăm người dùng chọn "Có quá nhiều thư" làm lý do huỷ đăng ký.
noLongerInterestedPercentage

integer

Tỷ lệ phần trăm người dùng chọn "Không còn quan tâm" làm lý do huỷ đăng ký.
spamPercentage

integer

Tỷ lệ phần trăm người dùng chọn lý do huỷ đăng ký là "Nội dung rác".
otherPercentage

integer

Tỷ lệ phần trăm số người dùng chọn lý do "Khác" khi huỷ đăng ký.