Method: externaltransactions.createexternaltransaction

יצירת עסקה חיצונית חדשה.

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=applications/*}/externalTransactions

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. משאב ההורה שבו העסקה החיצונית הזו תיווצר. פורמט: applications/{packageName}

פרמטרים של שאילתה

פרמטרים
externalTransactionId

string

חובה. המזהה שישמש לעסקה החיצונית. הערך חייב להיות ייחודי בכל העסקאות האחרות באפליקציה. הערך צריך להיות באורך 1-63 תווים, והתווים התקינים הם /a-zA-Z0-9_-/. אסור להשתמש בשדה הזה כדי לאחסן פרטים אישיים מזהים (PII), כמו כתובות אימייל. ניסיון לאחסן פרטים אישיים מזהים (PII) בשדה הזה עלול לגרום לחסימת הבקשות.

גוף הבקשה

גוף הבקשה מכיל מופע של ExternalTransaction.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של ExternalTransaction.

דוגמה

דוגמה לבקשה:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions?externalTransactionId=exampleExternalTransactionId' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "originalPreTaxAmount": { \
      "currency": "USD", \
      "priceMicros": "1000000" \
    }, \
    "originalTaxAmount": { \
      "currency": "USD", \
      "priceMicros": "100000" \
    }, \
    "transactionTime": "2023-05-05T12:00:00Z", \
    "oneTimeTransaction": { \
      "externalTransactionToken": "token-123" \
    }, \
    "userTaxAddress": { \
      "regionCode": "US" \
    } \
  }'

זוהי דוגמה לתגובה:

{
  "createTime": "2023-04-20T14:23:18.121Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "12000000"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "1200000"
  },
  "externalTransactionId": "ext-trans-id-1234",
  "oneTimeTransaction": {
    "externalTransactionToken": "one-time-token-abc"
  },
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "15000000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "1500000"
  },
  "packageName": "com.example.app",
  "recurringTransaction": {
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    },
    "externalTransactionToken": "recurring-token-xyz",
    "initialExternalTransactionId": "ext-trans-id-5678",
    "otherRecurringProduct": {}
  },
  "testPurchase": {},
  "transactionProgramCode": 11,
  "transactionState": "TRANSACTION_REPORTED",
  "transactionTime": "2023-04-20T14:20:00.000Z",
  "userTaxAddress": {
    "regionCode": "US"
  }
}

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/androidpublisher