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

이 ID는 고객의 기본 도메인 이름이거나 고객 고유 식별자입니다. 고객의 도메인 이름이 변경되면 이전 도메인 이름은 고객에게 액세스할 수 없지만, API에서 반환하는 고객의 고유 식별자는 항상 사용할 수 있습니다. 해당하는 경우 시스템에 고유 식별자를 저장하는 것이 좋습니다.
subscriptionId

string

필수 속성입니다. subscriptionId는 정기 결제 식별자로 고객마다 고유합니다. 정기 결제가 업데이트되면 subscriptionId가 변경되므로 이 ID를 영구 데이터의 키로 사용하지 않는 것이 좋습니다. 모든 리셀러 구독 검색 메서드를 사용하여 subscriptionId를 찾을 수 있습니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

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