Method: subscriptions.delete

Aboneliği iptal eder, askıya alır veya yönlendirmeye aktarır.

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ülen) her zaman kullanılabilir. Uygun olduğu durumlarda, benzersiz tanımlayıcıyı 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. Bir abonelik güncellendiğinde subscriptionId değiştiğinden bu kimliği kalıcı veriler için anahtar olarak kullanmamanızı öneririz. subscriptionId ise tüm bayi aboneliklerini alma yöntemi kullanılarak bulunabilir.

Sorgu parametreleri

Parametreler
deletionType

enum (DeletionType)

deletionType sorgu dizesi, bir aboneliğin iptal edilmesini, eski sürüme geçirilmesini 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övde metninin içerik türünü belirten HTTP Content-Type üstbilgisi değeri.
data

string (bytes format)

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

Base64 olarak kodlanmış bir dize.
extensions[]

object

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

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek 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ılavuzuna göz atın.

DeletionType

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

Aboneliği doğrudan Google'a aktarır. Müşteri hemen Google ile doğrudan faturalandırma ilişkisine geçirilir ve kendisine hizmet kesintisi olmadan kısa bir süre tanınır. Daha sonra müşteri, kredi kartı kullanarak doğrudan Google'da faturalandırma ayarlarını yapabilir veya aboneliğini başka bir bayiye aktarabilir.