Method: subscriptions.changePlan

อัปเดตแพ็กเกจการสมัครใช้บริการ ใช้วิธีนี้เพื่ออัปเดตแพ็กเกจสําหรับช่วงทดลองใช้ 30 วันหรือการสมัครใช้บริการแพ็กเกจแบบยืดหยุ่นเป็นแพ็กเกจสัญญาผูกมัดรายปีซึ่งมีการชําระเงินรายเดือนหรือรายปี

วิธีอัปเดตแพ็กเกจจะแตกต่างกันไปตามแพ็กเกจและผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้จากคำอธิบายในจัดการการสมัครใช้บริการ

คำขอ HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ซึ่งอาจเป็นชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำกันของลูกค้าก็ได้ หากชื่อโดเมนของลูกค้ามีการเปลี่ยนแปลง คุณจะใช้ชื่อโดเมนเดิมเพื่อเข้าถึงลูกค้าไม่ได้ แต่จะใช้ตัวระบุที่ไม่ซ้ำกันของลูกค้า (ตามที่ API ส่งคืน) ได้เสมอ เราขอแนะนำให้จัดเก็บตัวระบุที่ไม่ซ้ำกันในระบบของคุณ (หากมี)
subscriptionId

string

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

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ ChangePlanRequest

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Subscription

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/apps.order

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์

ChangePlanRequest

เทมเพลต JSON สำหรับคำขอ rpc ของข้างเขตสมัครใช้บริการ.changePlan

การแสดง JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
ช่อง
kind

string

ระบุทรัพยากรว่าเป็นคำขอเปลี่ยนแพ็กเกจการสมัครใช้บริการ ค่า: subscriptions#changePlanRequest
planName

string

ต้องระบุพร็อพเพอร์ตี้ planName นี่คือชื่อแพ็กเกจการชำระเงินของการสมัครใช้บริการ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับแพ็กเกจการชำระเงินของ Google ที่แนวคิด API

ค่าที่เป็นไปได้มีดังนี้

  • ANNUAL_MONTHLY_PAY - แพ็กเกจสัญญาผูกมัดรายปีซึ่งชำระเงินเป็นรายเดือน
  • ANNUAL_YEARLY_PAY - แพ็กเกจสัญญาผูกมัดรายปีซึ่งมีการชำระเงินเป็นรายปี
  • FLEXIBLE - แพ็กเกจแบบยืดหยุ่น
  • TRIAL - แผนทดลองใช้ฟรี 30 วัน

seats

object (Seats)

นี่คือพร็อพเพอร์ตี้ที่จำเป็น พร็อพเพอร์ตี้ใบอนุญาตคือจำนวนใบอนุญาตใบอนุญาตของผู้ใช้
purchaseOrderId

string

พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ ข้อมูลใบสั่งซื้อ (PO) นี้มีไว้สำหรับตัวแทนจำหน่ายเพื่อใช้ติดตามการใช้งานของบริษัท หากระบุค่า purchaseOrderId ค่าดังกล่าวจะปรากฏในการตอบกลับ API และปรากฏในใบแจ้งหนี้ ที่พักรองรับอักขระที่เป็นข้อความธรรมดาสูงสุด 80 ตัว
dealCode

string

รหัสที่ออกโดย Google (สูงสุด 100 อักขระ) สำหรับราคาส่วนลดของแพ็กเกจการสมัครใช้บริการ ต้องระบุรหัสดีลในคำขอ changePlan เพื่อรับอัตราส่วนลด พร็อพเพอร์ตี้นี้ไม่บังคับ หากเพิ่มรหัสดีลในการสมัครใช้บริการแล้ว พร็อพเพอร์ตี้นี้ปล่อยว่างไว้และราคาที่มีส่วนลดจะยังคงมีผลอยู่ (หากเพิ่มรหัสดีลที่มีอยู่ในการสมัครใช้บริการเท่านั้น ให้ระบุเฉพาะรหัสดีลที่อยู่ในการสมัครใช้บริการอยู่แล้ว) หากยังไม่เคยเพิ่มรหัสดีลในการสมัครใช้บริการและพร็อพเพอร์ตี้นี้เว้นว่างไว้ ระบบจะใช้ราคาปกติ