เรียกข้อมูลและอัปเดตการสมัครใช้บริการ

หลังจากดึงข้อมูลการสมัครใช้บริการแล้ว คุณสามารถใช้ข้อมูลจาก การตอบกลับที่สำเร็จเพื่อ เปลี่ยนสถานะของการสมัครใช้บริการ หรืออัปเดตการสมัครใช้บริการได้ หน้านี้จะเน้นที่วิธีการดึงข้อมูลและอัปเดตการสมัครใช้บริการ

ดึงข้อมูลการสมัครใช้บริการ

หากต้องการดึงข้อมูลการสมัครใช้บริการที่สั่งซื้อหรือโอนเรียบร้อยแล้ว ให้ใช้คำขอ HTTP GET ต่อไปนี้

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

แทนที่ค่าต่อไปนี้

CUSTOMER_ID: ชื่อโดเมนหลักของลูกค้า หรือตัวระบุที่ไม่ซ้ำกันของลูกค้า
SUBSCRIPTION_ID: ตัวระบุการสมัครใช้บริการที่ ไม่ซ้ำกันสำหรับลูกค้าแต่ละราย คุณเรียกค่านี้ได้โดยใช้เมธอดเรียกข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

การดำเนินการนี้ไม่มีพารามิเตอร์ในเนื้อหาคำขอ

การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ 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&pageToken=START_DATE&maxResults=MAX_NUMBER

แทนที่ค่าต่อไปนี้

CUSTOMER_ID: ชื่อโดเมนหลักของลูกค้า หรือตัวระบุที่ไม่ซ้ำกันของลูกค้า
START_DATE: วันที่เริ่มต้นในรูปแบบ YYYY-MM-DD
MAX_NUMBER: จำนวนผลลัพธ์สูงสุด ที่แสดงในหน้าการตอบกลับ

การดำเนินการนี้ไม่มีพารามิเตอร์ในเนื้อหาคำขอ

การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 และรายการการสมัครใช้บริการและการตั้งค่าของลูกค้า รายการการสมัครใช้บริการอาจมีผลิตภัณฑ์ที่ไม่ได้จัดการใน Reseller API เวอร์ชันนี้

หากคุณไม่ได้จัดการลูกค้า ระบบจะแสดงข้อผิดพลาด 403 Forbidden

ดึงข้อมูลการสมัครใช้บริการทั้งหมดที่โอนได้สำหรับลูกค้า

หากต้องการดึงข้อมูลการสมัครใช้บริการทั้งหมดของลูกค้าที่อาจโอนไปยังการจัดการของตัวแทนจำหน่าย ให้ใช้คำขอ GETHTTP ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ 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สถานะ ดูข้อมูลเพิ่มเติมได้ที่ โอนการสมัครใช้บริการ

ดึงข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

หากต้องการดึงข้อมูลการสมัครใช้บริการทั้งหมดที่ตัวแทนจำหน่ายสั่งซื้อหรือโอนสำเร็จ ให้ใช้คำขอ HTTP GET ต่อไปนี้และรวมโทเค็นการให้สิทธิ์

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 จะแตกต่างกันไปตามแพ็กเกจ โปรดพิจารณาสิ่งต่อไปนี้ก่อนอัปเดตแผน

เมื่อคุณสร้างการสมัครใช้บริการและลูกค้ามีสิทธิ์ แพ็กเกจการสมัครใช้บริการ อาจเป็นแบบทดลองใช้ 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: ตัวระบุการสมัครใช้บริการที่ ไม่ซ้ำกันสำหรับลูกค้าแต่ละราย คุณเรียกค่านี้ได้โดยใช้วิธีการเรียกข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

ตัวอย่างต่อไปนี้จะอัปเดตการสมัครใช้บริการด้วย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

อัปเดตที่นั่งสำหรับการสมัครใช้บริการแพ็กเกจรายปี

หากต้องการอัปเดตการตั้งค่าใบอนุญาตผู้ใช้ของการสมัครใช้บริการแพ็กเกจรายปี ให้ใช้คำขอ HTTP POST ต่อไปนี้

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

แทนที่ค่าต่อไปนี้

CUSTOMER_ID: ชื่อโดเมนหลักของลูกค้า หรือตัวระบุที่ไม่ซ้ำกันของลูกค้า
SUBSCRIPTION_ID: ตัวระบุการสมัครใช้บริการที่ ไม่ซ้ำกันสำหรับลูกค้าแต่ละราย คุณเรียกค่านี้ได้โดยใช้วิธีการเรียกข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

ตัวอย่างต่อไปนี้จะอัปเดตการสมัครใช้บริการด้วย 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 จะใช้คำขอ body เพื่ออัปเดตใบอนุญาตของผู้ใช้ 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"
}

อัปเดตการตั้งค่าการต่ออายุของการสมัครใช้บริการ

หากต้องการอัปเดตการตั้งค่าการต่ออายุการสมัครใช้บริการแบบสัญญาผูกมัดรายปี ให้ใช้คำขอ HTTP ของ POST ต่อไปนี้

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

แทนที่ค่าต่อไปนี้

CUSTOMER_ID: ชื่อโดเมนหลักของลูกค้า หรือตัวระบุที่ไม่ซ้ำกันของลูกค้า
SUBSCRIPTION_ID: ตัวระบุการสมัครใช้บริการที่ ไม่ซ้ำกันสำหรับลูกค้าแต่ละราย คุณเรียกค่านี้ได้โดยใช้วิธีการเรียกข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

ต่อไปนี้คือตัวอย่างเนื้อความของคำขอ

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

เริ่มบริการแบบชำระเงินจากการสมัครใช้บริการช่วงทดลองใช้ฟรี

หากต้องการย้ายการสมัครใช้บริการช่วงทดลองใช้ฟรี 30 วันไปยังการสมัครใช้บริการแบบชำระเงินทันที ในกรณีที่ได้ตั้งค่าแพ็กเกจการชำระเงินสำหรับการสมัครใช้บริการช่วงทดลองใช้แล้ว ให้ใช้POSTคำขอ HTTP ต่อไปนี้

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

แทนที่ค่าต่อไปนี้

CUSTOMER_ID: ชื่อโดเมนหลักของลูกค้า หรือตัวระบุที่ไม่ซ้ำกันของลูกค้า
SUBSCRIPTION_ID: ตัวระบุการสมัครใช้บริการที่ ไม่ซ้ำกันสำหรับลูกค้าแต่ละราย คุณเรียกค่านี้ได้โดยใช้วิธีการเรียกข้อมูลการสมัครใช้บริการทั้งหมดของตัวแทนจำหน่าย

ตัวอย่างต่อไปนี้มี 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