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

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

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

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

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

ลูกค้าที่มี customerType = 'team' จะซื้อได้เฉพาะ Essentials และ Google Workspace รุ่น 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) ที่ไม่ซ้ำกัน ของคุณ สำหรับข้อมูลเพิ่มเติม โปรดดู ผลิตภัณฑ์และ รหัส 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"
}

สร้างแผนแบบยืดหยุ่น

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

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

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

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

หากต้องการสร้างการสมัครใช้บริการสําหรับบัญชีลูกค้าที่คุณไม่ได้สั่งซื้อ ให้ใช้ คำขอ 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) ที่ไม่ซ้ำกัน ของคุณ สำหรับข้อมูลเพิ่มเติม โปรดดู ผลิตภัณฑ์และ รหัส 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 ที่ customervally จริงถูกส่งคืนเป็น transferInfo.currentLegacySkuId สำหรับ รายการ skuIds ทั้งหมดและผลิตภัณฑ์ที่แพ็กเกจเหล่านี้ใช้ ดู ผลิตภัณฑ์และ SKU

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