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

สร้างหรือโอนการสมัครใช้บริการ

หลังจากสั่งซื้อบัญชีของลูกค้าแล้ว คุณสามารถสร้างการสมัครใช้บริการต่างๆ ต่อไปนี้

การสมัครใช้บริการแบบสัญญาผูกมัดรายปี
การสมัครใช้บริการแบบยืดหยุ่น
ช่วงทดลองใช้ฟรี 30 วัน
การสมัครใช้บริการแบบมีส่วนลด

ดูข้อมูลเพิ่มเติมเกี่ยวกับผลิตภัณฑ์ที่ใช้การสมัครใช้บริการเหล่านี้ได้ที่หัวข้อผลิตภัณฑ์และ SKU

หากไม่ได้สั่งซื้อบัญชีของลูกค้ารายนี้ คุณจะโอนการสมัครใช้บริการได้

ลูกค้าที่มี customerType = 'team' จะซื้อได้เฉพาะ Google Workspace รุ่น Essentials และ Enterprise Essentials หากคุณพยายามซื้อการสมัครใช้บริการ Google Workspace อื่นๆ คุณจะได้รับข้อผิดพลาด Customer is not eligible to purchase this subscription ลูกค้าที่กำลังซื้อ Essentials หรือการสมัครใช้บริการแบบตามการใช้งานอาจใช้แพ็กเกจแบบผูกมัดรายปีไม่ได้ และมีตัวเลือกการอัปเกรดและดาวน์เกรดแบบจำกัด

สร้างการสมัครใช้บริการ

หากต้องการสร้างการสมัครใช้บริการสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้POSTคำขอ HTTP ต่อไปนี้และใส่โทเค็นการให้สิทธิ์

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) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรหัสผลิตภัณฑ์และ SKU
PURCHASE_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"
}

สร้างแพ็กเกจแบบยืดหยุ่น

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

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) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรหัสผลิตภัณฑ์และ SKU
PURCHASE_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 วันสำหรับบัญชีของลูกค้าที่สร้างขึ้นใหม่ ให้ใช้POSTคำขอ HTTP ต่อไปนี้และใส่โทเค็นการให้สิทธิ์

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) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรหัสผลิตภัณฑ์และ SKU
PURCHASE_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 เดิม ระบบจะนำส่วนลดออก

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

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) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรหัสผลิตภัณฑ์และ SKU
PURCHASE_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"
}

โอนการสมัครใช้บริการ

หากคุณไม่ได้สั่งซื้อบัญชีของลูกค้าโดยใช้การดำเนินการสั่งซื้อบัญชีลูกค้าใหม่ ให้ใช้โทเค็นการโอนของลูกค้าเมื่อสร้างการสมัครใช้บริการของลูกค้ารายนั้น

หากต้องการสร้างการสมัครใช้บริการสำหรับบัญชีลูกค้าที่คุณไม่ได้สั่งซื้อ ให้ใช้POSTคำขอ HTTP ต่อไปนี้

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ลูกค้าจะได้รับโทเค็นการโอนได้ที่ศูนย์ช่วยเหลือของ Google Workspace

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

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) ที่ไม่ซ้ำกัน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรหัสผลิตภัณฑ์และ SKU
PURCHASE_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

การโอนใช้ไม่ได้กับรหัสดีลส่วนลด