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

การค้นหาสตริงที่ใช้กรองผลการค้นหา ควรอยู่ในรูปแบบ "ค่าโอเปอเรเตอร์ฟิลด์" โดยที่ช่องอาจเป็นช่องใดก็ได้ที่รองรับ และโอเปอเรเตอร์อาจเป็นการดำเนินการที่รองรับก็ได้ โอเปอเรเตอร์รวมถึง '=' สำหรับการทำงานแบบตรงทั้งหมด '!=' สำหรับคำว่า ':' ไม่ตรงกัน และ ':' สำหรับการจับคู่คำนำหน้าหรือการจับคู่ HAS ในกรณีที่เกี่ยวข้อง สำหรับการจับคู่คำนำหน้า ค่าควรตามด้วย * เสมอ ระบบรองรับโอเปอเรเตอร์ตรรกะ 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

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