Method: subscriptions.delete

Huỷ, tạm ngưng hoặc chuyển gói thuê bao sang kênh trực tiếp.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

Đây có thể là tên miền chính của khách hàng hoặc mã nhận dạng duy nhất của khách hàng. Nếu tên miền cho một khách hàng thay đổi, tên miền cũ không thể dùng để truy cập vào khách hàng, nhưng luôn có thể sử dụng mã nhận dạng duy nhất của khách hàng (do API trả về). Bạn nên lưu trữ mã nhận dạng duy nhất trong hệ thống của mình (nếu có).
subscriptionId

string

Đây là thuộc tính bắt buộc. subscriptionId là mã nhận dạng gói thuê bao và là mã nhận dạng duy nhất của mỗi khách hàng. Vì subscriptionId thay đổi khi gói thuê bao được cập nhật, bạn không nên dùng mã này làm khoá cho dữ liệu cố định. Và bạn có thể tìm thấy subscriptionId bằng cách sử dụng phương thức truy xuất tất cả gói thuê bao của đại lý.

Tham số truy vấn

Các tham số
deletionType

enum (DeletionType)

Chuỗi truy vấn deletionType cho phép huỷ, hạ cấp hoặc tạm ngưng gói thuê bao.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo đại diện cho nội dung HTTP tùy ý. Chỉ nên sử dụng HttpBody cho các định dạng nội dung không thể biểu diễn dưới dạng JSON, chẳng hạn như trang nhị phân thô hoặc trang HTML.

Có thể sử dụng thông báo này trong cả các phương thức API phát trực tuyến và không phải phát trực tuyến trong yêu cầu cũng như phản hồi.

HttpBody có thể dùng làm trường yêu cầu cấp cao nhất. Điều này rất thuận tiện nếu người dùng muốn trích xuất các tham số từ mẫu URL hoặc HTTP vào các trường yêu cầu và cũng muốn truy cập vào phần nội dung HTTP thô.

Ví dụ:

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);

}

Ví dụ với các phương thức phát trực tuyến:

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

}

Việc sử dụng loại thông báo này chỉ thay đổi cách xử lý các yêu cầu và nội dung phản hồi, tất cả các tính năng khác sẽ tiếp tục hoạt động theo cách như cũ.

Nếu thành công thì phản hồi sẽ là một phản hồi HTTP chung có định dạng được xác định bằng phương thức.

Biểu diễn dưới dạng JSON 
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Các trường
contentType

string

Giá trị tiêu đề Loại nội dung HTTP chỉ định loại nội dung của phần thông tin.
data

string (bytes format)

Nội dung yêu cầu/phản hồi HTTP dưới dạng tệp nhị phân thô.

Chuỗi được mã hoá base64.
extensions[]

object

Siêu dữ liệu về phản hồi dành riêng cho ứng dụng. Phải được đặt trong phản hồi đầu tiên cho API phát trực tuyến.

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

DeletionType

Enum
deletion_type_undefined
cancel Huỷ gói thuê bao ngay lập tức. Điều này không áp dụng cho gói thuê bao G Suite.
transfer_to_direct

Chuyển thẳng gói thuê bao sang Google. Khách hàng sẽ được chuyển ngay sang mối quan hệ thanh toán trực tiếp với Google và nhận được một khoảng thời gian ngắn mà không bị gián đoạn dịch vụ. Sau đó, khách hàng có thể chọn thiết lập thông tin thanh toán trực tiếp với Google bằng thẻ tín dụng hoặc chuyển sang một đại lý khác.