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

Tham số
customer

string

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

Tham số
maxResults

integer

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

string

(Các) trường cần 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ì giá trị mặc định sẽ là tăng dần. Phải ở 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 trước theo buildingId theo thứ tự tăng dần, sau đó là 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ỳ thao tác nào được hỗ trợ. Các toán tử bao gồm '=' cho kết quả khớp chính xác, '!=' cho không khớp và ':' để so khớp tiền tố hoặc khớp HAS (nếu có). Để so khớp tiền tố, giá trị phải luôn đứng trước 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: 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 nguồn này là một tập hợp các Tài nguyên Lịch. Thao tác 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 thông qua các tập hợp kết quả lớn. Hãy 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 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.