Method: purchases.subscriptions.defer

Wycofano: zamiast tego użyj purchases.subscriptionsv2.defer. Odroczenie zakupu subskrypcji użytkownika do określonego przyszłego terminu ważności.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Nazwa pakietu aplikacji, w której zakupiono tę subskrypcję (np. „com.some.thing”).

subscriptionId

string

Identyfikator zakupionej subskrypcji (np. „monthly001”).

token

string

Token przekazany na urządzenie użytkownika podczas zakupu subskrypcji.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Pola
deferralInfo

object (SubscriptionDeferralInfo)

Informacje o nowym, oczekiwanym terminie wygaśnięcia subskrypcji.

Treść odpowiedzi

Odpowiedź na wywołanie interfejsu API purchases.subscriptions.defer.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "newExpiryTimeMillis": string
}
Pola
newExpiryTimeMillis

string (int64 format)

Nowy czas wygaśnięcia subskrypcji w milisekundach od początku epoki.

Przykład

Oto przykładowe żądanie:

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'

Oto przykładowa odpowiedź:

{
  "newExpiryTimeMillis": "1776004800000"
}

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo zawiera dane potrzebne do odroczenia zakupu subskrypcji do przyszłego terminu wygaśnięcia.

Zapis JSON
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Pola
expectedExpiryTimeMillis

string (int64 format)

Oczekiwany czas wygaśnięcia subskrypcji. Jeśli bieżący termin wygaśnięcia subskrypcji nie jest wartością podaną w tym polu, odroczenie nie nastąpi.

desiredExpiryTimeMillis

string (int64 format)

Pożądany następny czas wygaśnięcia, który ma zostać przypisany do subskrypcji, w milisekundach od początku epoki. Podany czas musi być późniejszy niż bieżący czas wygaśnięcia subskrypcji.