แสดงรายการประวัติสำหรับโครงการที่กำหนด
ประวัติจะถูกจัดเรียงตามเวลาที่แก้ไขโดยเรียงลำดับจากมากไปหาน้อย ปุ่ม historyId จะถูกใช้เพื่อเรียงลำดับประวัติโดยมีเวลาแก้ไขเท่ากัน
อาจส่งคืนรหัสข้อผิดพลาดตามรูปแบบบัญญัติต่อไปนี้:
- PERMISSION_DENIED - หากผู้ใช้ไม่ได้รับอนุญาตให้อ่านโครงการ
- INVALID_ARGUMENT - หากคำขอมีรูปแบบไม่ถูกต้อง
- NOT_FOUND - หากไม่มีประวัติ
คำขอ HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories
URL ใช้ไวยากรณ์ การแปลงรหัส gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
projectId | รหัสโครงการ ที่จำเป็น. |
พารามิเตอร์แบบสอบถาม
พารามิเตอร์ | |
---|---|
pageToken | โทเค็นต่อเนื่องเพื่อดำเนินการค้นหาต่อในรายการถัดไป ไม่จำเป็น. |
pageSize | จำนวนประวัติสูงสุดที่จะดึงข้อมูล ค่าเริ่มต้น: 20 เซิร์ฟเวอร์จะใช้ค่าเริ่มต้นนี้หากไม่ได้ตั้งค่าฟิลด์หรือมีค่าเป็น 0 ค่าใดๆ ที่มากกว่า 100 จะถือเป็น 100 ไม่จำเป็น. |
filterByName | หากตั้งค่าไว้ ให้ส่งคืนเฉพาะประวัติที่มีชื่อที่กำหนดเท่านั้น ไม่จำเป็น. |
ขอร่างกาย
เนื้อความของคำขอจะต้องว่างเปล่า
ร่างกายตอบสนอง
ข้อความตอบกลับสำหรับ HistoryService.List
หากสำเร็จ เนื้อหาการตอบสนองจะมีข้อมูลที่มีโครงสร้างดังต่อไปนี้:
การเป็นตัวแทน JSON |
---|
{
"histories": [
{
object ( |
เขตข้อมูล | |
---|---|
histories[] | ประวัติศาสตร์ |
nextPageToken | โทเค็นต่อเนื่องเพื่อดำเนินการค้นหาต่อในรายการถัดไป จะถูกตั้งค่าก็ต่อเมื่อมีประวัติให้ดึงข้อมูลมากกว่านี้ โทเค็นใช้งานได้สูงสุดหนึ่งชั่วโมงนับจากเวลาที่ขอรายการแรก ตัวอย่างเช่น หากคุณส่งคำขอรายการเวลา 13.00 น. และใช้โทเค็นจากคำขอแรกนี้ในอีก 10 นาทีต่อมา โทเค็นจากการตอบกลับครั้งที่สองนี้จะใช้งานได้เพียง 50 นาทีเท่านั้น |
ขอบเขตการอนุญาต
ต้องมีขอบเขต OAuth ต่อไปนี้:
-
https://www.googleapis.com/auth/cloud-platform
สำหรับข้อมูลเพิ่มเติม โปรดดู ภาพรวมการตรวจสอบสิทธิ์