주문형 차량 공유 및 배송 솔루션은 현재 일부 파트너만 이용할 수 있습니다. 자세한 내용은 영업팀에 문의하세요.

Method: providers.vehicles.list

요청 옵션과 일치하는 제공업체와 연결된 페이지로 나눈 페이지로 구성된 목록을 반환합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

쿼리 매개변수

매개변수
header

object (RequestHeader)

표준 Fleet Engine 요청 헤더입니다.

pageSize

integer

반환할 최대 차량 수입니다. 기본값은 100입니다.

pageToken

string

차량 그룹을 페이지로 나눌 수 있도록 이전에 vehicles.list를 호출하여 제공한 nextPageToken 값입니다. 요청의 필터 기준이 이전 vehicles.list 호출의 필터 기준과 같지 않으면 값이 정의되지 않습니다.

minimumCapacity

integer

차량의 필수 최소 용량을 지정합니다. 반환된 모든 차량의 maximumCapacity이 이 값보다 크거나 같습니다. 설정할 경우, 0 이상이어야 합니다.

tripTypes[]

enum (TripType)

지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다.

maximumStaleness

string (Duration format)

호출 시 지정된 기간 내에 위치를 업데이트한 차량으로 응답을 제한합니다. 있는 경우 유효한 양의 기간이어야 합니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다. 예: "3.5s"

vehicleTypeCategories[]

enum (Category)

필수 항목입니다. 지정된 유형 카테고리 중 하나가 있는 차량으로 응답을 제한합니다.

requiredAttributes[]

string

호출자는 requiredAttributes, requiredOneOfAttributes, requiredOneOfAttributeSets 필드의 조합을 사용하여 복잡한 논리 연산을 구성할 수 있습니다.

requiredAttributes는 목록입니다. requiredOneOfAttributes는 목록 목록을 허용하는 메시지를 사용합니다. 두 개의 필드를 조합하여 이 표현식의 구성을 허용합니다.

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

지정된 속성이 있는 차량으로 응답을 제한합니다. 이 필드는 결합/AND 작업입니다. 최대 50개의 requiredAttributes가 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 'key:value' 형식이어야 합니다.

requiredOneOfAttributes[]

string

VehicleAttributeList에 지정된 속성 중 하나 이상이 있는 차량으로 응답을 제한합니다. 각 목록 내에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 포괄적 분리/OR 연산과 VehicleAttributeList 컬렉션의 결합/AND 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

requiredOneOfAttributeSets[]

string

requiredOneOfAttributeSets는 추가 기능을 제공합니다.

requiredOneOfAttributes와 마찬가지로 requiredOneOfAttributeSets는 목록 목록을 허용하는 메시지를 사용하여 다음과 같은 표현식을 허용합니다.

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

VehicleAttributeList의 모든 속성과 일치하는 차량으로 응답을 제한합니다. 각 목록 내에서 차량은 모든 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 결합/AND 연산이며 VehicleAttributeList 컬렉션의 포괄적 분리/OR 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

vehicleState

enum (VehicleState)

이 차량 상태가 있는 차량으로 응답을 제한합니다.

onTripOnly

boolean

현재 이동이 있는 차량만 반품합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

vehicles.list 응답 메시지입니다.

JSON 표현
{
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
필드
vehicles[]

object (Vehicle)

요청의 기준과 일치하는 차량입니다. 반환되는 최대 차량 수는 요청의 pageSize 필드에 따라 결정됩니다.

nextPageToken

string

차량의 다음 페이지를 검색하는 토큰이며 요청 기준을 충족하는 차량이 더 이상 없으면 비어 있습니다.

totalSize

string (int64 format)

필수 항목입니다. 모든 페이지에서 요청 기준과 일치하는 총 차량 수입니다.