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 프로젝트 ID여야 합니다. 예를 들면 다음과 같습니다. sample-cloud-project

쿼리 매개변수

매개변수
header

object (DeliveryRequestHeader)

선택사항입니다. Standard Delivery API 요청 헤더입니다.
trackingId

string

필수 항목입니다. 요청 중인 관련 작업 세트의 식별자입니다. 추적 ID에는 다음과 같은 제한사항이 적용됩니다.

  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 길이는 64자(영문 기준)로 제한됩니다.
  • 유니코드 정규화 형식 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에 전달합니다. 모든 결과가 반환된 경우 이 필드는 빈 문자열이거나 응답에 표시되지 않습니다.