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

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

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