Method: subscriptions.delete

Aboneliği iptal eder, askıya alır veya doğrudan aboneliğe 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 benzersiz tanımlayıcısıdır. 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üğü şekilde) her zaman kullanılabilir. Uygun olduğu durumlarda benzersiz tanımlayıcıyı sistemlerinizde saklamanızı öneririz.
subscriptionId

string

Bu zorunlu bir özelliktir. subscriptionId, abonelik tanımlayıcısıdır ve her müşteri için benzersizdir. subscriptionId, abonelik güncellendiğinde 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, aboneliğin iptal edilmesini, alt 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ıdır.

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 başlık değeri.
data

string (bytes format)

Ham ikili olarak 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.

İsteğe bağlı türde alanlar içeren bir nesne. "@type" adlı ek bir 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 bakın.

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

Aboneliği doğrudan Google'a aktarır.  Müşteri hemen Google ile doğrudan faturalandırma ilişkisine aktarılır ve hizmet kesintisi yaşanmadan kısa bir süre tanınır. Müşteri daha sonra kredi kartı kullanarak faturalandırmayı doğrudan Google ile ayarlayabilir veya başka bir bayiye aktarılabilir.