Abonelik oluşturma veya aktarma

Müşteri hesabı sipariş ettikten sonra çeşitli abonelikler 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 başlıklı makaleyi inceleyin.

Müşterinin hesabını sipariş etmediyseniz abonelik aktarabilirsiniz.

customerType = 'team' aboneliği olan müşteriler yalnızca Google Workspace'in Google Workspace Essentials ve Google Workspace Enterprise Essentials sürümlerini satın alabilir. Başka Google Workspace abonelikleri satın almaya çalıştığınızda Customer is not eligible to purchase this subscription hatasını alırsınız. Essentials veya kullanıma dayalı abonelik satın alan müşteriler yıllık taahhüt planlarını kullanamayabilir ve yükseltme/düşürme seçenekleri sınırlı olabilir.

Abonelik oluşturma

Yeni bir müşterinin hesabı için abonelik oluşturmak üzere aşağıdaki POST HTTP isteğini kullanın ve yetkilendirme jetonunu ekleyin:

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

CUSTOMER_ID, müşterinin birincil alan adı veya yeniden satılan bir müşterinin hesabı alınırken döndürülen müşterinin benzersiz tanımlayıcısıdır.

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

Yıllık taahhüt planı aboneliklerinde, tüm SKU'lar aynı varsayılan yenileme ayarlarına sahip değildir. Her zaman renewalSettings değerini iletmenizi öneririz. 10 koltuklu yıllık taahhüt aboneliği oluşturma:

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 adı veya müşterinin benzersiz tanımlayıcısı.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri başlıklı makaleyi inceleyin.
  • PURCHASE_ORDER_ID: Kullanımı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.

Başarılı bir yanıt, HTTP 200 durumunu ve yıllık taahhüt planı için yeni aboneliğin ayarlarını döndürür. ANNUAL_MONTHLY_PAY Tüm API yanıtlarında ANNUAL olarak döndürülür.

Aşağıda, yıllık plan yanıtına dair bir örnek 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şturma

Yeni bir müşterinin hesabı için esnek abonelik oluşturmak üzere aşağıdaki POST HTTP isteğini kullanın 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 adı veya müşterinin benzersiz tanımlayıcısı.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri başlıklı makaleyi inceleyin.
  • PURCHASE_ORDER_ID: Kullanımı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.

Aşağıda, esnek plan yanıtına dair bir örnek 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şturma

Yeni bir müşterinin hesabı için 30 günlük ücretsiz deneme aboneliği oluşturmak üzere aşağıdaki POST HTTP isteğini kullanın 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": "TRIAL"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

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

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

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, abonelikleri indirimli fiyata oluşturmak için bir fırsat kodu sağlayabilir. Abonelikte indirim yapmak için abonelik insert çağrısında fırsat kodunu sağlamanız gerekir. Müşteri orijinal SKU'sunu değiştirirse indirim kaldırılır.

Yeni bir müşterinin hesabı için indirimli yıllık taahhüt aboneliği oluşturmak üzere aşağıdaki POST HTTP isteğini kullanın 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": "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 adı veya müşterinin benzersiz tanımlayıcısı.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri başlıklı makaleyi inceleyin.
  • PURCHASE_ORDER_ID: Kullanımı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.
  • GOOGLE_CONTRACT_DEAL_CODE: Google'dan alınan bir indirim kodu.

Aşağıda, indirimli yıllık plan yanıtına dair bir örnek 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"
}

Abonelik aktarma

Müşterinin hesabını yeni müşteri hesabı sipariş etme işlemiyle sipariş etmediyseniz bu müşteri için abonelik oluştururken müşterinin aktarım jetonunu kullanın.

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

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 adı veya müşterinin benzersiz tanımlayıcısı.
  • TOKEN_VALUE: Müşteriniz tarafından sağlanan bir aktarım jetonu. Müşteri jetonu oluşturduktan sonra 30 gün boyunca geçerlidir.

Müşterilerin nasıl aktarım jetonu alacağı hakkında daha fazla bilgi için Yönetici Yardım Merkezi'ne bakın.

Yıllık taahhüt planı müşterisinin aboneliğini aktarmak için aşağıdaki POST HTTP isteğini kullanın 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 adı veya müşterinin benzersiz tanımlayıcısı.
  • SKU_ID: Benzersiz stok tutma birimi (SKU) tanımlayıcısı. Daha fazla bilgi için Ürünler ve SKU kimlikleri başlıklı makaleyi inceleyin.
  • PURCHASE_ORDER_ID: Kullanımı izlemek için kullanabileceğiniz isteğe bağlı bir satın alma siparişi kimliği.

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

{
  "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ı

Google Drive veya Google Apps Kasası aboneliğiyle ilişkili bir Google Workspace aboneliğini aktarıyorsanız batch işlemini kullanarak ACTIVE durumundaki tüm abonelikleri aktarın. Her aboneliği tek tek aktarmak hataya neden olur.

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

Eski bir SKU aktarılırken subscriptions.list, aktarılması gereken SKU'nun skuId değerini döndürür. Müşterinin sahip olduğu SKU'nun skuId değeri transferInfo.currentLegacySkuId olarak döndürülür. skuIds'nın tam listesi ve bu planlar tarafından kullanılan ürünler için Ürünler ve SKU'lar başlıklı makaleye bakın.

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