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

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

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

برای اطلاعات بیشتر در مورد محصولاتی که این اشتراک‌ها استفاده می‌کنند، به بخش محصولات و 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 عبور کنید. یک اشتراک تعهد سالانه با ۱۰ صندلی ایجاد کنید:

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

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

برای ایجاد یک اشتراک آزمایشی رایگان ۳۰ روزه برای حساب کاربری تازه ایجاد شده مشتری، از درخواست 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 : یک شناسه سفارش خرید اختیاری که می‌توانید برای پیگیری میزان استفاده از آن استفاده کنید.

در زیر نمونه‌ای از پاسخ طرح آزمایشی رایگان ۳۰ روزه آمده است:

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

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

گوگل ممکن است برای ایجاد اشتراک با نرخ تخفیف‌دار، کد تخفیف ارائه دهد. برای تخفیف اشتراک، باید کد تخفیف را در فراخوانی 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 : کد تخفیفی که از طرف گوگل ارائه می‌شود.

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

{
  "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 و محصولاتی که توسط این طرح‌ها استفاده می‌شوند، به Products and SKUs مراجعه کنید.

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