Method: subscriptions.delete

정기 결제를 취소, 정지 또는 트랜스퍼합니다.

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에서 직접 결제를 설정하거나 다른 리셀러로 이전할 수 있습니다.