Method: subscriptions.delete

정기 결제를 취소, 정지하거나 Direct로 이전합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customerId

string

이 이름은 고객의 기본 도메인 이름 또는 고객의 고유 식별자일 수 있습니다. 고객의 도메인 이름이 변경되면 고객에게 액세스하는 데 기존 도메인 이름을 사용할 수 없지만 API에서 반환하는 고객의 고유 식별자는 언제든지 사용할 수 있습니다. 해당하는 경우 시스템에 고유 식별자를 저장하는 것이 좋습니다.
subscriptionId

string

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

쿼리 매개변수

매개변수
deletionType

enum (DeletionType)

deletionType 쿼리 문자열은 구독 취소, 다운그레이드, 정지를 사용 설정합니다.

요청 본문

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

응답 본문

임의의 HTTP 본문을 나타내는 메시지입니다. 원시 바이너리나 HTML 페이지와 같이 JSON으로 표현할 수 없는 페이로드 형식에만 사용해야 합니다.

이 메시지는 요청과 응답에서 스트리밍 및 스트리밍이 아닌 API 메소드에 모두 사용될 수 있습니다.

또한 최상위 요청 필드로 사용할 수 있으며, URL 또는 HTTP 템플릿에서 요청 필드로 매개변수를 추출하려는 경우와 원시 HTTP 본문에 액세스하려는 경우 편리하게 사용할 수 있습니다.

예를 들면 다음과 같습니다.

message GetResourceRequest {
  // A unique request id.
  string requestId = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

스트리밍 메소드의 예:

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

이 유형을 사용하면 요청 및 응답 본문을 처리하는 방법만 변경되며, 다른 모든 기능은 변경되지 않고 계속 작동합니다.

성공한 경우 응답은 형식이 메서드에 의해 정의되는 일반 HTTP 응답입니다.

JSON 표현 
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
contentType

string

본문의 콘텐츠 유형을 지정하는 HTTP Content-Type 헤더 값입니다.
data

string (bytes format)

원시 바이너리인 HTTP 요청/응답 본문입니다.

base64 인코딩 문자열입니다.
extensions[]

object

애플리케이션별 응답 메타데이터입니다. 스트리밍 API의 첫 번째 응답에서 설정되어야 합니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

승인 범위

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

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

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

DeletionType

열거형
deletion_type_undefined
cancel 정기 결제를 즉시 취소합니다. G Suite 구독에는 적용되지 않습니다.
transfer_to_direct

구독을 Google로 직접 이전합니다. 고객은 즉시 Google과의 직접 결제 관계로 전환되며 짧은 시간 동안 서비스 중단 없이 제공됩니다. 그런 다음 고객은 신용카드를 사용하여 Google에서 직접 결제를 설정하거나 다른 리셀러로 이전할 수 있습니다.