পুনরুদ্ধার করুন & একটি সাবস্ক্রিপশন আপডেট করুন

সাবস্ক্রিপশন পুনরুদ্ধার করার পরে, আপনি সফল প্রতিক্রিয়ার তথ্য ব্যবহার করে সাবস্ক্রিপশনের স্ট্যাটাস পরিবর্তন করতে বা সাবস্ক্রিপশনটি আপডেট করতে পারেন। এই পৃষ্ঠাটিতে একটি সাবস্ক্রিপশন কীভাবে পুনরুদ্ধার এবং আপডেট করতে হয় তার উপর আলোকপাত করা হয়েছে।

একটি সাবস্ক্রিপশন পুনরুদ্ধার করুন

সফলভাবে অর্ডার করা বা স্থানান্তরিত সাবস্ক্রিপশন পুনরুদ্ধার করতে, নিম্নলিখিত 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 প্রপার্টি নেই, যার অর্থ এই গ্রাহক এই প্ল্যানটির সাথে কখনও ৩০-দিনের ফ্রি ট্রায়ালে ছিলেন না।

{
  "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&pageToken=START_DATE&maxResults=MAX_NUMBER

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • CUSTOMER_ID : গ্রাহকের প্রাথমিক ডোমেইন নাম অথবা গ্রাহকের অনন্য শনাক্তকারী।
  • START_DATE : YYYY-MM-DD ফরম্যাটে শুরুর তারিখ।
  • MAX_NUMBER : একটি রেসপন্স পেজে প্রদর্শিত ফলাফলের সর্বোচ্চ সংখ্যা।

এই অপারেশনটির রিকোয়েস্ট বডিতে কোনো প্যারামিটার নেই।

একটি সফল প্রতিক্রিয়ার ফলে একটি HTTP 200 স্ট্যাটাস কোড এবং গ্রাহকের সাবস্ক্রিপশন ও সেটিংসের একটি তালিকা ফেরত আসে। সাবস্ক্রিপশনের তালিকায় এমন কিছু প্রোডাক্টও থাকতে পারে যা রিসেলার এপিআই-এর এই সংস্করণে পরিচালিত হয় না।

যদি আপনি গ্রাহককে পরিচালনা না করেন, তাহলে একটি 403 Forbidden ত্রুটি প্রদর্শিত হয়।

একজন গ্রাহকের সমস্ত হস্তান্তরযোগ্য সাবস্ক্রিপশন পুনরুদ্ধার করুন।

কোনো গ্রাহকের সেই সমস্ত সাবস্ক্রিপশন পুনরুদ্ধার করতে, যা সম্ভাব্যভাবে রিসেলারের ব্যবস্থাপনায় স্থানান্তরিত হতে পারে, নিম্নলিখিত GET HTTP অনুরোধটি ব্যবহার করুন এবং অথরাইজেশন টোকেনটি অন্তর্ভুক্ত করুন। customerId আবশ্যক এবং এটি গ্রাহকের সেই অনন্য শনাক্তকারী যা একজন রিসেলার গ্রাহকের অ্যাকাউন্ট পুনরুদ্ধার করার সময় ফেরত আসে। customerAuthToken হলো আপনার গ্রাহকের দ্বারা প্রদত্ত একটি ট্রান্সফার টোকেন যা আপনার রিসেলার আইডির জন্য নির্দিষ্ট। গ্রাহক টোকেনটি তৈরি করার পর, এটি ৩০ দিনের জন্য বৈধ থাকে। গ্রাহকরা কীভাবে টোকেন তৈরি করেন সে সম্পর্কে আরও তথ্যের জন্য, "আপনার 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 : আপনার গ্রাহকের দেওয়া একটি ট্রান্সফার টোকেন যা আপনার রিসেলার আইডির জন্য নির্দিষ্ট। গ্রাহক টোকেনটি তৈরি করার পর, এটি ৩০ দিনের জন্য বৈধ থাকে। গ্রাহকরা কীভাবে টোকেন তৈরি করেন সে সম্পর্কে আরও তথ্যের জন্য, "আপনার 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"
}

একটি সাবস্ক্রিপশন প্ল্যান আপডেট করুন

প্ল্যানের উপর নির্ভর করে গুগল ওয়ার্কস্পেস প্ল্যান আপডেট করার পদ্ধতি ভিন্ন হয়। প্ল্যান আপডেট করার আগে, নিম্নলিখিত বিষয়গুলো বিবেচনা করুন:

  • যখন আপনি একটি সাবস্ক্রিপশন তৈরি করেন এবং গ্রাহক যোগ্য হন, তখন সাবস্ক্রিপশনের প্ল্যানটি একটি ৩০-দিনের ট্রায়াল হতে পারে। ফ্লেক্সিবল এবং বার্ষিক প্রতিশ্রুতি উভয় পেমেন্ট প্ল্যানই ৩০-দিনের ফ্রি ট্রায়াল হতে পারে। ট্রায়াল চলাকালীন, আপনি প্রয়োজন অনুযায়ী যতবার খুশি সাবস্ক্রিপশনের পেমেন্ট প্ল্যানটি ফ্লেক্সিবল বা বার্ষিক প্রতিশ্রুতি প্ল্যানে পরিবর্তন করতে পারেন। ট্রায়াল শেষ হওয়ার পর এবং প্ল্যানটি সক্রিয় হয়ে গেলে, প্ল্যান আপডেট করার নিয়মগুলো অন্যান্য সাবস্ক্রিপশনের সক্রিয় প্ল্যানগুলোর মতোই। একটি ট্রায়াল সাবস্ক্রিপশনকে অবিলম্বে একটি সক্রিয় প্ল্যানে নিয়ে যেতে, একটি ৩০-দিনের ফ্রি ট্রায়াল সাবস্ক্রিপশন থেকে একটি পেইড পরিষেবা শুরু করুন । ৩০-দিনের ট্রায়াল সম্পর্কিত আরও তথ্য এবং গ্রাহক যোগ্যতার নিয়ম জানতে, অ্যাডমিন হেল্প সেন্টার দেখুন।

  • আপনি একটি ফ্লেক্সিবল প্ল্যানকে অ্যানুয়াল কমিটমেন্ট প্ল্যানে আপডেট করতে পারেন।

  • আপনি বার্ষিক প্রতিশ্রুতি পরিকল্পনা আপডেট করতে পারবেন না।

  • সব প্ল্যান সব প্রোডাক্টের সাথে কাজ করে না। এই প্ল্যানগুলোতে কোন কোন প্রোডাক্ট ব্যবহৃত হয়, সে সম্পর্কে আরও তথ্যের জন্য প্রোডাক্টস ও এসকেইউ (Products & SKUs ) দেখুন।

৩০-দিনের ট্রায়াল বা ফ্লেক্সিবল প্ল্যান সাবস্ক্রিপশনকে বার্ষিক কমিটমেন্ট প্ল্যানে আপডেট করতে, নিম্নলিখিত 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' পদ্ধতিটি ব্যবহার করে এই মানটি পেতে পারেন।

নিম্নলিখিত উদাহরণটি 123-এর 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"
}

একটি সাবস্ক্রিপশনের আসন আপডেট করুন

একটি বার্ষিক কমিটমেন্ট প্ল্যানের সাবস্ক্রিপশন আপডেট করার জন্য যে সাবস্ক্রিপশন প্রপার্টিগুলো ব্যবহৃত হয়, তা একটি গুগল ওয়ার্কস্পেস ফ্লেক্সিবল প্ল্যানের সাবস্ক্রিপশন আপডেট করার জন্য ব্যবহৃত প্রপার্টিগুলো থেকে ভিন্ন।

বার্ষিক প্ল্যানের সাবস্ক্রিপশনের জন্য আসন আপডেট করুন

বার্ষিক প্ল্যান সাবস্ক্রিপশনের ব্যবহারকারীর লাইসেন্স সেটিংস আপডেট করতে, নিম্নলিখিত 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

একটি গুগল ওয়ার্কস্পেস বার্ষিক কমিটমেন্ট প্ল্যানের সাবস্ক্রিপশন ইউজার লাইসেন্সের সংখ্যা আপডেট করার জন্য এই রিকোয়েস্ট বডি ব্যবহার করে। numberOfSeats ভ্যালুটি একটি মোট সংখ্যা। উদাহরণস্বরূপ, যদি আপনার আগে ১০টি ইউজার লাইসেন্স থাকে এবং একজন গ্রাহক ৫টি নতুন লাইসেন্সের জন্য অর্ডার দেন, তাহলে রিকোয়েস্ট বডিতে numberOfSeats এর মোট সংখ্যা হবে ১৫, যেমনটি নিচের উদাহরণে দেখানো হয়েছে: 

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

ফ্লেক্সিবল প্ল্যানের সাবস্ক্রিপশনের জন্য আসন আপডেট করুন।

একটি গুগল ওয়ার্কস্পেস ফ্লেক্সিবল প্ল্যানের সাবস্ক্রিপশন ব্যবহারকারীর লাইসেন্স আপডেট করার জন্য রিকোয়েস্ট বডি ব্যবহার করে। 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' পদ্ধতিটি ব্যবহার করে এই মানটি পেতে পারেন।

নিম্নলিখিত উদাহরণটিতে customerId হলো C0123456 এবং 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 : গ্রাহকের প্রাথমিক ডোমেইন নাম অথবা গ্রাহকের অনন্য শনাক্তকারী।

এই কলটি পূর্ববর্তী সাবস্ক্রিপশনটি বাতিল করে এবং একটি নতুন সাবস্ক্রিপশন তৈরি করে।

প্রোডাক্টস ও এসকেইউ পেজে আপগ্রেড এবং ডাউনগ্রেড সম্পর্কে আরও তথ্য জানুন।