หลังจากที่สั่งซื้อบัญชีของลูกค้าแล้ว คุณจะสร้างการสมัครใช้บริการที่แตกต่างกันได้หลายรายการ ดังนี้
- การสมัครใช้บริการแบบมีสัญญาผูกมัดรายปี
- การสมัครใช้บริการที่ยืดหยุ่น
- ช่วงทดลองใช้ฟรี 30 วัน
- การสมัครใช้บริการแบบมีส่วนลด
ดูข้อมูลเพิ่มเติมเกี่ยวกับผลิตภัณฑ์ที่การสมัครใช้บริการเหล่านี้ใช้ได้ที่ผลิตภัณฑ์และ SKU
หากคุณไม่ได้สั่งซื้อบัญชีของลูกค้ารายนี้ คุณสามารถโอนการสมัครใช้บริการได้
ลูกค้าที่มี customerType = 'team'
จะซื้อได้เฉพาะ Google Workspace รุ่น Essentials และ Enterprise Essentials หากพยายามซื้อการสมัครใช้บริการ Google Workspace อื่นๆ คุณจะได้รับข้อผิดพลาด Customer is not eligible to purchase this subscription
ลูกค้าที่ซื้อ Essentials หรือการสมัครใช้บริการตามการใช้งานอาจจัดการแพ็กเกจแบบสัญญาผูกมัดรายปีไม่ได้ รวมถึงมีตัวเลือกการอัปเกรดและดาวน์เกรดแบบจำกัด
สร้างการสมัครใช้บริการ
หากต้องการสร้างการสมัครใช้บริการสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้คำขอ HTTP POST
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID
อาจเป็นชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าที่แสดงขึ้นเมื่อเรียกข้อมูลในบัญชีของลูกค้าจากพาร์ทเนอร์
สร้างแพ็กเกจสัญญาผูกมัดรายปี
สำหรับการสมัครใช้บริการแพ็กเกจรายปี SKU บางรายการอาจมีการตั้งค่าการต่ออายุเริ่มต้นเหมือนกัน เราขอแนะนำให้ข้าม renewalSettings
เสมอ สร้างการสมัครใช้บริการแบบมีสัญญาผูกมัดรายปีที่มี 10 ใบ ดังนี้
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "kind": "subscriptions#seats", "numberOfSeats": 10 }, renewalSettings: { "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY' }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าSKU_ID
: ตัวระบุสต็อกคีปปิ้งยูนิต (SKU) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ผลิตภัณฑ์และรหัส SKUPURCHASE_ORDER_ID
: รหัสใบสั่งซื้อ (ไม่บังคับ) สำหรับใช้ติดตามการใช้งาน
การตอบกลับที่สำเร็จจะแสดงสถานะ HTTP 200
และการตั้งค่าของการสมัครใช้บริการใหม่สำหรับแพ็กเกจสัญญาผูกมัดรายปี ANNUAL_MONTHLY_PAY
จะแสดงผลเป็น ANNUAL
ในการตอบกลับจาก API ทั้งหมด
ต่อไปนี้เป็นตัวอย่างการตอบกลับสำหรับแพ็กเกจรายปี
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"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": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
สร้างแผนแบบยืดหยุ่น
หากต้องการสร้างการสมัครใช้บริการแบบยืดหยุ่นสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้คำขอ HTTP POST
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "FLEXIBLE" }, "seats": { "kind": "subscriptions#seats", "maximumNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าSKU_ID
: ตัวระบุสต็อกคีปปิ้งยูนิต (SKU) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ผลิตภัณฑ์และรหัส SKUPURCHASE_ORDER_ID
: รหัสใบสั่งซื้อ (ไม่บังคับ) สำหรับใช้ติดตามการใช้งาน
ต่อไปนี้เป็นตัวอย่างการตอบสนองของแผนแบบยืดหยุ่น
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
สร้างช่วงทดลองใช้ฟรี
ในการสร้างการสมัครใช้บริการช่วงทดลองใช้ฟรี 30 วันสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้คำขอ HTTP POST
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ไว้ด้วย
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "TRIAL" }, "seats": { "kind": "subscriptions#seats", "maximumNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าSKU_ID
: ตัวระบุสต็อกคีปปิ้งยูนิต (SKU) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ผลิตภัณฑ์และรหัส SKUPURCHASE_ORDER_ID
: รหัสใบสั่งซื้อ (ไม่บังคับ) สำหรับใช้ติดตามการใช้งาน
ต่อไปนี้เป็นตัวอย่างการตอบสนองของแพ็กเกจทดลองใช้ฟรี 30 วัน
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
สร้างการสมัครใช้บริการส่วนลด
Google อาจให้รหัสดีลสำหรับการสร้างการสมัครใช้บริการในราคาหลังหักส่วนลด หากต้องการลดราคาการสมัครใช้บริการ คุณต้องระบุรหัสดีลในการเรียก insert
ของการสมัครใช้บริการ หากลูกค้าเปลี่ยนจาก SKU เดิม ระบบจะนำส่วนลดออก
หากต้องการสร้างการสมัครสัญญาผูกมัดรายปีแบบมีส่วนลดสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้คำขอ HTTP POST
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ไว้ด้วย
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions { "kind": "reseller#subscription", "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "kind": "subscriptions#seats", "numberOfSeats": 10 }, renewalSettings: { "renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY' }, "purchaseOrderId": "PURCHASE_ORDER_ID", "dealCode": "GOOGLE_CONTRACT_DEAL_CODE" }
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าSKU_ID
: ตัวระบุสต็อกคีปปิ้งยูนิต (SKU) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ผลิตภัณฑ์และรหัส SKUPURCHASE_ORDER_ID
: รหัสใบสั่งซื้อ (ไม่บังคับ) สำหรับใช้ติดตามการใช้งานGOOGLE_CONTRACT_DEAL_CODE
: รหัสส่วนลด จาก Google
ต่อไปนี้คือตัวอย่างการตอบกลับเกี่ยวกับแพ็กเกจรายปีที่มีส่วนลด
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"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": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
โอนการสมัครใช้บริการ
หากคุณไม่ได้สั่งซื้อบัญชีของลูกค้าโดยใช้การดำเนินการสั่งซื้อบัญชีลูกค้าใหม่ ให้ใช้โทเค็นการโอนของลูกค้าเมื่อสร้างการสมัครใช้บริการสำหรับลูกค้ารายนั้น
หากต้องการสร้างการสมัครใช้บริการสำหรับบัญชีของลูกค้าที่คุณไม่ได้สั่งซื้อ ให้ใช้คำขอ HTTP POST
ต่อไปนี้
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าTOKEN_VALUE
: โทเค็นการโอนที่ลูกค้าให้ไว้ หลังจากที่ลูกค้าสร้างโทเค็นแล้ว โทเค็นดังกล่าวมีอายุ 30 วัน
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ลูกค้าได้รับโทเค็นการโอนที่ศูนย์ช่วยเหลือของ Google Workspace
หากต้องการโอนการสมัครใช้บริการของลูกค้าแพ็กเกจรายปี ให้ใช้คำขอ HTTP POST
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token { "customerId": "CUSTOMER_ID", "skuId": "SKU_ID", "plan": { "planName": "ANNUAL_MONTHLY_PAY" }, "seats": { "numberOfSeats": 10, "licensedNumberOfSeats": 10 }, "purchaseOrderId": "PURCHASE_ORDER_ID" }
แทนที่รายการต่อไปนี้
CUSTOMER_ID
: ชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าSKU_ID
: ตัวระบุสต็อกคีปปิ้งยูนิต (SKU) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่ผลิตภัณฑ์และรหัส SKUPURCHASE_ORDER_ID
: รหัสใบสั่งซื้อ (ไม่บังคับ) สำหรับใช้ติดตามการใช้งาน
การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200
และการตั้งค่าของการสมัครใช้บริการที่โอนสำหรับแพ็กเกจสัญญาผูกมัดรายปี ดังนี้
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"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": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
ข้อจำกัดในการโอน
หากโอนการสมัครใช้บริการ Google Workspace ที่มีการสมัครใช้บริการ Google ไดรฟ์หรือ Google ห้องนิรภัยที่เชื่อมโยง ให้ใช้การดำเนินการ batch
เพื่อโอนการสมัครใช้บริการทั้งหมดที่มีสถานะ ACTIVE
การโอนการสมัครใช้บริการทีละรายการจะทำให้เกิดข้อผิดพลาด
อนุญาตให้โอนการสมัครใช้บริการที่ถูกระงับก็ต่อเมื่อเหตุผลในการระงับคือ PENDING_TOS_ACCEPTANCE
, TRIAL_ENDED
หรือ RENEWAL_WITH_TYPE_CANCEL
เมื่อโอน SKU เดิม subscriptions.list
จะส่งกลับ skuId
ของ SKU ที่ต้องโอน skuId
ของ SKU ที่ลูกค้าได้รับจะส่งคืนเป็น transferInfo.currentLegacySkuId
หากต้องการดูรายการ skuIds
ทั้งหมดและผลิตภัณฑ์ที่แพ็กเกจเหล่านี้ใช้ โปรดดูผลิตภัณฑ์และ SKU
ทั้งนี้การโอนใช้กับรหัสดีลส่วนลดไม่ได้