Method: subscriptions.delete

Bir aboneliği iptal ettiği, askıya aldığı veya doğrudan yönlendirmeye aktardığı durumlarda.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Bu, müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı olabilir. Bir müşterinin alan adı değişirse müşteriye erişmek için eski alan adı kullanılamaz ancak müşterinin benzersiz tanımlayıcısı (API tarafından döndürüldüğü şekliyle) her zaman kullanılabilir. Benzersiz tanımlayıcıyı, uygun olduğu durumlarda sistemlerinizde depolamanızı öneririz.
subscriptionId

string

Bu zorunlu bir özelliktir. subscriptionId, abonelik tanımlayıcısıdır ve her müşteri için benzersizdir. Abonelik güncellendiğinde subscriptionId değiştiğinden kalıcı veriler için bu kimliği anahtar olarak kullanmamanızı öneririz. subscriptionId, tüm bayi aboneliklerini al yöntemi kullanılarak da bulunabilir.

Sorgu parametreleri

Parametreler
deletionType

enum (DeletionType)

deletionType sorgu dizesi, bir aboneliğin iptal edilmesini, düşürülmesini veya askıya alınmasını sağlar.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Rastgele bir HTTP gövde metnini temsil eden mesaj. Yalnızca ham ikili program veya HTML sayfası gibi JSON olarak temsil edilemeyen yük biçimleri için kullanılmalıdır.

Bu mesaj hem istekteki hem de yanıttaki akışkan ve akışkan olmayan API yöntemlerinde kullanılabilir.

Üst düzey istek alanı olarak kullanılabilir. Bu, URL veya HTTP şablonundan parametreleri alıp istek alanlarına yerleştirmek ve ham HTTP gövde metnine erişmek istediğinizde kullanışlı olur.

Örnek:

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

}

Akışkan yöntemlerin kullanıldığı örnek:

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

}

Bu türün kullanılması yalnızca istek ve yanıt gövde metinlerinin ele alınma biçimini değiştirir, diğer tüm özellikler herhangi bir değişiklik olmadan çalışmaya devam eder.

Başarılı olursa yanıt, biçimi yöntem tarafından tanımlanan genel bir HTTP yanıtı olur.

JSON gösterimi 
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Alanlar
contentType

string

Gövdenin içerik türünü belirten HTTP Content-Type üstbilgisi değeri.
data

string (bytes format)

Ham ikili programdaki HTTP istek/yanıt gövdesi.

base64 kodlu bir dize.
extensions[]

object

Uygulamaya özgü yanıt meta verileri. Akışkan API'ler için ilk yanıtta ayarlanmalıdır.

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

DeletionType

Sıralamalar
deletion_type_undefined
cancel Aboneliği hemen iptal eder. Bu durum G Suite abonelikleri için geçerli değildir.
transfer_to_direct

Bir aboneliği doğrudan Google'a aktarır. Müşteri hemen Google ile doğrudan bir fatura ilişkisine başlar ve kısa bir süre içinde hizmet kesintisi yaşamaz. Müşteri daha sonra kredi kartı kullanarak faturalandırma ayarlarını doğrudan Google'da yapabilir veya başka bir bayiye aktarabilir.