Method: subscriptions.delete

Anuluje, zawiesza lub przenosi subskrypcję, aby przekierować ją na konto.

Żądanie HTTP

DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Może to być nazwa domeny podstawowej klienta lub jego unikalny identyfikator. Jeśli nazwa domeny klienta się zmieni, nie będzie można uzyskać dostępu do klienta za pomocą starej nazwy domeny, ale zawsze będzie można użyć niepowtarzalnego identyfikatora klienta (zwróconego przez interfejs API). Zalecamy przechowywanie unikalnego identyfikatora w systemach.

subscriptionId

string

Ta właściwość jest wymagana. subscriptionId to identyfikator subskrypcji, który jest unikalny dla każdego klienta. subscriptionId zmienia się po aktualizacji subskrypcji, dlatego nie zalecamy używania tego identyfikatora jako klucza dla trwałych danych. subscriptionId można znaleźć za pomocą metody Pobierz wszystkie subskrypcje sprzedawcy.

Parametry zapytania

Parametry
deletionType

enum (DeletionType)

Ciąg zapytania deletionType umożliwia anulowanie, przejście na niższą wersję lub zawieszenie subskrypcji.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat dotyczący dowolnej treści HTTP. Powinien być używany wyłącznie w przypadku formatów ładunku, których nie da się zapisać jako JSON, takich jak pliki binarne RAW lub strony HTML.

Komunikat może być używany w żądaniu oraz w odpowiedzi zarówno w strumieniowych, jak i niestrumieniowych metodach API.

Może służyć jako pole żądania najwyższego poziomu, co jest wygodne, gdy chcesz wyodrębnić parametry z szablonu URL lub HTTP i użyć ich w polach żądania oraz gdy potrzebujesz dostępu do treści HTTP w formacie RAW.

Przykład:

message GetResourceRequest {
  // A unique request id.
  string requestId = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

Przykład z metodami strumieniowymi:

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

Użycie tego typu treści zmienia tylko sposób obsługi treści żądania i odpowiedzi – pozostałe funkcje działają bez zmian.

Jeśli operacja się uda, odpowiedź będzie ogólną odpowiedzią HTTP, której format jest zdefiniowany przez tę metodę.

Zapis JSON
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Pola
contentType

string

Wartość nagłówka HTTP Content-Type określająca typ treści treści.

data

string (bytes format)

Treść żądania/odpowiedzi HTTP w postaci nieprzetworzonego pliku binarnego.

Ciąg zakodowany w formacie base64.

extensions[]

object

Metadane odpowiedzi aplikacji. W przypadku strumieniowych interfejsów API muszą być przesłane w pierwszej odpowiedzi.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/apps.order

Więcej informacji znajdziesz w przewodniku po autoryzacji.

DeletionType

Wartości w polu enum
deletion_type_undefined
cancel Natychmiast anuluje subskrypcję. Nie dotyczy to abonamentu G Suite.
transfer_to_direct

Przenosi subskrypcję bezpośrednio do Google. Klient zostanie natychmiast przeniesiony do umowy bezpośredniej płatności z Google i przez krótki czas bez żadnych przerw w działaniu usługi. Klient może skonfigurować rozliczenia bezpośrednio w Google przy użyciu karty kredytowej lub poprosić o przeniesienie płatności do innego sprzedawcy.