Method: purchases.subscriptionsv2.defer

Odroczenie odnowienia subskrypcji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Pakiet aplikacji, w której zakupiono subskrypcję (np. „com.some.thing”).
token

string

Wymagane. Token przekazany na urządzenie użytkownika w momencie zakupu subskrypcji.

Treść żądania

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

Zapis JSON 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Pola
deferralContext

object (DeferralContext)

Wymagane. Szczegóły odroczenia subskrypcji.

Treść odpowiedzi

Odpowiedź interfejsu API v2 purchases.subscriptions.defer.

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

Zapis JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Pola
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Nowy czas wygaśnięcia poszczególnych elementów subskrypcji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

DeferralContext

Kontekst odroczenia interfejsu API purchases.subscriptionsv2.defer.

Zapis JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Pola
etag

string

Wymagane. Jeśli tag ETag nie będzie zgodny z najnowszym tagiem ETag tej subskrypcji, interfejs API zwróci błąd. Wartość etag jest pobierana z wywołania purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

Wymagane. Okres, o który należy odroczyć wszystkie elementy subskrypcji.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
validateOnly

boolean

Jeśli wartość to „true”, żądanie jest uruchomieniem próbnym, które ma na celu sprawdzenie efektu działania funkcji subscriptionsv2.defer. Nie ma ono wpływu na subskrypcję.

ItemExpiryTimeDetails

Szczegóły czasu wygaśnięcia elementu subskrypcji.

Zapis JSON 
{
  "productId": string,
  "expiryTime": string
}
Pola
productId

string

Identyfikator produktu objętego subskrypcją (np. „premium_plan”).
expiryTime

string (Timestamp format)

Nowy czas wygaśnięcia tego elementu subskrypcji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".