Method: resources.calendars.list

เรียกรายการทรัพยากรปฏิทินของบัญชี

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customer

string

รหัสที่ไม่ซ้ำกันสำหรับบัญชี Google Workspace ของลูกค้า ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้ชื่อแทน my_customer เพื่อแสดงรหัสลูกค้าของบัญชีได้ด้วย

พารามิเตอร์การค้นหา

พารามิเตอร์
maxResults

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง

orderBy

string

ฟิลด์สำหรับจัดเรียงผลลัพธ์ตามลำดับจากน้อยไปมากหรือมากไปน้อย ช่องที่รองรับ ได้แก่ resourceId, resourceName, capacity, buildingId และ floorName หากไม่ได้ระบุลำดับไว้ ค่าเริ่มต้นจะเป็นจากน้อยไปมาก ควรอยู่ในรูปแบบ "ฟิลด์ [asc|desc], ฟิลด์ [asc|desc], ..." ตัวอย่างเช่น buildingId, capacity desc จะส่งกลับผลลัพธ์ที่จัดเรียงตาม buildingId ก่อน แล้วตามด้วย capacity ในลำดับจากมากไปน้อย

pageToken

string

โทเค็นเพื่อระบุหน้าถัดไปในรายการ

query

string

การค้นหาสตริงที่ใช้กรองผลการค้นหา ควรอยู่ในรูปแบบ "ค่าโอเปอเรเตอร์ฟิลด์" โดยที่ฟิลด์สามารถเป็นฟิลด์ใดๆ ที่สนับสนุน และโอเปอเรเตอร์อาจเป็นการดำเนินการที่สนับสนุนใดก็ได้ โอเปอเรเตอร์มี '=' สำหรับการทำงานแบบตรงทั้งหมด, '!=' สำหรับการจับคู่ที่ไม่ตรงกัน และ ':' สำหรับการจับคู่คำนำหน้า หรือ เกี่ยวข้องตรงกัน สำหรับการจับคู่คำนำหน้า ค่าควรตามด้วย * เสมอ รองรับโอเปอเรเตอร์ตรรกะ NOT และ AND (ตามลำดับความสำคัญนี้) ช่องที่รองรับ ได้แก่ generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail, resourceCategory เช่น buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

API สาธารณะ: Resources.calendars

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (CalendarResource)
    }
  ],
  "nextPageToken": string
}
ช่อง
kind

string

ระบุว่าเป็นคอลเล็กชันของ CalendarResources นี่คือ admin#directory#resources#calendars#calendarResourcesList เสมอ

etag

string

ETag ของทรัพยากร

items[]

object (CalendarResource)

CalendarResources ในหน้าผลการค้นหานี้

nextPageToken

string

โทเค็นความต่อเนื่อง ซึ่งใช้เพื่อไปยังหน้าผ่านชุดผลลัพธ์ขนาดใหญ่ ระบุค่านี้ในคำขอที่ตามมาเพื่อแสดงหน้าถัดไปของผลลัพธ์

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์