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

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 email đại diện của my_customer để đại diện cho mã khách hàng của tài khoản.

Tham số truy vấn

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 bạn không chỉ định thứ tự, hệ thống sẽ đặt giá trị mặc định là tăng dần. Phải có dạng "trường [asc|Địa mô tả], trường [asc|Phụ], ...". Ví dụ: buildingId, capacity desc sẽ trả về kết quả được sắp xếp trước 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 ở 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ỳ toán tử nào được hỗ trợ. Các toán tử bao gồm '=' cho kết quả khớp chính xác, '!=' cho kết quả khớp chính xác và ':' cho kết quả khớp tiền tố hoặc HAS dữ liệu nếu có. Đối với kết quả khớp tiền tố, giá trị phải luôn đứng trước *. 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: Resource.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. Giá trị này luôn là admin#directory#resources#calendars#calendarResourcesList.
etag

string

Thẻ 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, đượ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 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 đây:

  • 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 bài viết Hướng dẫn uỷ quyền.