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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.

نص الطلب

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

نص الاستجابة

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