Method: resources.calendars.list

Truy xuất danh sách tài nguyên lịch cho 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

Các tham số
customer

string

Mã nhận dạng duy nhấ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

Các tham số
maxResults

integer

Số 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 không có thứ tự nào được chỉ định, giá trị mặc định là tăng dần. Biểu mẫu phải có dạng "trường [asc|desc], trường [asc|desc], ...". Ví dụ: buildingId, capacity desc sẽ trả về kết quả được sắp xếp đầu tiên theo buildingId theo thứ tự tăng dần rồi đến 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 được dùng để lọc kết quả. Phải có dạng "giá trị toán tử trường" trong đó 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ỳ hoạt động được hỗ trợ nào. Toán tử bao gồm '=' cho khớp chính xác, '!=' cho không khớp và ':' cho khớp tiền tố hoặc HAS khớp, nếu có. Đối với đối sánh tiền tố, giá trị phải luôn được theo sau bởi dấu *. 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
}
Các trường
kind

string

Nhận dạng đây là một tập hợp của CalendarResources. Đâ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 thông qua các tập hợp kết quả lớn. Cung cấp giá trị này trong yêu cầu tiếp theo để trả về trang kết quả tiếp theo.

Phạm vi ủy 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 ủy quyền.