取消、停權或轉移訂閱項目,直接將其導向。
HTTP 要求
DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
可以是客戶的主網域名稱或客戶的專屬 ID。如果客戶的網域名稱有所異動,舊的網域名稱無法用於存取客戶,但客戶的專屬 ID (由 API 傳回) 仍然可以使用。建議你視情況將專屬 ID 儲存在系統中。 |
subscriptionId |
這是必要屬性。 |
查詢參數
參數 | |
---|---|
deletionType |
|
要求主體
要求主體必須為空白。
回應主體
用於表示任何 HTTP 主體的訊息;只能用於無法以 JSON 表示的酬載格式,例如未經處理的二進位檔或 HTML 網頁。
這個訊息可以用於要求及回應中的串流和非串流 API 方法。
這個訊息可以當做頂層要求欄位;想從網址或 HTTP 範本中將參數擷取至要求欄位,同時又想存取未經處理的 HTTP 主體時,這個做法就非常便利。
示例:
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);
}
串流方法範例:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
使用這個類型只會改變要求和回應主體的處理方式,所有其他功能的運作方式皆維持不變。
如果成功,回應是一般的 HTTP 回應,其格式則由方法定義。
JSON 表示法 |
---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
欄位 | |
---|---|
contentType |
HTTP Content-Type 標頭值,用於指定主體的內容類型。 |
data |
做為原始二進位檔的 HTTP 要求/回應主體。 Base64 編碼的字串。 |
extensions[] |
應用程式專屬回應中繼資料。必須在串流 API 的第一個回應中設定。 包含任意類型欄位的物件。額外的 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/apps.order
詳情請參閱授權指南。
DeletionType
列舉 | |
---|---|
deletion_type_undefined |
|
cancel |
立即取消訂閱。不適用於 G Suite 訂閱方案。 |
transfer_to_direct |
將訂閱直接轉移給 Google。 客戶會立即轉移給 Google 的直接帳單關係,只有一小段時間不會發生服務中斷。客戶可以選擇使用信用卡,直接向 Google 設定帳單資訊,或是選擇將帳單轉移至其他經銷商。 |