Method: resources.calendars.list

Truy xuất danh sách tài nguyên lịch cho một tài khoản.

Yêu cầu HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars

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

Tham số đường dẫn

Thông số
customer

string

Mã nhận dạng riêng biệt cho tài khoản Google Workspace của khách hàng. Là quản trị viên tài khoản, bạn cũng có thể sử dụng bí danh my_customer để đại diện cho mã khách hàng của tài khoản.

Tham số truy vấn

Thông số
maxResults

integer

Số lượng kết quả tối đa cần trả về.
orderBy

string

(Các) trường để sắp xếp kết quả theo thứ tự tăng dần hoặc giảm dần. Các trường được hỗ trợ bao gồm resourceId, resourceName, capacity, buildingId và floorName. Nếu bạn không chỉ định thứ tự, thì hệ thống sẽ mặc định sắp xếp theo thứ tự tăng dần. Phải có dạng "field [asc|desc], field [asc|desc], ...". Ví dụ: buildingId, capacity desc sẽ trả về kết quả được sắp xếp trước tiên theo buildingId theo thứ tự tăng dần, sau đó theo capacity theo thứ tự giảm dần.
pageToken

string

Mã thông báo để chỉ định trang tiếp theo trong danh sách.
query

string

Truy vấn chuỗi dùng để lọc kết quả. Chứa một hoặc nhiều mệnh đề tìm kiếm, mỗi mệnh đề có một trường, toán tử và giá trị. Trường có thể là bất kỳ trường nào được hỗ trợ và toán tử có thể là bất kỳ thao tác nào được hỗ trợ. Các toán tử bao gồm "=" cho kiểu khớp chính xác, "!=" cho kiểu khớp không chính xác và ":" cho kiểu khớp tiền tố hoặc kiểu khớp CÓ (nếu có). Đối với so khớp tiền tố, giá trị phải luôn theo sau dấu *. Các toán tử logic NOT và AND được hỗ trợ (theo thứ tự ưu tiên này). Các trường được hỗ trợ bao gồm generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail, resourceCategory. Ví dụ: buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone.

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

API công khai: Resources.calendars

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 (CalendarResource)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

Xác định đây là một tập hợp CalendarResources. Trạng thái này luôn là admin#directory#resources#calendars#calendarResourcesList.
etag

string

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

object (CalendarResource)

CalendarResources trong trang kết quả này.
nextPageToken

string

Mã thông báo tiếp tục, dùng để phân trang qua các tập kết quả lớn. Cung cấp giá trị này trong một yêu cầu tiếp theo để trả về trang kết quả tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://apps-apis.google.com/a/feeds/calendar/resource/
  • https://www.googleapis.com/auth/admin.directory.resource.calendar
  • https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

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