Method: purchases.products.get
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ตรวจสอบสถานะการซื้อและการบริโภคของไอเทมที่ซื้อในแอป
คำขอ HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
packageName |
string
ชื่อแพ็กเกจของแอปพลิเคชันที่จำหน่ายไอเทมที่ซื้อในแอป (เช่น "com.some.thing")
|
productId |
string
SKU ของไอเทมที่ซื้อในแอป (เช่น "com.some.thing.inapp1")
|
token |
string
โทเค็นที่ส่งไปยังอุปกรณ์ของผู้ใช้เมื่อซื้อไอเทมที่ซื้อในแอป
|
เนื้อความของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ProductPurchase
ตัวอย่าง
ตัวอย่างคําขอมีดังนี้
curl \
-X GET \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/exampleSKU/tokens/exampleToken' \
-H 'Accept: application/json'
ตัวอย่างคำตอบมีดังนี้
{
"kind": "androidpublisher#productPurchase",
"purchaseTimeMillis": "1678886400000",
"purchaseState": 0,
"consumptionState": 0,
"developerPayload": "sample developer payload",
"orderId": "GPA.1234-5678-9012-34567",
"purchaseType": 0,
"acknowledgementState": 0,
"productId": "com.example.app.productId",
"purchaseToken": "purchase token",
"quantity": 1,
"refundableQuantity": 1,
"regionCode": "US",
"obfuscatedExternalAccountId": "obfuscated external account id",
"obfuscatedExternalProfileId": "obfuscated external profile id"
}
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 2025-07-26 UTC"],[[["\u003cp\u003eThis operation checks the purchase and consumption status of an in-app product.\u003c/p\u003e\n"],["\u003cp\u003eIt requires an HTTP GET request to a specific URL with the package name, product ID, and purchase token.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response provides details about the product purchase.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document outlines the process to check the status of an in-app purchase. It uses a `GET` HTTP request to a specific URL, structured with `packageName`, `productId`, and `token` as path parameters. The request body must be empty. A successful request returns a `ProductPurchase` instance in the response body. The operation requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope for authorization. It includes instructions to obtain a purchase status.\n"],null,["# Method: purchases.products.get\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nChecks the purchase and consumption status of an inapp item.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path 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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ProductPurchase](/android-publisher/api-ref/rest/v3/purchases.products#ProductPurchase).\n\n### Sample\n\nThe following is a sample request: \n\n```json\ncurl \\\n -X GET \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/exampleSKU/tokens/exampleToken' \\\n -H 'Accept: application/json'\n```\n\nThe following is a sample response: \n\n```json\n{\n \"kind\": \"androidpublisher#productPurchase\",\n \"purchaseTimeMillis\": \"1678886400000\",\n \"purchaseState\": 0,\n \"consumptionState\": 0,\n \"developerPayload\": \"sample developer payload\",\n \"orderId\": \"GPA.1234-5678-9012-34567\",\n \"purchaseType\": 0,\n \"acknowledgementState\": 0,\n \"productId\": \"com.example.app.productId\",\n \"purchaseToken\": \"purchase token\",\n \"quantity\": 1,\n \"refundableQuantity\": 1,\n \"regionCode\": \"US\",\n \"obfuscatedExternalAccountId\": \"obfuscated external account id\",\n \"obfuscatedExternalProfileId\": \"obfuscated external profile id\"\n}\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
