Method: providers.tasks.batchCreate

새 Task 객체를 일괄적으로 만들고 반환합니다.

HTTP 요청

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate

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

경로 매개변수

매개변수
parent

string

필수입니다. 모든 태스크에서 공유하는 상위 리소스입니다. 이 값은 providers/{provider} 형식이어야 합니다. provider는 Google Cloud 프로젝트 ID여야 합니다. sample-cloud-project를 예로 들 수 있습니다. CreateTaskRequest 메시지의 상위 필드는 비어 있거나 이 필드와 일치해야 합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
필드
header

object (DeliveryRequestHeader)

선택사항입니다. 표준 Delivery API 요청 헤더입니다. 참고: 이 필드를 설정하면 CreateTaskRequest 메일의 헤더 필드가 비어 있거나 이 필드와 일치해야 합니다.
requests[]

object (CreateTaskRequest)

필수입니다. 만들 리소스를 지정하는 요청 메시지입니다. 참고: 한 번에 최대 500개의 태스크를 만들 수 있습니다.

응답 본문

BatchCreateTask 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
필드
tasks[]

object (Task)

생성된 할 일

CreateTaskRequest

tasks.create 요청 메시지입니다.

JSON 표현 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
필드
header

object (DeliveryRequestHeader)

선택사항입니다. 표준 Delivery API 요청 헤더입니다.
parent

string

필수입니다. providers/{provider} 형식이어야 합니다. provider는 Google Cloud 프로젝트 ID여야 합니다. sample-cloud-project를 예로 들 수 있습니다.
taskId

string

필수입니다. 작업 ID는 고유해야 하지만 배송 추적 ID가 아니어야 합니다. 배송 추적 ID를 저장하려면 trackingId 필드를 사용합니다. 여러 작업에 동일한 trackingId가 있을 수 있습니다. 작업 ID에는 다음과 같은 제한사항이 적용됩니다.

  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 길이는 64자(영문 기준)입니다.
  • 유니코드 정규화 양식 C에 따라 정규화됩니다.
  • '/', ':', '?', ',', '#'과 같은 ASCII 문자는 포함할 수 없습니다.
task

object (Task)

필수입니다. 만들 태스크 항목입니다. 할 일을 만들 때 다음 필드가 필요합니다.

  • type
  • state (OPEN로 설정해야 함)
  • trackingId (UNAVAILABLE 또는 SCHEDULED_STOP 태스크에는 설정하면 안 되지만 다른 모든 태스크 유형에는 필요)
  • plannedLocation (UNAVAILABLE 작업의 경우 선택사항)
  • taskDuration

다음 필드는 선택적으로 설정할 수 있습니다.

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

참고: 작업의 name 필드는 무시됩니다. 다른 모든 Task 필드는 설정하면 안 됩니다. 그렇지 않으면 오류가 반환됩니다.