Method: activities.list

Truy xuất danh sách hoạt động cho một tài khoản và ứng dụng cụ thể của khách hàng, chẳng hạn như ứng dụng Bảng điều khiển dành cho quản trị viên hoặc ứng dụng Google Drive. Để biết thêm thông tin, hãy xem hướng dẫn dành cho quản trị viên và báo cáo hoạt động trên Google Drive. Để biết thêm thông tin về các thông số của báo cáo hoạt động, hãy xem hướng dẫn tham khảo về các thông số hoạt động.

Yêu cầu HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

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

Tham số đường dẫn

Thông số
userKey or all

string

Biểu thị mã hồ sơ hoặc email người dùng mà dữ liệu cần được lọc. Có thể là all cho tất cả thông tin hoặc userKey cho mã nhận dạng hồ sơ duy nhất của người dùng trên Google Workspace hoặc địa chỉ email chính của họ. Không được là người dùng đã bị xoá. Đối với người dùng đã bị xoá, hãy gọi users.list trong Directory API bằng showDeleted=true, sau đó sử dụng ID đã trả về làm userKey.
applicationName

enum (ApplicationName)

Tên ứng dụng mà bạn muốn truy xuất các sự kiện.

Tham số truy vấn

Thông số
actorIpAddress

string

Địa chỉ Giao thức Internet (IP) của máy chủ lưu trữ nơi diễn ra sự kiện. Đây là một cách khác để lọc thông tin tóm tắt của báo cáo bằng địa chỉ IP của người dùng có hoạt động đang được báo cáo. Địa chỉ IP này có thể phản ánh hoặc không phản ánh vị trí thực tế của người dùng. Ví dụ: địa chỉ IP có thể là địa chỉ máy chủ proxy của người dùng hoặc địa chỉ mạng riêng ảo (VPN). Tham số này hỗ trợ cả phiên bản địa chỉ IPv4 và IPv6.
customerId

string

Mã nhận dạng duy nhất của khách hàng để truy xuất dữ liệu.
endTime

string

Đặt điểm cuối của phạm vi thời gian xuất hiện trong báo cáo. Ngày ở định dạng RFC 3339, ví dụ: 2010-10-28T10:26:35.000Z. Giá trị mặc định là thời gian gần đúng của yêu cầu API. Báo cáo API có 3 khái niệm cơ bản về thời gian:

  • Ngày API yêu cầu báo cáo: Khi API tạo và truy xuất báo cáo.
  • Thời gian bắt đầu của báo cáo: Thời điểm bắt đầu của khoảng thời gian xuất hiện trong báo cáo. startTime phải trước endTime (nếu được chỉ định) và thời gian hiện tại khi yêu cầu được thực hiện, nếu không API sẽ trả về lỗi.
  • Thời gian kết thúc của báo cáo: Thời điểm kết thúc khoảng thời gian xuất hiện trong báo cáo. Ví dụ: khoảng thời gian của các sự kiện được tóm tắt trong một báo cáo có thể bắt đầu từ tháng 4 và kết thúc vào tháng 5. Bản thân báo cáo có thể được yêu cầu vào tháng 8.
Nếu bạn không chỉ định endTime, thì báo cáo sẽ trả về tất cả hoạt động từ startTime cho đến thời điểm hiện tại hoặc 180 ngày gần đây nhất nếu startTime cách đây hơn 180 ngày.

Đối với yêu cầu liên quan đến Gmail, bạn phải cung cấp startTime và endTime, đồng thời khoảng cách giữa hai ngày này không được quá 30 ngày.
eventName

string

Tên của sự kiện mà API đang truy vấn. Mỗi eventName đều liên quan đến một dịch vụ hoặc tính năng cụ thể của Google Workspace mà API sắp xếp thành các loại sự kiện. Ví dụ: sự kiện trên Lịch Google trong báo cáo của ứng dụng Bảng điều khiển dành cho quản trị viên. Cấu trúc Chế độ cài đặt lịch type có tất cả các hoạt động của Lịch eventName do API báo cáo. Khi quản trị viên thay đổi một chế độ cài đặt Lịch, API sẽ báo cáo hoạt động này trong các tham số type và eventName của Chế độ cài đặt Lịch. Để biết thêm thông tin về các thông số và chuỗi truy vấn eventName, hãy xem danh sách tên sự kiện cho nhiều ứng dụng ở trên trong applicationName.
filters

string

Chuỗi truy vấn filters là một danh sách được phân tách bằng dấu phẩy, bao gồm các tham số sự kiện do toán tử quan hệ thao tác. Thông số sự kiện có dạng {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Các thông số sự kiện này được liên kết với một eventName cụ thể. Một báo cáo trống sẽ được trả về nếu tham số của yêu cầu không thuộc eventName. Để biết thêm thông tin về các trường eventName có sẵn cho từng ứng dụng và các thông số liên quan, hãy chuyển đến bảng ApplicationName, sau đó nhấp vào trang Sự kiện hoạt động trong Phụ lục cho ứng dụng bạn muốn.

Trong các ví dụ sau về hoạt động trên Drive, danh sách được trả về bao gồm tất cả các sự kiện edit trong đó giá trị tham số doc_id khớp với các điều kiện do toán tử quan hệ xác định. Trong ví dụ đầu tiên, yêu cầu này trả về tất cả các tài liệu đã chỉnh sửa có giá trị doc_id bằng 12345. Trong ví dụ thứ hai, báo cáo trả về mọi tài liệu đã chỉnh sửa mà giá trị doc_id không bằng 98765. Toán tử <> được mã hoá URL trong chuỗi truy vấn của yêu cầu (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Một truy vấn filters hỗ trợ các toán tử quan hệ sau:

  • == – "bằng".
  • <> – "không bằng". Phải được mã hoá URL (%3C%3E).
  • < – "nhỏ hơn". Phải được mã hoá URL (%3C).
  • <= – "nhỏ hơn hoặc bằng". Phải được mã hoá URL (%3C=).
  • > – "lớn hơn". Phải được mã hoá URL (%3E).
  • >= – "lớn hơn hoặc bằng". Phải được mã hoá URL (%3E=).

Lưu ý: API này không chấp nhận nhiều giá trị của cùng một tham số. Nếu một tham số được cung cấp nhiều lần trong yêu cầu API, thì API chỉ chấp nhận giá trị cuối cùng của tham số đó. Ngoài ra, nếu bạn cung cấp một tham số không hợp lệ trong yêu cầu API, thì API sẽ bỏ qua tham số đó và trả về phản hồi tương ứng với các tham số hợp lệ còn lại. Nếu không có tham số nào được yêu cầu, thì tất cả tham số sẽ được trả về.
maxResults

integer

Xác định số lượng bản ghi hoạt động xuất hiện trên mỗi trang phản hồi. Ví dụ: nếu yêu cầu đặt maxResults=1 và báo cáo có 2 hoạt động, thì báo cáo sẽ có 2 trang. Thuộc tính nextPageToken của phản hồi có mã thông báo cho trang thứ hai. Bạn không bắt buộc phải dùng chuỗi truy vấn maxResults trong yêu cầu. Giá trị mặc định là 1000.
orgUnitID

string

Mã nhận dạng của đơn vị tổ chức cần báo cáo. Hồ sơ hoạt động sẽ chỉ xuất hiện cho những người dùng thuộc đơn vị tổ chức được chỉ định.

pageToken

string

Mã thông báo để chỉ định trang tiếp theo. Báo cáo có nhiều trang sẽ có một thuộc tính nextPageToken trong phản hồi. Trong yêu cầu tiếp theo để lấy trang tiếp theo của báo cáo, hãy nhập giá trị nextPageToken vào chuỗi truy vấn pageToken.
startTime

string

Đặt điểm bắt đầu của phạm vi thời gian xuất hiện trong báo cáo. Ngày ở định dạng RFC 3339, ví dụ: 2010-10-28T10:26:35.000Z. Báo cáo này trả về tất cả hoạt động từ ngày startTime đến ngày endTime. startTime phải trước endTime (nếu được chỉ định) và thời gian hiện tại khi yêu cầu được thực hiện, nếu không API sẽ trả về lỗi.

Đối với yêu cầu liên quan đến Gmail, bạn phải cung cấp startTime và endTime, đồng thời khoảng cách giữa hai ngày này không được quá 30 ngày.
groupIdFilter

string

Mã nhận dạng nhóm (được che giấu) phân tách bằng dấu phẩy mà hoạt động của người dùng được lọc, tức là phản hồi sẽ chỉ chứa hoạt động của những người dùng thuộc ít nhất một trong các mã nhận dạng nhóm được đề cập ở đây. Định dạng: "id:abc123,id:xyz456"

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

Mẫu JSON cho một tập hợp các hoạt động.

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 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

Loại tài nguyên API. Đối với báo cáo hoạt động, giá trị là reports#activities.
etag

string

ETag của tài nguyên.
items[]

object (Activity)

Mỗi bản ghi hoạt động trong phản hồi.
nextPageToken

string

Mã thông báo để truy xuất trang tiếp theo của báo cáo. Giá trị nextPageToken được dùng trong chuỗi truy vấn pageToken của yêu cầu.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ApplicationName

Enum
access_transparency

Báo cáo hoạt động Access Transparency của Google Workspace trả về thông tin về nhiều loại sự kiện hoạt động Access Transparency.
admin

Báo cáo hoạt động của ứng dụng Bảng điều khiển dành cho quản trị viên trả về thông tin tài khoản về nhiều loại sự kiện hoạt động của quản trị viên.
calendar

Báo cáo hoạt động của ứng dụng Lịch Google trả về thông tin về nhiều sự kiện hoạt động trên Lịch.
chat Báo cáo hoạt động trên Chat trả về thông tin về nhiều sự kiện hoạt động trên Chat.
drive

Báo cáo hoạt động của ứng dụng Google Drive trả về thông tin về nhiều sự kiện hoạt động trên Google Drive. Báo cáo hoạt động trên Drive chỉ dành cho khách hàng Google Workspace Business và Enterprise.
gcp Báo cáo hoạt động của ứng dụng Google Cloud Platform trả về thông tin về nhiều sự kiện hoạt động trên GCP.
gmail Báo cáo hoạt động của ứng dụng Gmail trả về thông tin về nhiều sự kiện hoạt động trên Gmail.
gplus Báo cáo hoạt động của ứng dụng Google+ trả về thông tin về nhiều sự kiện hoạt động trên Google+.
groups

Báo cáo hoạt động của ứng dụng Google Groups trả về thông tin về nhiều sự kiện hoạt động của Nhóm.
groups_enterprise

Báo cáo hoạt động của Nhóm doanh nghiệp trả về thông tin về nhiều sự kiện hoạt động của Nhóm doanh nghiệp.
jamboard Báo cáo hoạt động trên Jamboard trả về thông tin về nhiều sự kiện hoạt động trên Jamboard.
login

Báo cáo hoạt động của ứng dụng Đăng nhập trả về thông tin tài khoản về các loại Sự kiện hoạt động đăng nhập.
meet Báo cáo hoạt động Kiểm tra Meet trả về thông tin về nhiều loại sự kiện Kiểm tra hoạt động trên Meet.
mobile Báo cáo hoạt động Kiểm tra thiết bị trả về thông tin về nhiều loại sự kiện hoạt động Kiểm tra thiết bị.
rules

Báo cáo hoạt động theo quy tắc trả về thông tin về nhiều loại Sự kiện hoạt động theo quy tắc.
saml

Báo cáo hoạt động SAML trả về thông tin về nhiều loại sự kiện hoạt động SAML.
token

Báo cáo hoạt động của ứng dụng Token trả về thông tin tài khoản về nhiều loại Sự kiện hoạt động của Token.
user_accounts

Báo cáo hoạt động của ứng dụng Tài khoản người dùng trả về thông tin tài khoản về nhiều loại Sự kiện hoạt động của Tài khoản người dùng.
context_aware_access

Báo cáo hoạt động Quyền truy cập theo bối cảnh trả về thông tin về các sự kiện bị từ chối truy cập của người dùng do quy tắc Quyền truy cập theo bối cảnh.
chrome

Báo cáo hoạt động trên Chrome trả về thông tin về các sự kiện trên trình duyệt Chrome và Chrome OS.
data_studio Báo cáo hoạt động của Data Studio trả về thông tin về nhiều loại sự kiện hoạt động của Data Studio.
keep Báo cáo hoạt động của ứng dụng Keep trả về thông tin về nhiều sự kiện hoạt động trên Google Keep. Báo cáo hoạt động trên Keep chỉ dành cho khách hàng Google Workspace Business và Enterprise.
vault Báo cáo hoạt động của Vault trả về thông tin về nhiều loại sự kiện hoạt động của Vault.
gemini_in_workspace_apps Báo cáo hoạt động của Gemini cho Workspace trả về thông tin về nhiều loại sự kiện hoạt động của Gemini do người dùng thực hiện trong một ứng dụng của Workspace.
classroom Báo cáo hoạt động trên Lớp học trả về thông tin về nhiều loại sự kiện hoạt động trên Lớp học.

Hoạt động

Mẫu JSON cho tài nguyên hoạt động.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Trường
kind

string

Loại tài nguyên API. Đối với báo cáo hoạt động, giá trị là audit#activity.
etag

string

ETag của mục nhập.
ownerDomain

string

Đây là miền chịu ảnh hưởng của sự kiện trong báo cáo. Ví dụ: miền của Bảng điều khiển dành cho quản trị viên hoặc chủ sở hữu tài liệu của ứng dụng Drive.
ipAddress

string

Địa chỉ IP của người dùng thực hiện hành động. Đây là địa chỉ giao thức Internet (IP) của người dùng khi đăng nhập vào Google Workspace. Địa chỉ này có thể phản ánh hoặc không phản ánh vị trí thực tế của người dùng. Ví dụ: địa chỉ IP có thể là địa chỉ máy chủ proxy của người dùng hoặc địa chỉ mạng riêng ảo (VPN). API này hỗ trợ IPv4 và IPv6.
events[]

object

Sự kiện hoạt động trong báo cáo.
events[].type

string

Loại sự kiện. Dịch vụ hoặc tính năng của Google Workspace mà quản trị viên thay đổi được xác định trong thuộc tính type. Thuộc tính này xác định một sự kiện bằng thuộc tính eventName. Để xem danh sách đầy đủ các danh mục type của API, hãy xem danh sách tên sự kiện cho nhiều ứng dụng ở trên trong applicationName.
events[].name

string

Tên của sự kiện. Đây là tên cụ thể của hoạt động do API báo cáo. Mỗi eventName đều liên quan đến một dịch vụ hoặc tính năng cụ thể của Google Workspace mà API sắp xếp thành các loại sự kiện.
Đối với các tham số yêu cầu eventName nói chung:

  • Nếu không có eventName nào được đưa ra, báo cáo sẽ trả về tất cả các phiên bản có thể có của một eventName.
  • Khi bạn yêu cầu một eventName, phản hồi của API sẽ trả về tất cả các hoạt động có chứa eventName đó.

Để biết thêm thông tin về các thuộc tính eventName, hãy xem danh sách tên sự kiện cho nhiều ứng dụng ở trên trong applicationName.
events[].parameters[]

object

Các cặp giá trị tham số cho nhiều ứng dụng. Để biết thêm thông tin về các tham số eventName, hãy xem danh sách tên sự kiện cho nhiều ứng dụng ở trên trong applicationName.
events[].parameters[].messageValue

object

Các cặp giá trị tham số lồng nhau được liên kết với tham số này. Loại giá trị phức tạp cho một tham số được trả về dưới dạng danh sách các giá trị tham số. Ví dụ: tham số địa chỉ có thể có giá trị là [{parameter: [{name: city, value: abc}]}]
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Giá trị tham số
events[].parameters[].name

string

Tên của thông số.
events[].parameters[].value

string

Giá trị kiểu chuỗi của thông số.
events[].parameters[].multiValue[]

string

Giá trị chuỗi của thông số.
events[].parameters[].intValue

string (int64 format)

Giá trị số nguyên của thông số.
events[].parameters[].multiIntValue[]

string (int64 format)

Giá trị số nguyên của tham số.
events[].parameters[].boolValue

boolean

Giá trị boolean của thông số.
events[].parameters[].multiMessageValue[]

object

activities.list gồm các đối tượng messageValue.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Giá trị tham số
events[].resourceIds[]

string

Mã nhận dạng tài nguyên được liên kết với sự kiện.
id

object

Giá trị nhận dạng riêng biệt cho từng bản ghi hoạt động.
id.time

string

Thời gian diễn ra hoạt động. Đây là thời gian bắt đầu của hệ thống UNIX tính bằng giây.
id.uniqueQualifier

string (int64 format)

Giá trị phân biệt duy nhất nếu nhiều sự kiện có cùng thời gian.
id.applicationName

string

Tên ứng dụng mà sự kiện thuộc về. Để biết các giá trị có thể có, hãy xem danh sách ứng dụng ở trên trong applicationName.
id.customerId

string

Giá trị nhận dạng duy nhất cho một tài khoản Google Workspace.
actor

object

Người dùng thực hiện hành động.
actor.profileId

string

Mã nhận dạng hồ sơ Google Workspace duy nhất của người dùng. Giá trị này có thể không xuất hiện nếu tác nhân không phải là người dùng Google Workspace hoặc có thể là số 105250506097979753968 đóng vai trò là mã nhận dạng phần giữ chỗ.
actor.email

string

Địa chỉ email chính của diễn viên. Có thể không có nếu không có địa chỉ email nào liên kết với diễn viên.
actor.callerType

string

Loại người thực hiện.
actor.key

string

Chỉ xuất hiện khi callerType là KEY. Có thể là consumer_key của người yêu cầu đối với các yêu cầu API OAuth 2LO hoặc giá trị nhận dạng cho tài khoản rô-bốt.
actor.applicationInfo

object

Thông tin chi tiết về ứng dụng là đối tượng thực hiện hoạt động.
actor.applicationInfo.oauthClientId

string

Mã ứng dụng OAuth của ứng dụng bên thứ ba được dùng để thực hiện hành động.
actor.applicationInfo.applicationName

string

Tên của ứng dụng dùng để thực hiện thao tác.
actor.applicationInfo.impersonation

boolean

Ứng dụng có mạo danh người dùng hay không.
networkInfo

object (NetworkInfo)

Thông tin mạng của người dùng thực hiện hành động.
resourceDetails[]

object (ResourceDetails)

Thông tin chi tiết về tài nguyên mà hành động được thực hiện.

NetworkInfo

Thông tin mạng của người dùng thực hiện hành động.

Biểu diễn dưới dạng JSON 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
Trường
ipAsn[]

integer

Địa chỉ IP của người dùng thực hiện hành động.
regionCode

string

Mã vùng ISO 3166-1 alpha-2 của người dùng thực hiện hành động.
subdivisionCode

string

Mã vùng ISO 3166-2 (tiểu bang và tỉnh) cho quốc gia của người dùng thực hiện hành động.

ResourceDetails

Thông tin chi tiết về tài nguyên mà hành động được thực hiện.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
Trường
id

string

Giá trị nhận dạng của tài nguyên.
title

string

Tiêu đề của tài nguyên. Ví dụ: trong trường hợp là một tài liệu trên Drive, đây sẽ là tiêu đề của tài liệu đó. Trong trường hợp là email, đây sẽ là tiêu đề.
type

string

Loại tài nguyên – tài liệu, email, tin nhắn trò chuyện
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

Xác định mối quan hệ của tài nguyên với các sự kiện

AppliedLabel

Thông tin chi tiết về nhãn được áp dụng cho tài nguyên.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
Trường
id

string

Giá trị nhận dạng của nhãn – Chỉ mã nhận dạng nhãn, không phải tên tài nguyên đầy đủ của OnePlatform.
title

string

Tiêu đề của nhãn
fieldValues[]

object (FieldValue)

activities.list of fields which are part of the label and have been set by the user. Nếu nhãn có một trường mà người dùng chưa đặt, thì nhãn đó sẽ không xuất hiện trong danh sách này.
reason

object (Reason)

Lý do nhãn được áp dụng cho tài nguyên.

FieldValue

Thông tin chi tiết về giá trị trường do người dùng đặt cho nhãn cụ thể.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Trường
id

string

Giá trị nhận dạng của trường
displayName

string

Tên hiển thị của trường
type

string

Loại trường
reason

object (Reason)

Lý do trường này được áp dụng cho nhãn.
Trường nhóm value. Các giá trị được lưu trữ trong trường value chỉ có thể là một trong những giá trị sau:
unsetValue

boolean

Nếu bạn không đặt trường này, thì giá trị sẽ là true.
longTextValue

string

Đặt giá trị văn bản dài.
textValue

string

Đặt giá trị văn bản.
textListValue

object (TextListValue)

Đặt giá trị danh sách văn bản.
selectionValue

object (SelectionValue)

Đặt giá trị lựa chọn bằng cách chọn một giá trị duy nhất trong trình đơn thả xuống.
selectionListValue

object (SelectionListValue)

Đặt giá trị danh sách lựa chọn bằng cách chọn nhiều giá trị trong một trình đơn thả xuống.
integerValue

string (int64 format)

Đặt giá trị số nguyên.
userValue

object (UserValue)

Đặt giá trị người dùng bằng cách chọn một người dùng duy nhất.
userListValue

object (UserListValue)

Đặt giá trị danh sách người dùng bằng cách chọn nhiều người dùng.
dateValue

object (Date)

Đặt giá trị ngày.

TextListValue

Đặt giá trị danh sách văn bản.

Biểu diễn dưới dạng JSON 
{
  "values": [
    string
  ]
}
Trường
values[]

string

activities.list of text values.

SelectionValue

Đặt giá trị lựa chọn bằng cách chọn một giá trị duy nhất trong trình đơn thả xuống.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
Trường
id

string

Giá trị nhận dạng của lựa chọn.
displayName

string

Tên hiển thị của lựa chọn.
badged

boolean

Lựa chọn có được gắn huy hiệu hay không.

SelectionListValue

Đặt giá trị danh sách lựa chọn bằng cách chọn nhiều giá trị trong một trình đơn thả xuống.

Biểu diễn dưới dạng JSON 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
Trường
values[]

object (SelectionValue)

activities.list of selections.

UserValue

Đặt giá trị người dùng bằng cách chọn một người dùng duy nhất.

Biểu diễn dưới dạng JSON 
{
  "email": string
}
Trường
email

string

Email của người dùng.

UserListValue

Đặt giá trị danh sách người dùng bằng cách chọn nhiều người dùng.

Biểu diễn dưới dạng JSON 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
Trường
values[]

object (UserValue)

activities.list of users.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Dương lịch. Nội dung đặc tả này có thể xuất hiện dưới dạng một trong những nội dung sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với giá trị ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 nếu chỉ chỉ định giá trị năm, hoặc một năm và tháng, trong đó ngày là không quan trọng.

Lý do

Lý do áp dụng nhãn/trường.

Biểu diễn dưới dạng JSON 
{
  "reasonType": string
}
Trường
reasonType

string

Loại lý do.