Method: providers.tasks.search

เลิกใช้งานแล้ว: ใช้ taskTrackingInfo.get แทน

คำขอ HTTP

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:search

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

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

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

string

ต้องระบุ ต้องอยู่ในรูปแบบ providers/{provider} ผู้ให้บริการต้องเป็นรหัสโปรเจ็กต์ Google Cloud เช่น sample-cloud-project

พารามิเตอร์การค้นหา

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

object (DeliveryRequestHeader)

ไม่บังคับ ส่วนหัวของคำขอ Delivery API มาตรฐาน
trackingId

string

ต้องระบุ ตัวระบุของชุดงานที่เกี่ยวข้องที่กำลังร้องขอ รหัสติดตามต้องเป็นไปตามข้อจำกัดต่อไปนี้

  • ต้องเป็นสตริง Unicode ที่ถูกต้อง
  • จำกัดให้มีความยาวสูงสุด 64 อักขระ
  • ได้รับการปรับให้เป็นมาตรฐานตามแบบฟอร์มการปรับมาตรฐาน Unicode C
  • ต้องไม่มีอักขระ ASCII ต่อไปนี้: "/", ":", "?", "," หรือ "#"
pageSize

integer

ไม่บังคับ จำนวนงานสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากคุณไม่ระบุค่านี้ เซิร์ฟเวอร์จะกำหนดจำนวนผลลัพธ์ที่จะแสดง
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการโทร tasks.search ครั้งก่อน คุณต้องระบุค่านี้เพื่อเรียกหน้าถัดไป

ขณะใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้ tasks.search ต้องตรงกับการเรียกที่ระบุโทเค็นของหน้า

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับ tasks.search มีชุดงานที่ตรงกับเกณฑ์การค้นหาใน SearchTasksRequest

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

การแสดง JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string
}
ช่อง
tasks[]

object (Task)

ชุดงานสำหรับ trackingId ที่ขอ การตอบกลับที่สำเร็จจะเว้นว่างไว้ได้ การตอบกลับที่ว่างเปล่าหมายความว่าไม่มีงานที่เชื่อมโยงกับ trackingId ที่ระบุ
nextPageToken

string

ส่งโทเค็นนี้ใน SearchTasksRequest เพื่อแสดงผลลัพธ์ต่อไป หากระบบส่งคืนผลลัพธ์ทั้งหมด ช่องนี้อาจเป็นสตริงว่างเปล่าหรือไม่ปรากฏในการตอบกลับ