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

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

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

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

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 رشته های پرس و جو اختیاری هستند.

مثال زیر تمام اشتراک‌های یک فروشنده را که متعلق به مشتریانی است که نامشان با «امتحان» شروع می‌شود، بازیابی می‌کند:

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 بسته به طرح متفاوت است. قبل از اینکه یک طرح را به روز کنید، موارد زیر را در نظر بگیرید:

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

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

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

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

برای به‌روزرسانی یک طرح برای یک دوره آزمایشی 30 روزه یا یک اشتراک طرح انعطاف‌پذیر در یک طرح تعهد سالانه، از درخواست 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 با مقدار 123 به روز می کند. 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 بازیابی کنید.

مثال زیر اشتراک را با 123 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 : در پایان یک بازه زمانی طرح تعهد سالانه، اشتراک به حالت تعلیق در می‌آید. برای درک نحوه رفع تعلیق، به مرکز راهنمایی مدیریت مراجعه کنید.

توجه: همه پاسخ‌های API هم AUTO_RENEW_MONTHLY_PAY و هم AUTO_RENEW_YEARLY_PAY را به صورت AUTO_RENEW برمی‌گرداند و هم RENEW_CURRENT_USERS_MONTHLY_PAY و هم RENEW_CURRENT_USERS_YEARLY_PAY را به‌عنوان RENEW_CURRENT_USERS برمی‌گرداند.

یک پاسخ موفقیت آمیز یک کد وضعیت 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"
}

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

برای انتقال فوری اشتراک آزمایشی رایگان 30 روزه به اشتراک سرویس پولی، اگر قبلاً طرح پرداختی برای اشتراک آزمایشی تنظیم شده است، از درخواست 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 123 است:

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

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

شما نمی توانید برنامه های سالانه را در اواسط دوره آنها کاهش دهید، و نمی توانید با استفاده از تنظیمات تمدید، کاهش رتبه را برنامه ریزی کنید. توصیه می‌کنیم تنظیمات تمدید را روی FLEXIBLE تنظیم کنید و بعد از زمان تمدید آن را کاهش دهید.

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

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

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

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

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

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