Method: purchases.products.acknowledge
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يُقرّ المستخدم بشراء سلعة داخل التطبيق.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
اسم حزمة التطبيق الذي تم بيع المنتج داخله (على سبيل المثال، "com.some.thing").
|
productId |
string
رمز التخزين التعريفي للمنتج داخل التطبيق (على سبيل المثال، "com.some.thing.inapp1").
|
token |
string
الرمز المميّز الذي تم تقديمه لجهاز المستخدم عند شراء المنتج داخل التطبيق.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"developerPayload": string
} |
| الحقول |
developerPayload |
string
الحمولة التي سيتم إرفاقها بعملية الشراء
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
عيّنة
في ما يلي مثال على طلب:
curl \
-X POST \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/com.example.app.inapp1/tokens/exampletoken:acknowledge' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
-H 'Content-Type: application/json'
-d '{
"developerPayload": "payload_for_the_purchase"
}'
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAcknowledges a purchase of an in-app product using the provided product and package information.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003epackageName\u003c/code\u003e, \u003ccode\u003eproductId\u003c/code\u003e, and purchase \u003ccode\u003etoken\u003c/code\u003e as path parameters for identification.\u003c/p\u003e\n"],["\u003cp\u003eOptionally accepts a \u003ccode\u003edeveloperPayload\u003c/code\u003e in the request body for attaching additional data.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eA successful acknowledgement results in an empty response body, confirming the action.\u003c/p\u003e\n"]]],["This document details the process of acknowledging an in-app purchase. It uses a `POST` request to the specified URL, including the `packageName`, `productId`, and `token` as path parameters. The request body requires a JSON structure with a `developerPayload` string. Successful acknowledgement results in an empty response body. This process requires `https://www.googleapis.com/auth/androidpublisher` OAuth scope for authorization. The process includes a try it out functionality.\n"],null,["- [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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAcknowledges a purchase of an inapp item.\n\nHTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` The package name of the application the inapp product was sold in (for example, 'com.some.thing'). |\n| `productId` | `string` The inapp product SKU (for example, 'com.some.thing.inapp1'). |\n| `token` | `string` The token provided to the user's device when the inapp product was purchased. |\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------|\n| ``` { \"developerPayload\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------|\n| `developerPayload` | `string` Payload to attach to the purchase. |\n\nResponse body\n\nIf successful, the response body is empty.\n\nSample\n\nThe following is a sample request: \n\n```json\ncurl \\\n -X POST \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/com.example.app.inapp1/tokens/exampletoken:acknowledge' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \\\n -H 'Content-Type: application/json'\n -d '{\n \"developerPayload\": \"payload_for_the_purchase\"\n }'\n```\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
