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 C.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.

نص الطلب

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

نص الاستجابة

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