이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: subscriptions.delete

HTTP 요청
경로 매개변수
쿼리 매개변수
요청 본문
응답 본문
- JSON 표현
승인 범위
DeletionType
실습

정기 결제를 취소, 정지 또는 직접 채널로 이전합니다.

HTTP 요청

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

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

경로 매개변수

매개변수

매개변수
`customerId`	`string` 고객의 기본 도메인 이름 또는 고객의 고유 식별자 중 하나입니다. 고객의 도메인 이름이 변경되는 경우 이전 도메인 이름을 사용하여 고객에 액세스할 수 없지만, API에서 반환하는 고객의 고유 식별자는 항상 사용할 수 있습니다. 해당하는 경우 시스템에 고유 식별자를 저장하는 것이 좋습니다.
`subscriptionId`	`string` 필수 속성입니다. `subscriptionId`는 정기 결제 식별자이며 고객마다 고유합니다. 정기 결제가 업데이트되면 `subscriptionId`가 변경되므로 이 ID를 영구 데이터의 키로 사용하지 않는 것이 좋습니다. `subscriptionId`는 모든 리셀러 구독 검색 메서드를 사용하여 찾을 수 있습니다.

customerId

string

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

subscriptionId

string

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

쿼리 매개변수

매개변수

매개변수
`deletionType`	`enum (DeletionType)` `deletionType` 쿼리 문자열을 사용하면 정기 결제의 취소, 다운그레이드 또는 정지를 사용 설정할 수 있습니다.

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" }`.

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