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

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