Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke a subscription purchase for the user.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Pakiet aplikacji, w której przypadku została wykupiona ta subskrypcja (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
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Pola
revocationContext

object (RevocationContext)

Wymagane. dodatkowe informacje o odstąpieniu od subskrypcji;

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi jest pusta.

Przykład

Oto przykładowa prośba:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

RevocationContext

Kontekst odwołania interfejsu purchases.subscriptionsv2.revoke API.

Zapis JSON
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Pola
Pole unii RefundType. Określa typ zwrotu środków, który należy przyznać. W ramach prawidłowego żądania należy podać typ zwrotu środków. RefundType może być tylko jednym z tych elementów:
fullRefund

object (FullRefund)

Opcjonalnie. Używany, gdy użytkownicy powinni otrzymać zwrot pełnej kwoty ostatniego obciążenia za każdy element abonamentu.

proratedRefund

object (ProratedRefund)

Opcjonalnie. Używana, gdy użytkownicy powinni otrzymać zwrot środków w proporcjonalnej wysokości kwoty zapłaconej za subskrypcję na podstawie czasu pozostałego w subskrypcji.

itemBasedRefund

object (ItemBasedRefund)

Opcjonalnie. Używany, gdy należy zwrócić środki za konkretny produkt w ramach subskrypcji z dodatkowymi produktami.

FullRefund

Ten typ nie ma pól.

Służy do określenia, czy typ zwrotu środków w kontekście odwołania to pełny zwrot środków.

ProratedRefund

Ten typ nie ma pól.

Służy do określenia, czy typ zwrotu środków w kontekście odwołania to proporcjonalny zwrot środków.

ItemBasedRefund

Służy do określenia, który konkretny element anulować w subskrypcji zawierającej wiele elementów.

Zapis JSON
{
  "productId": string
}
Pola
productId

string

Wymagane. Jeśli subskrypcja zawiera dodatki, podaj identyfikator produktu dla elementu subskrypcji, którego chcesz anulować.