หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

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

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

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" จะ ส่งคืนแล้ว

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

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

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

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 วันหรือการสมัครใช้บริการแพ็กเกจแบบยืดหยุ่นเป็นแบบรายปี โปรดใช้คำขอ HTTP POST ต่อไปนี้

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

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