ایجاد یا انتقال اشتراک

پس از سفارش حساب مشتری ، می توانید تعدادی اشتراک مختلف ایجاد کنید:

  • اشتراک تعهد سالانه
  • یک اشتراک انعطاف پذیر
  • یک دوره آزمایشی رایگان 30 روزه
  • اشتراک با تخفیف

برای اطلاعات بیشتر درباره محصولاتی که این اشتراک‌ها استفاده می‌کنند، به محصولات و SKUها مراجعه کنید.

اگر حساب این مشتری را سفارش نداده‌اید، می‌توانید اشتراکی را انتقال دهید .

مشتریان دارای customerType = 'team' فقط می‌توانند نسخه‌های Essentials و Enterprise Essentials Google Workspace را خریداری کنند. اگر سعی کنید هر یک از دیگر اشتراک‌های Google Workspace را خریداری کنید، با این خطا مواجه می‌شوید Customer is not eligible to purchase this subscription . مشتریانی که Essentials یا اشتراک‌های مبتنی بر استفاده را خریداری می‌کنند، ممکن است نتوانند برنامه‌های تعهد سالانه را مدیریت کنند و گزینه‌های ارتقا و تنزل رتبه محدودی دارند.

یک اشتراک ایجاد کنید

برای ایجاد اشتراک برای حساب مشتری تازه ایجاد شده، از درخواست POST HTTP زیر استفاده کنید و رمز مجوز را اضافه کنید:

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

CUSTOMER_ID یا نام دامنه اصلی مشتری است یا شناسه منحصربه‌فرد مشتری است که هنگام بازیابی حساب مشتری فروخته شده بازگردانده می‌شود.

یک برنامه تعهد سالانه ایجاد کنید

برای اشتراک‌های طرح تعهد سالانه، همه SKU تنظیمات تمدید پیش‌فرض یکسانی ندارند. توصیه می کنیم همیشه renewalSettings پاس کنید. یک اشتراک تعهدی سالانه با 10 کرسی ایجاد کنید:

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"
}

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • SKU_ID : شناسه واحد نگهداری سهام (SKU). برای اطلاعات بیشتر، محصولات و شناسه‌های SKU را ببینید.
  • PURCHASE_ORDER_ID : شناسه سفارش خرید اختیاری که می‌توانید برای ردیابی مصرف استفاده کنید.

یک پاسخ موفقیت آمیز وضعیت HTTP 200 و تنظیمات اشتراک جدید را برای یک برنامه تعهد سالانه برمی گرداند. ANNUAL_MONTHLY_PAY در همه پاسخ‌های API به‌عنوان ANNUAL برگردانده می‌شود.

نمونه زیر نمونه ای از پاسخ برنامه سالانه است:

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

یک برنامه انعطاف پذیر ایجاد کنید

برای ایجاد اشتراک منعطف برای حساب مشتری تازه ایجاد شده، از درخواست POST HTTP زیر استفاده کنید و توکن مجوز را اضافه کنید:

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"
}

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • SKU_ID : شناسه واحد نگهداری سهام (SKU). برای اطلاعات بیشتر، محصولات و شناسه‌های SKU را ببینید.
  • PURCHASE_ORDER_ID : شناسه سفارش خرید اختیاری که می‌توانید برای ردیابی مصرف استفاده کنید.

نمونه زیر نمونه ای از پاسخ طرح انعطاف پذیر است:

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

آزمایشی رایگان ایجاد کنید

برای ایجاد یک اشتراک آزمایشی رایگان 30 روزه برای حساب مشتری تازه ایجاد شده، از درخواست POST HTTP زیر استفاده کنید و رمز مجوز را در آن قرار دهید:

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"
}

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • SKU_ID : شناسه واحد نگهداری سهام (SKU). برای اطلاعات بیشتر، محصولات و شناسه‌های SKU را ببینید.
  • PURCHASE_ORDER_ID : شناسه سفارش خرید اختیاری که می‌توانید برای ردیابی مصرف استفاده کنید.

نمونه زیر نمونه ای از پاسخ طرح آزمایشی رایگان 30 روزه است:

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

اشتراک تخفیف ایجاد کنید

ممکن است Google یک کد معامله برای ایجاد اشتراک با نرخی با تخفیف ارائه دهد. برای تخفیف اشتراک، باید کد معامله را در تماس insert اشتراک ارائه دهید. اگر مشتری از SKU اصلی خود تغییر کند، تخفیف حذف می شود.

برای ایجاد اشتراک تعهد سالانه تخفیف برای حساب مشتری تازه ایجاد شده، از درخواست POST HTTP زیر استفاده کنید و رمز مجوز را در آن قرار دهید:

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"
}

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • SKU_ID : شناسه واحد نگهداری سهام (SKU). برای اطلاعات بیشتر، محصولات و شناسه‌های SKU را ببینید.
  • PURCHASE_ORDER_ID : شناسه سفارش خرید اختیاری که می‌توانید برای ردیابی مصرف استفاده کنید.
  • GOOGLE_CONTRACT_DEAL_CODE : یک کد تخفیف در دسترس Google.

نمونه زیر نمونه ای از پاسخ طرح سالانه تخفیف است:

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

انتقال اشتراک

اگر حساب مشتری را با استفاده از دستور عملیات حساب مشتری جدید سفارش ندادید، هنگام ایجاد اشتراک برای آن مشتری، از رمز انتقال مشتری استفاده کنید.

برای ایجاد اشتراک برای حساب مشتری که سفارش نداده‌اید، از درخواست POST HTTP زیر استفاده کنید: 

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

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • TOKEN_VALUE : یک رمز انتقال ارائه شده توسط مشتری شما. پس از اینکه مشتری توکن را تولید کرد، تا 30 روز اعتبار دارد.

برای اطلاعات بیشتر درباره نحوه دریافت رمز انتقال توسط مشتریان، به مرکز راهنمای Google Workspace مراجعه کنید.

برای انتقال اشتراک یک مشتری طرح تعهد سالانه، از درخواست POST HTTP زیر استفاده کنید و توکن مجوز را وارد کنید: 

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"
}

موارد زیر را جایگزین کنید:

  • CUSTOMER_ID : یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
  • SKU_ID : شناسه واحد نگهداری سهام (SKU). برای اطلاعات بیشتر، محصولات و شناسه‌های SKU را ببینید.
  • PURCHASE_ORDER_ID : شناسه سفارش خرید اختیاری که می‌توانید برای ردیابی مصرف استفاده کنید.

یک پاسخ موفقیت آمیز یک کد وضعیت HTTP 200 و تنظیمات اشتراک منتقل شده را برای یک طرح تعهد سالانه برمی گرداند: 

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

محدودیت های انتقال

اگر اشتراک Google Workspace را با اشتراک Google Drive یا Google Vault منتقل می‌کنید، از عملیات batch برای انتقال همه اشتراک‌های دارای وضعیت ACTIVE استفاده کنید. انتقال هر اشتراک یک به یک منجر به خطا می شود.

انتقال اشتراک‌های معلق فقط در صورتی مجاز است که دلیل تعلیق PENDING_TOS_ACCEPTANCE ، TRIAL_ENDED ، یا RENEWAL_WITH_TYPE_CANCEL باشد.

هنگام انتقال SKU قدیمی، subscriptions.list یک skuId از SKU را که باید منتقل شود برمی گرداند. skuId SKU که مشتری در حال حاضر دارد به عنوان transferInfo.currentLegacySkuId برگردانده می شود. برای فهرست کامل skuIds و اینکه کدام محصولات توسط این طرح‌ها استفاده می‌شوند، به محصولات و SKU مراجعه کنید.

نقل و انتقالات با کدهای تخفیف کار نمی کنند.