Method: purchases.subscriptions.defer

Der Kauf eines Abos wird bis zu einem bestimmten Ablaufdatum verschoben.

HTTP-Anfrage

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Der Paketname der Anwendung, für die dieses Abo gekauft wurde (z. B. „com.beispiel.app“).
subscriptionId

string

Die ID des gekauften Abos (z. B. „monthly001“).
token

string

Das Token, das beim Kauf des Abos auf dem Gerät des Nutzers bereitgestellt wurde.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Felder
deferralInfo

object (SubscriptionDeferralInfo)

Die Informationen zum neuen gewünschten Ablaufdatum für das Abo.

Antworttext

Antwort für die API „purchases.subscriptions.defer“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "newExpiryTimeMillis": string
}
Felder
newExpiryTimeMillis

string (int64 format)

Die neue Ablaufzeit für das Abo in Millisekunden seit der Epoche.

Beispiel

Hier ein Beispiel für eine Anfrage:

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

Hier ist eine Beispielantwort:

{
  "newExpiryTimeMillis": "1776004800000"
}

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

SubscriptionDeferralInfo

„SubscriptionDeferralInfo“ enthält die Daten, die erforderlich sind, um den Kauf eines Abos auf einen zukünftigen Ablaufzeitpunkt zu verschieben.

JSON-Darstellung 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Felder
expectedExpiryTimeMillis

string (int64 format)

Die voraussichtliche Ablaufzeit des Abos. Wenn die aktuelle Ablaufzeit für das Abo nicht mit dem hier angegebenen Wert übereinstimmt, erfolgt keine Verzögerung.
desiredExpiryTimeMillis

string (int64 format)

Die gewünschte nächste Ablaufzeit, die dem Abo zugewiesen werden soll, in Millisekunden seit der Epoche. Die angegebene Zeit muss nach dem aktuellen Ablaufdatum des Abos liegen.