- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- DeletionType
- Wypróbuj
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 |
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 |
Ta właściwość jest wymagana. |
Parametry zapytania
Parametry | |
---|---|
deletionType |
Ciąg zapytania |
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 |
Wartość nagłówka HTTP Content-Type określająca typ treści treści. |
data |
Treść żądania/odpowiedzi HTTP w postaci nieprzetworzonego pliku binarnego. Ciąg zakodowany w formacie base64. |
extensions[] |
Metadane odpowiedzi aplikacji. W przypadku strumieniowych interfejsów API muszą być przesłane w pierwszej odpowiedzi. Obiekt zawierający pola dowolnego typu. Dodatkowe pole |
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. |