Method: loyaltyobject.addmessage
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يضيف هذا الخيار رسالة إلى عنصر الولاء الذي يشير إليه رقم تعريف العنصر المحدّد.
طلب HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/loyaltyObject/{resourceId}/addMessage
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
resourceId |
string
تمثّل هذه السمة المعرّف الفريد للعنصر. ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. يجب أن يحتوي المعرّف الفريد على أحرف أبجدية رقمية فقط، مثل "." أو "_" أو "-".
|
نص الطلب
يحتوي نص الطلب على مثال AddMessageRequest
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
resource |
object (LoyaltyObject )
مرجع loyaltyObject الذي تم تعديله
|
نطاقات الأذونات
يجب توفير نطاق 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 loyalty object using its object ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a POST method and uses the object ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eAddMessageRequest\u003c/code\u003e and the response will contain the updated \u003ccode\u003eLoyaltyObject\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using the \u003ccode\u003ehttps://www.googleapis.com/auth/wallet_object.issuer\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["The core action is adding a message to a loyalty object using a `POST` request to the specified URL, incorporating gRPC Transcoding syntax. The request requires a unique `resourceId` (issuer ID.identifier) in the path. The request body utilizes the `AddMessageRequest` instance. Upon success, the response returns an updated `LoyaltyObject` resource, represented in JSON format, under the \"resource\" field. The operation requires `https://www.googleapis.com/auth/wallet_object.issuer` authorization scope.\n"],null,["# Method: loyaltyobject.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.LoyaltyObjectAddMessageResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nAdds a message to the loyalty object referenced by the given object ID.\n\n### HTTP request\n\n`POST https://walletobjects.googleapis.com/walletobjects/v1/loyaltyObject/{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/loyaltyobject#LoyaltyObject) } } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------|\n| `resource` | `object (`[LoyaltyObject](/wallet/reference/rest/v1/loyaltyobject#LoyaltyObject)`)` The updated LoyaltyObject resource. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`"]]