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.

مَعلمات المسار

المَعلمات
parent

string

مطلوبة. يجب استخدام التنسيق providers/{provider}. يجب أن يكون موفّر الخدمة هو رقم تعريف المشروع (على سبيل المثال، sample-cloud-project) لمشروع Google Cloud الذي يكون حساب الخدمة الذي يجري هذه المكالمة عضوًا فيه.

معلمات طلب البحث

المَعلمات
header

object (RequestHeader)

عنوان الطلب العادي لـ Fleet Engine.
vehicleId

string

مطلوبة. معرّف المركبة الفريد يخضع للقيود التالية:

  • يجب أن تكون سلسلة Unicode صالحة.
  • الحد الأقصى لعدد الأحرف هو 64 حرفًا.
  • تتم تسويتها وفقًا لنموذج تسوية Unicode.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.

نص الطلب

يحتوي نص الطلب على مثال Vehicle.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Vehicle تم إنشاؤه حديثًا.