Method: providers.vehicles.create

یک وسیله نقلیه جدید مرتبط با یک ارائه‌دهنده سهم یا تحویل بر اساس تقاضا را نشان می‌دهد. هر Vehicle باید یک شناسه وسیله نقلیه منحصر به فرد داشته باشد.

هنگام ایجاد یک Vehicle ، فیلدهای Vehicle مورد نیاز است:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

هنگام ایجاد یک Vehicle ، فیلدهای Vehicle زیر نادیده گرفته می شوند:

  • name
  • currentTrips
  • availableCapacity
  • currentRouteSegment
  • currentRouteSegmentEndPoint
  • currentRouteSegmentVersion
  • currentRouteSegmentTraffic
  • route
  • waypoints
  • waypointsVersion
  • remainingDistanceMeters
  • remainingTimeSeconds
  • eta_to_next_waypoint
  • navigationStatus

تمام فیلدهای دیگر اختیاری هستند و در صورت ارائه استفاده می شوند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. باید در قالب providers/{provider} باشد. ارائه‌دهنده باید شناسه پروژه (به عنوان مثال، sample-cloud-project ) پروژه Google Cloud باشد که حساب سرویسی که این تماس را برقرار می‌کند عضوی از آن است.

پارامترهای پرس و جو

مولفه های
header

object ( RequestHeader )

هدر درخواست استاندارد Fleet Engine.

vehicleId

string

ضروری. شناسه منحصر به فرد خودرو مشروط به محدودیت های زیر:

  • باید یک رشته یونیکد معتبر باشد.
  • حداکثر به طول 64 کاراکتر محدود شده است.
  • طبق فرم C عادی سازی یونیکد نرمال شده است.
  • ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».

درخواست بدن

بدنه درخواست شامل نمونه ای از Vehicle است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Vehicle است.