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 ของ Subscriptions.changePlan คำขอ Rpc

การแสดง 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 เพื่อรับราคาที่มีส่วนลด พร็อพเพอร์ตี้นี้เป็นแบบไม่บังคับ หากเพิ่มรหัสดีลในการสมัครใช้บริการแล้ว พร็อพเพอร์ตี้นี้อาจปล่อยว่างไว้และอัตราส่วนลดที่มีอยู่จะยังคงมีผล (หากไม่ว่างเปล่า ให้ระบุเฉพาะรหัสดีลที่อยู่ในการสมัครใช้บริการอยู่แล้ว) หากไม่เคยเพิ่มรหัสดีลในการสมัครใช้บริการและปล่อยพร็อพเพอร์ตี้นี้ว่างไว้ ระบบจะใช้ราคาปกติ