مقدمة: إنشاء المركبات

طلبات المركبات

بالنسبة إلى إمكانات الرحلات عند الطلب والمهام المجدوَلة، يمكنك إنشاء مركبة وتعديلها عن طريق إرسال رسالة طلب تتضمّن حقولاً، كما هو موضّح أدناه:

1. العنصر الرئيسي: هو سلسلة مرتبطة برقم تعريف مشروعك على Google Cloud، وتُستخدم لملء حقل الاسم في مثيل المركبة.

2. رقم تعريف المركبة: هو سلسلة فريدة تُستخدم لملء name حقل المركبة.

3. مثيل مركبة يتضمّن الحقول المطلوبة. تعتمد هذه الحقول على إمكانية Fleet Engine التي تستخدمها.

تختلف المعلومات في نص الطلب حسب طبيعة الطلب. يمكنك الاطّلاع على هذه التفاصيل في الأدلة الخاصة بها.

رموز المصادقة والتفويض المميّزة

يجب أن تتضمّن الطلبات إلى Fleet Engine أيضًا بيانات الاعتماد الصحيحة للوصول. تستند الأمثلة في هذا الدليل إلى الافتراضات التالية:

• تفترض أمثلة gRPC استخدام مكتبة التفويض لـ Java.
• توضّح أمثلة REST عنوان طلب HTTP، الذي يجب أن يحتوي على الحقل Authorization بقيمة Bearer <token>، حيث <token> هو رمز JSON المميّز على الويب الذي تصدره.

لمزيد من التفاصيل، يُرجى الاطّلاع على أدلة إعداد Fleet Engine.

حقول مورد المركبة

يحتوي مورد المركبة على الأنواع التالية من الحقول:

• الحقول التي تعرض النتائج فقط : هي الحقول التي تضبطها الخدمة كناتج لطريقة أخرى ولا يمكن ضبطها مباشرةً. أحد الحقول المهمة من هذا النوع هو حقل name. يتجاهل Fleet Engine أي قيمة يتم تقديمها للحقل name في المركبة وفقًا لإرشادات Google AIP لأرقام التعريف التي يحدّدها المستخدم. إذا قدّمت قيمًا لهذه الحقول، سيعرض Fleet Engine خطأً.
• الحقول المطلوبة : تتطلب المركبات التي يتم إنشاؤها في خدمة الرحلات عند الطلب ضبط حقول معيّنة عند الإنشاء. لا تحتوي المركبات التي يتم إنشاؤها في خدمة المهام المجدوَلة على أي حقول مطلوبة لمورد المركبة.
• الحقول الاختيارية : تحتوي كلتا الخدمتَين على حقول يمكنك ضبطها عند الإنشاء أو بعد ذلك. يمكنك العثور عليها في الدليل المرجعي الخاص بالخدمة التي تستخدمها.

اسم المركبة (النتائج فقط)

يتطابق حقل name تمامًا مع خدمات الرحلات عند الطلب والمهام المجدوَلة. يحدّد Fleet Engine الحقل عند إنشاء المركبة، استنادًا إلى حقلَين تضبطهما عند إنشاء المركبة:

• العنصر الرئيسي: هو سلسلة مرتبطة برقم تعريف مشروعك على Google Cloud بالتنسيق providers/{provider}، حيث {provider} هو رقم تعريف مشروعك على السحابة الإلكترونية. سيكون لكل مركبة تنشئها لمشروع معيّن مسار العنصر الرئيسي نفسه.

  يجب أن يحتوي مشروع السحابة الإلكترونية الذي تشير إليه هنا أيضًا على أدوار حساب خدمة Fleet Engine للخدمة التي تستخدمها. يُرجى الاطّلاع على حسابات الخدمة للحصول على قائمة بحسابات الخدمة هذه. لا يتيح Fleet Engine الوصول من مشاريع Google Cloud متعددة.

• رقم تعريف المركبة: يجب أن يكون فريدًا بين جميع المركبات في أسطولك وأن يكون سلسلة Unicode صالحة. هذا هو رقم تعريف المورد للمركبة. تستخدم كلتا الخدمتَين هذا الرقم لربط رحلة أو مهمة بالمركبة التي تُكملها.

في الخدمات المستندة إلى Google Cloud، يجب أن تمثّل جميع واجهات برمجة التطبيقات الموارد كسلاسل. لمزيد من التفاصيل، يُرجى الاطّلاع على تسمية الموارد في Fleet Engine.

معرّفات الكيانات الفريدة

يكون تنسيق وقيمة معرّفات الكيانات الفريدة المستخدَمة في طلبات الموارد غير مرئية لـ Fleet Engine. تأكَّد من أنّ المعرّف لا يحتوي على أي معلومات تكشف الهوية الشخصية (PII)، مثل رقم هاتف السائق.

إعادة استخدام المركبات

بعد أن تُكمل المركبة جميع المحطات في مسار معيّن، تظل متاحة لإعادة استخدامها في Fleet Engine لمدة 7 أيام، ما يعني أنّه يمكنك إعادة استخدام المركبة في أيام العمل اللاحقة بدون الحاجة إلى إنشاء مركبة جديدة. في كل مرة تعيد فيها استخدام مركبة، يعيد Fleet Engine ضبط مدى توفّرها، وعند هذه النقطة يبدأ العد التنازلي لمدة 7 أيام من جديد.

النهج المقترَح لإبقاء المركبة متاحة في Fleet Engine هو تعديل موقعها الجغرافي على فترات منتظمة. ستؤدي التعديلات على معظم الحقول الأخرى في كيان Vehicle أيضًا إلى تمديد مدة صلاحيته، شرط أن تكون قيمة الحقل الجديدة مختلفة عن القيمة الحالية.

ملاحظة: بعض الحقول في كيان Vehicle، مثل device_settings، هي معلومات تصحيح أخطاء فقط لا يحفظها Fleet Engine. لا يؤدي تعديلها إلى تمديد مدة صلاحية كيان Vehicle.

لتحسين إحصاءات النظام، من الأفضل إعادة استخدام الربط نفسه بين رقم تعريف السائق ورقم تعريف المركبة من يوم لآخر. يمكنك إجراء ذلك باستخدام رقم تعريف المركبة نفسه المرتبط بالسائق للمحطات المجدوَلة السابقة أو الرحلات عند الطلب.

الخطوات التالية

• إنشاء مركبة للرحلات عند الطلب
• إنشاء مركبة للمهام المجدوَلة