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