Method: projects.histories.list

แสดงรายการประวัติสำหรับโครงการที่กำหนด

ประวัติจะถูกจัดเรียงตามเวลาที่แก้ไขโดยเรียงลำดับจากมากไปหาน้อย ปุ่ม historyId จะถูกใช้เพื่อเรียงลำดับประวัติโดยมีเวลาแก้ไขเท่ากัน

อาจส่งคืนรหัสข้อผิดพลาดตามรูปแบบบัญญัติต่อไปนี้:

  • PERMISSION_DENIED - หากผู้ใช้ไม่ได้รับอนุญาตให้อ่านโครงการ
  • INVALID_ARGUMENT - หากคำขอมีรูปแบบไม่ถูกต้อง
  • NOT_FOUND - หากไม่มีประวัติ

คำขอ HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

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

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

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

string

รหัสโครงการ

ที่จำเป็น.

พารามิเตอร์แบบสอบถาม

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

string

โทเค็นต่อเนื่องเพื่อดำเนินการค้นหาต่อในรายการถัดไป

ไม่จำเป็น.

pageSize

integer

จำนวนประวัติสูงสุดที่จะดึงข้อมูล

ค่าเริ่มต้น: 20 เซิร์ฟเวอร์จะใช้ค่าเริ่มต้นนี้หากไม่ได้ตั้งค่าฟิลด์หรือมีค่าเป็น 0 ค่าใดๆ ที่มากกว่า 100 จะถือเป็น 100

ไม่จำเป็น.

filterByName

string

หากตั้งค่าไว้ ให้ส่งคืนเฉพาะประวัติที่มีชื่อที่กำหนดเท่านั้น

ไม่จำเป็น.

ขอร่างกาย

เนื้อความของคำขอจะต้องว่างเปล่า

ร่างกายตอบสนอง

ข้อความตอบกลับสำหรับ HistoryService.List

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

การเป็นตัวแทน JSON
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
เขตข้อมูล
histories[]

object ( History )

ประวัติศาสตร์

nextPageToken

string

โทเค็นต่อเนื่องเพื่อดำเนินการค้นหาต่อในรายการถัดไป

จะถูกตั้งค่าก็ต่อเมื่อมีประวัติให้ดึงข้อมูลมากกว่านี้

โทเค็นใช้งานได้สูงสุดหนึ่งชั่วโมงนับจากเวลาที่ขอรายการแรก ตัวอย่างเช่น หากคุณส่งคำขอรายการเวลา 13.00 น. และใช้โทเค็นจากคำขอแรกนี้ในอีก 10 นาทีต่อมา โทเค็นจากการตอบกลับครั้งที่สองนี้จะใช้งานได้เพียง 50 นาทีเท่านั้น

ขอบเขตการอนุญาต

ต้องมีขอบเขต OAuth ต่อไปนี้:

  • https://www.googleapis.com/auth/cloud-platform

สำหรับข้อมูลเพิ่มเติม โปรดดู ภาพรวมการตรวจสอบสิทธิ์