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

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