Method: providers.vehicles.updateAttributes
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم تعديل سمات المركبة جزئيًا. سيتم تعديل السمات المذكورة في الطلب فقط، ولن يتم تغيير السمات الأخرى. ملاحظة: تختلف هذه القاعدة في vehicles.update، إذ سيتم استبدال الحقل attributes بالكامل بالحقل في UpdateVehicleRequest، وستتم إزالة السمات غير المضمّنة في الطلب.
طلب HTTP
POST https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}:updateAttributes
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. يجب أن يكون بالتنسيق providers/{provider}/vehicles/{vehicle}. يجب أن يكون مقدّم الخدمة هو رقم تعريف المشروع (مثل sample-cloud-project) الخاص بالمشروع على Google Cloud الذي ينتمي إليه حساب الخدمة الذي يجري هذه المكالمة.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
header |
object (RequestHeader)
عنوان طلب Fleet Engine العادي.
|
attributes[] |
object (VehicleAttribute)
مطلوب. سمات المركبة المطلوب تعديلها. ولا يتم تعديل أو إزالة السمات غير المذكورة.
|
نص الاستجابة
رسالة رد واحدة (vehicles.updateAttributes).
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
attributes[] |
object (VehicleAttribute)
مطلوب. القائمة الكاملة لسمات المركبات، بما في ذلك السمات الجديدة والمعدّلة والتي لم يتم تغييرها
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ePartially updates a vehicle's attributes, only changing the attributes specified in the request.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003ePOST\u003c/code\u003e method and the \u003ccode\u003ehttps://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}:updateAttributes\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequires a request body containing a \u003ccode\u003eRequestHeader\u003c/code\u003e and an array of \u003ccode\u003eVehicleAttributes\u003c/code\u003e to update.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the complete, updated list of vehicle attributes.\u003c/p\u003e\n"],["\u003cp\u003eDiffers from \u003ccode\u003evehicles.update\u003c/code\u003e by only modifying provided attributes, instead of replacing the entire \u003ccode\u003eattributes\u003c/code\u003e field.\u003c/p\u003e\n"]]],[],null,["# Method: providers.vehicles.updateAttributes\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.UpdateVehicleAttributesResponse.SCHEMA_REPRESENTATION)\n\nPartially updates a vehicle's attributes. Only the attributes mentioned in the request will be updated, other attributes will NOT be altered. Note: this is different in `vehicles.update`, where the whole `attributes` field will be replaced by the one in `UpdateVehicleRequest`, attributes not in the request would be removed.\n\n### HTTP request\n\n`POST https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}:updateAttributes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Must be in the format `providers/{provider}/vehicles/{vehicle}`. The provider must be the Project ID (for example, `sample-cloud-project`) of the Google Cloud Project of which the service account making this call is a member. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"header\": { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/RequestHeader) }, \"attributes\": [ { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#VehicleAttribute) } ] } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[RequestHeader](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/RequestHeader)`)` The standard Fleet Engine request header. |\n| `attributes[]` | `object (`[VehicleAttribute](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#VehicleAttribute)`)` Required. The vehicle attributes to update. Unmentioned attributes are not altered or removed. |\n\n### Response body\n\n`vehicles.updateAttributes` response message.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"attributes\": [ { object (/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#VehicleAttribute) } ] } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `attributes[]` | `object (`[VehicleAttribute](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.vehicles#VehicleAttribute)`)` Required. The updated full list of vehicle attributes, including new, altered, and untouched attributes. |"]]
