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