Abonelik oluşturma veya aktarma

Siz müşterinin hesabını sipariş etme, bir dizi farklı abonelik oluşturabilirsiniz:

  • Yıllık taahhüt aboneliği
  • Esnek abonelik
  • 30 günlük ücretsiz deneme
  • İndirimli abonelik

Bu aboneliklerin kullandığı ürünler hakkında daha fazla bilgi için Ürünler ve SKU'lar.

Bu müşterinin hesabı için sipariş vermediyseniz abonelik aktarma hakkında daha fazla bilgi edinin.

customerType = 'team' hesabına sahip müşteriler yalnızca Essentials ve Google Workspace'in Enterprise Essentials sürümleri. Satın almaya çalışırsanız diğer Google Workspace aboneliklerinden herhangi birine hata - Customer is not eligible to purchase this subscription. Müşteriler Essentials ve kullanıma dayalı abonelikler satın alma konusunda zorluk yaşayabilirsiniz. Yıllık Taahhüt planları, sınırlı yükseltme ve düşürme seçenekleri sunar.

Abonelik oluşturma

Yeni oluşturulan bir müşteri hesabı için abonelik oluşturmak üzere aşağıdaki POST HTTP isteğini takip edin ve yetkilendirme jetonunu ekleyin:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

CUSTOMER_ID, kullanıcının birincil alan adı veya müşterinin benzersiz tanımlayıcısı, yeniden satış yapılan bir müşterinin hesabını alma.

Yıllık taahhüt planı oluşturma

Yıllık taahhüt planı aboneliklerinde tüm SKU'lar aynı değildir varsayılan yenileme ayarlarına gidin. renewalSettings ayarını her zaman geçmenizi öneririz. İçerik üretme 10 lisanslı yıllık taahhüt aboneliği:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) kullanır. Daha fazla bilgi için bkz. Ürünler ve SKU kimlikleri.
  • PURCHASE_ORDER_ID: İsteğe bağlı bir satın alma siparişi Kullanımı izlemek için kullanabileceğiniz kimlik.

Başarılı bir yanıt, bir HTTP 200 durumu ve yeni aboneliğin ayarlarını kontrol edin. ANNUAL_MONTHLY_PAY, şu şekilde döndürüldü: Tüm API yanıtlarında ANNUAL.

Aşağıda yıllık plan yanıtı örneği verilmiştir:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Esnek plan oluşturun

Yeni oluşturulan bir müşteri hesabı için esnek abonelik oluşturmak üzere aşağıdaki POST HTTP isteğini gönderin ve yetkilendirme jetonunu ekleyin:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) kullanır. Daha fazla bilgi için bkz. Ürünler ve SKU kimlikleri.
  • PURCHASE_ORDER_ID: İsteğe bağlı bir satın alma siparişi Kullanımı izlemek için kullanabileceğiniz kimlik.

Aşağıda, esnek plan yanıtı örneği verilmiştir:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": false
  },
  "purchaseOrderId": "my_example_flex_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

Ücretsiz deneme oluşturun

Yeni oluşturulan bir müşterinin işletme sürümü için 30 günlük ücretsiz deneme aboneliği aşağıdaki POST HTTP isteğini kullanın ve jeton:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) kullanır. Daha fazla bilgi için bkz. Ürünler ve SKU kimlikleri.
  • PURCHASE_ORDER_ID: İsteğe bağlı bir satın alma siparişi Kullanımı izlemek için kullanabileceğiniz kimlik.

Aşağıda, 30 günlük ücretsiz deneme planı yanıtı örneği verilmiştir:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "TRIAL",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10,
    "licensedNumberOfSeats": 0
  },
  "trialSettings": {
    "isInTrial": true,
    "trialEndTime": "1331648420142"
  },
  "purchaseOrderId": "my_example_trial_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "skuName": "Google Workspace Business Standard"
}

İndirimli abonelik oluşturma

Google, indirimli fiyattan abonelik oluşturmak için bir fırsat kodu sağlayabilir oranıdır. Bir abonelikte indirim yapmak için fırsat kodunu şurada sağlamanız gerekir: abonelik insert çağrısı. Müşteri, orijinal SKU'yu tercih ederseniz indirim kaldırılır.

Yeni oluşturulan bir abonelik için indirim yıllık taahhüt aboneliği oluşturmak aşağıdaki POST HTTP isteğini kullanın ve yetkilendirme jetonu:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
  "kind": "reseller#subscription",
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  renewalSettings: {
    "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) kullanır. Daha fazla bilgi için bkz. Ürünler ve SKU kimlikleri.
  • PURCHASE_ORDER_ID: İsteğe bağlı bir satın alma siparişi Kullanımı izlemek için kullanabileceğiniz kimlik.
  • GOOGLE_CONTRACT_DEAL_CODE: İndirim kodu mevcut Google'dan.

Aşağıda, indirimli yıllık plan yanıtı örneği verilmiştir:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "my_example.com_annual_1",
  "status": "ACTIVE",
  "customerDomain": "my_example.com",
  "dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
  "skuName": "Google Workspace Business Standard"
}

Aboneliği aktarma

Müşterinin hesabını yeni bir müşteri hesabı sipariş edin işlemi için abonelik oluştururken müşterinin aktarım jetonunu yardımcı olur.

Sipariş etmediğiniz bir müşteri hesabı için abonelik oluşturmak üzere Aşağıdaki POST HTTP isteği:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • TOKEN_VALUE: Tarafınızca sağlanan aktarım jetonu bir fırsattır. Jeton, müşteri tarafından oluşturulduktan sonra 30 gün boyunca geçerlidir.

Müşterilerin aktarım jetonunu nasıl aldığı hakkında daha fazla bilgi için Google Workspace Yardım Merkezi

Yıllık taahhüt planı müşterisinin aboneliğini aktarmak için aşağıdaki POST HTTP isteğini takip edin ve yetkilendirme jetonunu ekleyin:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
  "customerId": "CUSTOMER_ID",
  "skuId": "SKU_ID",
  "plan": {
    "planName": "ANNUAL_MONTHLY_PAY"
  },
  "seats": {
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Müşterinin birincil alanı veya müşterinin benzersiz tanımlayıcısını kullanabilirsiniz.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) kullanır. Daha fazla bilgi için bkz. Ürünler ve SKU kimlikleri.
  • PURCHASE_ORDER_ID: İsteğe bağlı bir satın alma siparişi Kullanımı izlemek için kullanabileceğiniz kimlik.

Başarılı bir yanıt, HTTP 200 durumu döndürüyor bir abonelik için aktarılan aboneliğin ayarlarını yıllık taahhüt planı:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "billingMethod": "ONLINE",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

Aktarım sınırlamaları

İlişkilendirilmiş bir Google Drive ile Google Workspace aboneliğini aktarıyorsanız veya Google Apps Kasası aboneliğiniz varsa batch işlemi ACTIVE durumunda olan tüm abonelikleri aktarın. Her biri aktarılıyor hataya neden olduğunu görebilirsiniz.

Askıya alınmış aboneliklerin aktarılmasına yalnızca askıya alma nedeni şu durumlarda izin verilir: PENDING_TOS_ACCEPTANCE, TRIAL_ENDED veya RENEWAL_WITH_TYPE_CANCEL.

Eski bir SKU'yu aktarırken subscriptions.list, skuId değerini döndürür aktarılması gereken SKU'dur. Verinin skuId gerçekte transferInfo.currentLegacySkuId olarak döndürüldü. Örneğin, skuIds tam listesini ve bu planların hangi ürünleri kullandığını öğrenmek için Ürünler ve SKU'lar.

Aktarımlar, indirim fırsat kodlarıyla çalışmaz.