بازیابی & اشتراک را به روز کنید

پس از بازیابی اشتراک، می‌توانید از اطلاعات پاسخ موفقیت‌آمیز برای تغییر وضعیت اشتراک یا به‌روزرسانی اشتراک استفاده کنید. این صفحه بر روش‌های مختلف بازیابی و به‌روزرسانی اشتراک تمرکز دارد.

بازیابی اشتراک

برای بازیابی اشتراکی که با موفقیت سفارش داده شده یا منتقل شده است، از درخواست HTTP GET زیر استفاده کنید.

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• SUBSCRIPTION_ID : شناسه اشتراک که برای هر مشتری منحصر به فرد است. می‌توانید این مقدار را با استفاده از متد Retrieve all reseller subscriptions بازیابی کنید.

این عملیات هیچ پارامتری در بدنه درخواست ندارد.

یک پاسخ موفق، کد وضعیت HTTP 200 و تنظیمات اشتراک را برمی‌گرداند. در پاسخ مثال زیر، ویژگی isInTrial برابر با false است اما هیچ ویژگی trialEndTime وجود ندارد، به این معنی که این مشتری هرگز در یک دوره آزمایشی 30 روزه رایگان با این طرح شرکت نکرده است.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "billingMethod": "ONLINE",
  "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": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
  "skuName": "Google Workspace Business Standard"
}

بازیابی تمام اشتراک‌های یک مشتری

برای بازیابی تمام اشتراک‌های یک مشتری خاص که با موفقیت سفارش داده یا منتقل شده‌اند، از درخواست GET HTTP زیر استفاده کنید و توکن مجوز را نیز در آن قرار دهید:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• START_DATE : تاریخ شروع با فرمت YYYY-MM-DD .
• MAX_NUMBER : حداکثر تعداد نتایج برگردانده شده در یک صفحه پاسخ.

این عملیات هیچ پارامتری در بدنه درخواست ندارد.

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

اگر این مشتری مدیریت نشود، خطای 403 "Forbidden" برگردانده می‌شود.

بازیابی تمام اشتراک‌های قابل انتقال برای یک مشتری

برای بازیابی تمام اشتراک‌های مشتری که به طور بالقوه می‌توانند به مدیریت فروشنده منتقل شوند، از درخواست GET HTTP زیر استفاده کنید و توکن مجوز را نیز اضافه کنید. customerId مورد نیاز است و شناسه منحصر به فرد مشتری است که هنگام بازیابی حساب مشتری فروخته شده بازگردانده می‌شود. customerAuthToken یک توکن انتقال است که توسط مشتری شما ارائه می‌شود و مختص شناسه فروشنده شماست. پس از تولید توسط مشتری، به مدت 30 روز معتبر است. برای اطلاعات بیشتر در مورد نحوه تولید توکن توسط مشتریان، به بخش انتقال حساب Google Workspace خود به یک فروشنده مراجعه کنید.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• AUTH_TOKEN : یک توکن انتقال ارائه شده توسط مشتری شما که مختص شناسه فروشنده شماست. پس از تولید توسط مشتری، به مدت 30 روز معتبر است. برای اطلاعات بیشتر در مورد نحوه تولید توکن توسط مشتریان، به بخش «انتقال حساب Google Workspace شما به یک فروشنده» مراجعه کنید. اگر این مقدار معتبر نباشد یا منقضی شده باشد، پاسخ API خطای 403 "Forbidden" را برمی‌گرداند.
• START_DATE : تاریخ شروع با فرمت YYYY-MM-DD .
• MAX_NUMBER : حداکثر تعداد نتایج برگردانده شده در یک صفحه پاسخ.

این عملیات هیچ پارامتری در بدنه درخواست ندارد.

یک پاسخ موفق، یک کد وضعیت HTTP 200 و لیستی از اشتراک‌های قابل انتقال مشتری به همراه تاریخ انقضای توکن انتقال و حداقل تعداد جایگاه‌های مورد نیاز در سفارش انتقال را برمی‌گرداند. یک مشتری ممکن است اشتراک‌های اضافی داشته باشد که قابل انتقال نیستند.

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "432",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1331647980142",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "maximumNumberOfSeats": 500,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183980142",
        "minimumTransferableSeats": "20"
      },
      "purchaseOrderId": "PO_890",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "140",
      "skuId": "1010020028",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183780159",
        "minimumTransferableSeats": "10"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

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

بازیابی تمام اشتراک‌های نمایندگان فروش

برای بازیابی تمام اشتراک‌های سفارش داده شده یا منتقل شده‌ی موفقیت‌آمیز یک نماینده فروش، از درخواست GET HTTP زیر استفاده کنید و توکن مجوز را نیز در آن قرار دهید.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER

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

• PREFIX : ابتدای نام مشتری که اشتراک‌های او را جستجو می‌کنید.
• TOKEN : توکنی که صفحه خاصی از نتایج را که سرور باید برگرداند، مشخص می‌کند.
• MAX_NUMBER : حداکثر تعداد نتایج برگردانده شده در یک صفحه پاسخ.

این عملیات می‌تواند از محدوده دسترسی فقط خواندنی OAuth استفاده کند. customerNamePrefix ، pageToken و maxResults رشته‌های پرس‌وجوی اختیاری هستند.

مثال زیر تمام اشتراک‌های یک فروشنده که متعلق به مشتریانی است که نام آنها با 'exam' شروع می‌شود را بازیابی می‌کند:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "C0123456",
      "subscriptionId": "123",
      "skuId": "1010020028",
      "creationTime": "1331647980142",
      "billingMethod": "ONLINE",
      "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": "PO_135",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-5678",
      "subscriptionId": "1404686",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "AUTO_RENEW"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

به‌روزرسانی طرح اشتراک

به‌روزرسانی طرح‌های Google Workspace بسته به طرح متفاوت است. قبل از به‌روزرسانی طرح، موارد زیر را در نظر بگیرید:

• وقتی اشتراکی ایجاد می‌کنید و مشتری واجد شرایط می‌شود، طرح اشتراک می‌تواند یک دوره آزمایشی ۳۰ روزه باشد. هر دو طرح پرداخت انعطاف‌پذیر و تعهد سالانه می‌توانند دوره آزمایشی ۳۰ روزه رایگان باشند. در طول دوره آزمایشی، می‌توانید طرح پرداخت اشتراک را هر چند وقت یکبار که نیاز باشد به طرح‌های انعطاف‌پذیر یا تعهد سالانه تغییر دهید. اما پس از پایان دوره آزمایشی و فعال شدن طرح، به‌روزرسانی طرح از همان قوانین طرح‌های فعال سایر اشتراک‌ها پیروی می‌کند. برای انتقال فوری یک اشتراک آزمایشی به یک طرح فعال، یک سرویس پولی را از یک اشتراک آزمایشی ۳۰ روزه رایگان شروع کنید . برای اطلاعات بیشتر در مورد دوره آزمایشی ۳۰ روزه و قوانین احراز صلاحیت مشتری، به مرکز راهنمای مدیریت مراجعه کنید.

• شما می‌توانید یک طرح انعطاف‌پذیر را به یک طرح تعهد سالانه به‌روزرسانی کنید.

• شما نمی‌توانید یک طرح تعهد سالانه را به‌روزرسانی کنید.

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

برای به‌روزرسانی طرح آزمایشی ۳۰ روزه یا اشتراک طرح انعطاف‌پذیر در طرح تعهد سالانه، از درخواست POST HTTP زیر استفاده کنید:

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• SUBSCRIPTION_ID : شناسه اشتراک که برای هر مشتری منحصر به فرد است. می‌توانید این مقدار را با استفاده از متد Retrieve all reseller subscriptions بازیابی کنید.

مثال زیر اشتراک را با subscriptionId با مقدار ۱۲۳ به‌روزرسانی می‌کند. customerId برابر با C0123456 است.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan

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

{
  "kind": "reseller#changePlanRequest",
  "planName": "ANNUAL_MONTHLY_PAY",
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "purchaseOrderId": "123_March2012"
}

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

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "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": "123_March2012",
  "status": "ACTIVE",
  "skuName": "Google Workspace Business Standard"
}

به‌روزرسانی جایگاه‌های اشتراک

به‌روزرسانی اشتراک طرح تعهد سالانه از ویژگی‌های اشتراک متفاوتی نسبت به به‌روزرسانی اشتراک طرح انعطاف‌پذیر Google Workspace استفاده می‌کند.

به‌روزرسانی جایگاه‌ها برای اشتراک طرح سالانه

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

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• SUBSCRIPTION_ID : شناسه اشتراک که برای هر مشتری منحصر به فرد است. می‌توانید این مقدار را با استفاده از متد Retrieve all reseller subscriptions بازیابی کنید.

مثال زیر اشتراک را با subscriptionId ۱۲۳ به‌روزرسانی می‌کند. customerId C0123456 است. بدنه درخواست بسته به نوع طرح متفاوت است:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats

اشتراک طرح تعهد سالانه Google Workspace از این بدنه درخواست برای به‌روزرسانی تعداد مجوزهای کاربر استفاده می‌کند. مقدار numberOfSeats یک مجموع است. برای مثال، اگر قبلاً 10 مجوز کاربر داشته‌اید و سفارش مشتری برای 5 مجوز جدید دارید، مجموع موجود در بدنه درخواست برای numberOfSeats برابر با 15 است، همانطور که در مثال زیر نشان داده شده است:

{
    "kind": "subscriptions#seats",
    "numberOfSeats": 15
}

به‌روزرسانی صندلی‌ها برای اشتراک در طرح انعطاف‌پذیر

اشتراک طرح انعطاف‌پذیر Google Workspace از بدنه درخواست برای به‌روزرسانی مجوزهای کاربر استفاده می‌کند. مقدار maximumNumberOfSeats برابر با مجموع مجوزهای موجود و مجوزهای جدید است. این حداکثر تعداد مجوزهای کاربری است که حساب می‌تواند ارائه دهد.

{
  "kind": "subscriptions#seats",
  "maximumNumberOfSeats": 15
}

یک پاسخ موفقیت‌آمیز، کد وضعیت HTTP 201 و تنظیمات مجوز اشتراک به‌روزرسانی‌شده را برمی‌گرداند:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 15,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "skuName": "Google Workspace Business Standard"
}

به‌روزرسانی تنظیمات تمدید اشتراک

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

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• SUBSCRIPTION_ID : شناسه اشتراک که برای هر مشتری منحصر به فرد است. می‌توانید این مقدار را با استفاده از متد Retrieve all reseller subscriptions بازیابی کنید.

نمونه‌ای از بدنه درخواست به شرح زیر است:

{
  "kind": "subscriptions#renewalSettings",
  "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}

مقدار ویژگی renewalType می‌تواند هر یک از موارد زیر باشد:

• AUTO_RENEW_YEARLY_PAY : در پایان بازه زمانی طرح تعهد سالانه، طرح اشتراک را به صورت ANNUAL_YEARLY_PAY با همان numberOfSeats به طور خودکار تمدید می‌کند.
• AUTO_RENEW_MONTHLY_PAY : در پایان بازه زمانی طرح تعهد سالانه، طرح اشتراک‌ها را به صورت ANNUAL_MONTHLY_PAY با همان numberOfSeats به طور خودکار تمدید می‌کند.
• RENEW_CURRENT_USERS_YEARLY_PAY : در پایان بازه زمانی طرح تعهد سالانه، طرح اشتراک را به عنوان ANNUAL_YEARLY_PAY تمدید کنید، اما از تعداد کل مجوزهای کاربر فعال فعلی استفاده کنید. این تنظیم پیش‌فرض برای طرح‌های تعهد سالانه فعال (پرداخت سالانه) است.
• RENEW_CURRENT_USERS_MONTHLY_PAY : در پایان بازه زمانی طرح تعهد سالانه، طرح اشتراک را به عنوان ANNUAL_MONTHLY_PAY تمدید کنید، اما از تعداد کل مجوزهای کاربر فعال فعلی استفاده کنید. این تنظیم پیش‌فرض برای طرح‌های تعهد سالانه فعال (پرداخت ماهانه) است.
• RENEW_ON_PROPOSED_OFFER : در پایان بازه طرح تعهد فعلی، تمدید را بر اساس آخرین پیشنهاد تمدید با تعداد صندلی‌ها (numberOfSeats) به عنوان تعداد مجوزهای کاربر فعال فعلی یا تعهد پیشنهاد پیشنهادی، هر کدام که بیشتر باشد، انجام دهید.
• SWITCH_TO_PAY_AS_YOU_GO : در پایان بازه زمانی یک طرح تعهد سالانه، طرح تعهد سالانه را به یک طرح انعطاف‌پذیر تغییر دهید.
• CANCEL : در پایان یک دوره طرح تعهد سالانه، اشتراک به حالت تعلیق در می‌آید. برای آشنایی با نحوه لغو تعلیق، به مرکز راهنمای مدیریت مراجعه کنید.

یک پاسخ موفقیت‌آمیز، کد وضعیت HTTP 201 و تنظیمات به‌روزرسانی‌شده‌ی تمدید اشتراک را برمی‌گرداند:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

شروع سرویس پولی از اشتراک آزمایشی رایگان

برای انتقال فوری اشتراک آزمایشی رایگان ۳۰ روزه به اشتراک پولی، اگر قبلاً برای اشتراک آزمایشی، طرح پرداختی تنظیم شده است، از درخواست POST HTTP زیر استفاده کنید.

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.
• SUBSCRIPTION_ID : شناسه اشتراک که برای هر مشتری منحصر به فرد است. می‌توانید این مقدار را با استفاده از متد Retrieve all reseller subscriptions بازیابی کنید.

در مثال زیر، C0123456 به عنوان customerId و مقدار subscriptionId برابر با ۱۲۳ است:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService

این عملیات هیچ پارامتری در بدنه درخواست ندارد.

یک پاسخ موفق، کد وضعیت HTTP 201 و تنظیمات اشتراک به‌روزرسانی‌شده را برمی‌گرداند:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

ارتقاء یا کاهش اشتراک

شما نمی‌توانید طرح‌های سالانه را در اواسط دوره‌شان به نسخه پایین‌تر (Downgrade) تغییر دهید و نمی‌توانید با استفاده از تنظیمات تمدید، یک تغییر نسخه برنامه‌ریزی کنید. توصیه می‌کنیم تنظیمات تمدید را روی FLEXIBLE قرار دهید و سپس پس از زمان تمدید، به نسخه پایین‌تر (Downgrade) تغییر دهید.

برای ارتقا یا تنزل اشتراک، یک اشتراک جدید با skuId مورد نظر برای ارتقا یا تنزل به آن ایجاد کنید.

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

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

• CUSTOMER_ID ): یا نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری.

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

اطلاعات بیشتر در مورد ارتقاها و تنزل‌ها را در صفحه محصولات و SKUها بیابید.