- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- DeletionType
- Cobalah!
Membatalkan, menangguhkan, atau mentransfer langganan ke langsung.
Permintaan HTTP
DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
customerId |
Ini dapat berupa nama domain primer pelanggan atau ID unik pelanggan. Jika nama domain untuk pelanggan berubah, nama domain lama tidak dapat digunakan untuk mengakses pelanggan, tetapi pengenal unik pelanggan (seperti yang ditampilkan oleh API) selalu dapat digunakan. Sebaiknya simpan ID unik di sistem Anda, jika berlaku. |
subscriptionId |
Ini adalah properti wajib. |
Parameter kueri
Parameter | |
---|---|
deletionType |
String kueri |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan yang merepresentasikan bagian isi HTTP arbitrer. Pesan ini hanya boleh digunakan untuk format payload yang tidak dapat direpresentasikan sebagai JSON, seperti biner mentah atau halaman HTML.
Pesan ini dapat digunakan baik dalam metode API streaming maupun non-streaming pada permintaan dan juga pada respons.
Pesan ini dapat digunakan sebagai kolom permintaan tingkat atas, yang praktis jika seseorang ingin mengekstrak parameter dari template HTTP atau URL ke dalam kolom permintaan dan juga menginginkan akses ke isi HTTP mentah.
Contoh:
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);
}
Contoh dengan metode streaming:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
Penggunaan jenis ini hanya mengubah cara penanganan isi permintaan dan respons; semua fitur lainnya tetap berfungsi tanpa perubahan.
Jika berhasil, responsnya adalah respons HTTP umum yang formatnya ditentukan oleh metode.
Representasi JSON |
---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
Kolom | |
---|---|
contentType |
Nilai header Jenis Konten HTTP yang menentukan jenis konten pada bagian isi. |
data |
Isi permintaan/respons HTTP sebagai biner mentah. String berenkode base64. |
extensions[] |
Metadata respons khusus aplikasi. Harus ditetapkan dalam respons pertama untuk API streaming. Objek yang berisi kolom tipe arbitrer. Kolom tambahan |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/apps.order
Untuk informasi selengkapnya, lihat Panduan otorisasi.
DeletionType
Enum | |
---|---|
deletion_type_undefined |
|
cancel |
Segera membatalkan langganan. Hal ini tidak berlaku untuk langganan G Suite. |
transfer_to_direct |
Mentransfer langganan langsung ke Google. Pelanggan akan segera dialihkan ke hubungan penagihan langsung dengan Google dan diberi waktu yang singkat tanpa gangguan layanan. Selanjutnya, pelanggan dapat memilih untuk menyiapkan penagihan secara langsung dengan Google menggunakan kartu kredit, atau ia dapat mentransfernya ke reseller lain. |