Method: subscriptions.suspend

ระงับการสมัครใช้บริการที่ใช้งานอยู่

คุณสามารถใช้วิธีนี้เพื่อระงับการสมัครใช้บริการแบบชำระเงินที่ปัจจุบันอยู่ในสถานะ ACTIVE

  • ระบบจะหยุดการเรียกเก็บเงินชั่วคราวสำหรับการสมัครใช้บริการ FLEXIBLE
  • สําหรับการสมัครใช้บริการ ANNUAL_MONTHLY_PAY หรือ ANNUAL_YEARLY_PAY ให้ทําดังนี้
    • การระงับการสมัครใช้บริการจะไม่เปลี่ยนวันที่ต่ออายุตามที่ได้ตกลงไว้ตั้งแต่แรก
    • การสมัครใช้บริการที่ถูกระงับจะไม่ต่ออายุ  หากคุณเปิดใช้งานการสมัครใช้บริการหลังจากวันที่ต่ออายุเดิม ระบบจะสร้างการสมัครใช้บริการรายปีใหม่โดยเริ่มนับจากวันที่เปิดใช้งาน

เราขอแนะนำให้คุณระงับการสมัครใช้บริการเป็นระยะเวลาสั้นๆ เท่านั้นเนื่องจากการระงับนานกว่า 60 วันอาจส่งผลให้การสมัครใช้บริการถูกยกเลิก

คำขอ HTTP

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

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

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

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

string

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

subscriptionId

string

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

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

เนื้อหาของคำขอต้องว่างเปล่า

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

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

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

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

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

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