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가 변경되므로 이 ID를 영구 데이터의 키로 사용하지 않는 것이 좋습니다. subscriptionId는 모든 리셀러 구독 가져오기 메서드를 사용하여 찾을 수 있습니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 Subscription의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.