Method: giftcardobject.addmessage
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتم إضافة رسالة إلى عنصر بطاقة الهدايا المُشار إليه من خلال رقم تعريف العنصر المحدّد.
طلب HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject/{resourceId}/addMessage
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
resourceId |
string
تمثّل هذه السمة المعرّف الفريد للعنصر. ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. يجب أن يحتوي المعرّف الفريد على أحرف أبجدية رقمية فقط، مثل "." أو "_" أو "-".
|
نص الطلب
يحتوي نص الطلب على مثال AddMessageRequest.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
resource |
object (GiftCardObject)
مورد GiftCardObject المعدَّل.
|
نطاقات الأذونات
يجب توفير نطاق 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 gift card object using the object ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an AddMessageRequest as defined in the provided documentation.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the updated GiftCardObject resource.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality requires the \u003ccode\u003ehttps://www.googleapis.com/auth/wallet_object.issuer\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This content outlines the process of adding a message to a gift card object. It uses a `POST` HTTP request to `https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject/{resourceId}/addMessage`, requiring a unique `resourceId` path parameter. The request body should be an `AddMessageRequest`, and a successful response returns an updated `GiftCardObject`. Authorization requires the `https://www.googleapis.com/auth/wallet_object.issuer` OAuth scope. The `resourceId` is constructed from the issuer's ID and the user's identifier.\n"],null,["# Method: giftcardobject.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.GiftCardObjectAddMessageResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nAdds a message to the gift card object referenced by the given object ID.\n\n### HTTP request\n\n`POST https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject/{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/giftcardobject#GiftCardObject) } } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `resource` | `object (`[GiftCardObject](/wallet/reference/rest/v1/giftcardobject#GiftCardObject)`)` The updated GiftCardObject resource. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`"]]
