Method: transitobject.addmessage
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يضيف هذا الخيار رسالة إلى عنصر النقل العام المشار إليه من خلال رقم تعريف العنصر المحدّد.
طلب HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/addMessage
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
resourceId |
string
تمثّل هذه السمة المعرّف الفريد للعنصر. ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. يجب أن يحتوي المعرّف الفريد على أحرف أبجدية رقمية فقط، مثل "." أو "_" أو "-".
|
نص الطلب
يحتوي نص الطلب على مثال AddMessageRequest.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
resource |
object (TransitObject)
مورد TransitObject الذي تم تعديله
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/wallet_object.issuer
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAdds a message to an existing transit object using its unique identifier.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires an \u003ccode\u003eAddMessageRequest\u003c/code\u003e object in the body and uses the object ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the updated \u003ccode\u003eTransitObject\u003c/code\u003e with the new message included.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/wallet_object.issuer\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines adding a message to a transit object via a `POST` request to a specific URL using gRPC Transcoding. The request requires a `resourceId` path parameter, formatted as `issuer ID.identifier`. The request body utilizes `AddMessageRequest`. A successful response returns the updated `TransitObject` resource in JSON format, within the \"resource\" field. The operation requires the `https://www.googleapis.com/auth/wallet_object.issuer` OAuth scope for authorization.\n"],null,["# Method: transitobject.addmessage\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.TransitObjectAddMessageResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nAdds a message to the transit object referenced by the given object ID.\n\n### HTTP request\n\n`POST https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/addMessage`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resourceId` | `string` The unique identifier for an object. This ID must be unique across all objects from an issuer. This value should follow the format \u003cvar translate=\"no\"\u003eissuer ID\u003c/var\u003e.\u003cvar translate=\"no\"\u003eidentifier\u003c/var\u003e where the former is issued by Google and latter is chosen by you. Your unique identifier should only include alphanumeric characters, '.', '_', or '-'. |\n\n### Request body\n\nThe request body contains an instance of [AddMessageRequest](/wallet/reference/rest/v1/AddMessageRequest).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------|\n| ``` { \"resource\": { object (/wallet/reference/rest/v1/transitobject#TransitObject) } } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------|\n| `resource` | `object (`[TransitObject](/wallet/reference/rest/v1/transitobject#TransitObject)`)` The updated TransitObject resource. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`"]]
