Method: purchases.subscriptionsv2.defer

Verschiebt die Verlängerung eines Abos.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
packageName

string

Erforderlich. Das Paket der Anwendung, für die dieses Abo gekauft wurde (z. B. „com.some.thing“).
token

string

Erforderlich. 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 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Felder
deferralContext

object (DeferralContext)

Erforderlich. Details zur Abo-Stundung.

Antworttext

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

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

JSON-Darstellung 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Felder
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Die neue Ablaufzeit für die einzelnen Abo-Artikel.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

DeferralContext

Aufschiebungs-Kontext der API „purchases.subscriptionsv2.defer“.

JSON-Darstellung 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Felder
etag

string

Erforderlich. Die API schlägt fehl, wenn das ETag nicht mit dem neuesten ETag für dieses Abo übereinstimmt. Das ETag wird über „purchases.subscriptionsv2.get“ abgerufen: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

Erforderlich. Die Dauer, um die alle Abo-Artikel verschoben werden sollen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
validateOnly

boolean

Wenn der Wert auf „true“ gesetzt ist, handelt es sich bei der Anfrage um einen Testlauf, um die Auswirkungen von „subscriptionsv2.defer“ zu validieren. Das Abo ist davon nicht betroffen.

ItemExpiryTimeDetails

Details zum Ablaufdatum eines Aboartikels.

JSON-Darstellung 
{
  "productId": string,
  "expiryTime": string
}
Felder
productId

string

Die Produkt-ID des Aboartikels (z. B. „premium_plan“).
expiryTime

string (Timestamp format)

Die neue Ablaufzeit für dieses Abo-Artikel.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".