Method: externaltransactions.getexternaltransaction
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}
网址采用 gRPC 转码语法。
路径参数
参数 |
name |
string
必需。要检索的外部交易的名称。格式:applications/{packageName}/externalTransactions/{externalTransaction}
|
响应正文
如果成功,则响应正文包含一个 ExternalTransaction
实例。
示例
以下是一个示例请求:
```
curl \
-X GET \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/1234567890' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'
```
以下是示例响应:
{
"createTime": "2023-04-06T13:48:11.694Z",
"currentPreTaxAmount": {
"currency": "USD",
"priceMicros": "12000000"
},
"currentTaxAmount": {
"currency": "USD",
"priceMicros": "1200000"
},
"externalTransactionId": "ext-trans-id-123",
"oneTimeTransaction": {
"externalTransactionToken": "one-time-token-456"
},
"originalPreTaxAmount": {
"currency": "USD",
"priceMicros": "15000000"
},
"originalTaxAmount": {
"currency": "USD",
"priceMicros": "1500000"
},
"packageName": "com.example.app",
"recurringTransaction": {
"externalSubscription": {
"subscriptionType": "RECURRING"
},
"externalTransactionToken": "recurring-token-789",
"initialExternalTransactionId": "ext-trans-id-001",
"otherRecurringProduct": {}
},
"testPurchase": {},
"transactionProgramCode": 11,
"transactionState": "TRANSACTION_REPORTED",
"transactionTime": "2023-04-06T14:00:00.000Z",
"userTaxAddress": {
"regionCode": "US"
}
}
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidpublisher
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eRetrieves an existing external transaction using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ename\u003c/code\u003e path parameter to specify the application package and external transaction ID.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is necessary, and a successful response returns an \u003ccode\u003eExternalTransaction\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details retrieving an existing external transaction via a `GET` request to a specific URL: `https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}`. The `name` path parameter is required, specifying the transaction's identifier (format: `applications/{packageName}/externalTransactions/{externalTransaction}`). The request body must be empty. A successful request returns an `ExternalTransaction` instance. The necessary authorization scope is `https://www.googleapis.com/auth/androidpublisher`.\n"],null,["# Method: externaltransactions.getexternaltransaction\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\nGets an existing external transaction.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the external transaction to retrieve. Format: applications/{packageName}/externalTransactions/{externalTransaction} |\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 [ExternalTransaction](/android-publisher/api-ref/rest/v3/externaltransactions#ExternalTransaction).\n\n### Sample\n\nThe following is a sample request: \n\n````json\n```\ncurl \\\n -X GET \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/1234567890' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'\n```\n````\n\nThe following is a sample response: \n\n```json\n{\n \"createTime\": \"2023-04-06T13:48:11.694Z\",\n \"currentPreTaxAmount\": {\n \"currency\": \"USD\",\n \"priceMicros\": \"12000000\"\n },\n \"currentTaxAmount\": {\n \"currency\": \"USD\",\n \"priceMicros\": \"1200000\"\n },\n \"externalTransactionId\": \"ext-trans-id-123\",\n \"oneTimeTransaction\": {\n \"externalTransactionToken\": \"one-time-token-456\"\n },\n \"originalPreTaxAmount\": {\n \"currency\": \"USD\",\n \"priceMicros\": \"15000000\"\n },\n \"originalTaxAmount\": {\n \"currency\": \"USD\",\n \"priceMicros\": \"1500000\"\n },\n \"packageName\": \"com.example.app\",\n \"recurringTransaction\": {\n \"externalSubscription\": {\n \"subscriptionType\": \"RECURRING\"\n },\n \"externalTransactionToken\": \"recurring-token-789\",\n \"initialExternalTransactionId\": \"ext-trans-id-001\",\n \"otherRecurringProduct\": {}\n },\n \"testPurchase\": {},\n \"transactionProgramCode\": 11,\n \"transactionState\": \"TRANSACTION_REPORTED\",\n \"transactionTime\": \"2023-04-06T14:00:00.000Z\",\n \"userTaxAddress\": {\n \"regionCode\": \"US\"\n }\n}\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]