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

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