Method: subscriptions.insert
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
구독을 만들거나 이전합니다.
새 고객 계정 주문 메서드를 사용하여 주문한 고객 계정의 구독을 만듭니다. 다양한 요금제의 구독을 만드는 방법에 관한 자세한 내용은 구독 관리를 참고하세요.\
고객 삽입 방법을 사용하여 고객의 계정을 주문하지 않은 경우 해당 고객의 정기 결제를 만들 때 고객의 customerAuthToken를 사용하세요.
연결된 Google Drive 또는 Google Vault 구독과 함께 G Suite 구독을 이전하는 경우 일괄 작업을 사용하여 이러한 모든 구독을 이전합니다. 자세한 내용은 구독을 이전하는 방법을 참고하세요.
HTTP 요청
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
customerId |
string
고객의 기본 도메인 이름 또는 고객의 고유 식별자일 수 있습니다. 고객의 도메인 이름이 변경되면 이전 도메인 이름을 사용하여 고객에 액세스할 수 없지만 API에서 반환한 고객의 고유 식별자는 항상 사용할 수 있습니다. 해당하는 경우 고유 식별자를 시스템에 저장하는 것이 좋습니다.
|
쿼리 매개변수
| 매개변수 |
customerAuthToken |
string
직접 고객의 구독을 이전하거나 다른 리셀러 고객의 구독을 리셀러 관리로 이전하는 재판매 계정을 만들 때는 customerAuthToken 쿼리 문자열이 필요합니다. 정기 결제 이전을 완료하는 데 필요한 16진수 인증 토큰입니다. 자세한 내용은 관리자 고객센터를 참고하세요.
|
요청 본문
요청 본문에 Subscription의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Subscription의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/apps.order
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: subscriptions.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates or transfer a subscription.\n\nCreate a subscription for a customer's account that you ordered using the [Order a new customer account](/workspace/admin/reseller/v1/reference/customers/insert) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#create_subscription).\\\\\n\nIf you did not order the customer's account using the customer insert method, use the customer's `customerAuthToken` when creating a subscription for that customer.\n\nIf transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/workspace/admin/reseller/v1/how-tos/batch) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
