Method: purchases.subscriptions.defer

Eingestellt: Verwenden Sie stattdessen „purchases.subscriptionsv2.defer“. Verschiebt den Abo-Kauf eines Nutzers auf einen bestimmten zukünftigen Ablaufzeitpunkt.

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.some.thing“).
subscriptionId

string

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

string

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (SubscriptionDeferralInfo)

Informationen zum neuen gewünschten Ablaufdatum des Abos.

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

Ein SubscriptionDeferralInfo-Objekt enthält die Daten, die zum Aufschieben eines Abokaufs auf ein zukünftiges Ablaufdatum erforderlich sind.

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

string (int64 format)

Das voraussichtliche Ablaufdatum des Abos. Wenn die aktuelle Ablaufzeit für das Abo nicht dem hier angegebenen Wert entspricht, erfolgt die Verschiebung nicht.
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 der aktuellen Ablaufzeit des Abos liegen.