고객의 계정을 주문한 후, 다음과 같은 여러 가지 구독을 만들 수 있습니다.
- 연간 약정 구독
- 탄력 요금제 구독
- 30일 무료 체험판
- 할인된 구독
이러한 구독에서 사용하는 제품에 대한 자세한 내용은 제품 및 SKU를 참고하세요.
고객의 계정을 주문하지 않은 경우 구독을 이전할 수 있습니다.
customerType = 'team'인 고객은 Google Workspace의 Google Workspace Essentials
및 Google Workspace Enterprise Essentials 버전만 구매할 수 있습니다. 다른 Google Workspace 구독을 구매하려고 하면 Customer is not eligible to purchase this subscription 오류가 발생합니다.
Essentials 또는 사용량 기반 구독을 구매하는 고객은 연간 약정 요금제를 사용하지 못할 수 있으며 업그레이드 및 다운그레이드 옵션이 제한됩니다.
구독 만들기
새 고객 계정의 구독을 만들려면 다음 POST HTTP 요청을 사용하고 승인 토큰을 포함합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID는 고객의 기본
도메인 이름 또는 재판매된 고객 계정을 검색할 때 반환되는 고객의 고유 식별자입니다.
연간 약정 요금제 만들기
연간 약정 요금제 구독의 경우 모든 SKU에 동일한 기본 갱신 설정이 적용되지는 않습니다. 항상 renewalSettings를 전달하는 것이 좋습니다. 10개의 좌석으로 연간 약정 구독을 만듭니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"renewalSettings": {
"renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SKU_ID: 고유 재고 관리 단위 (SKU) 식별자입니다. 자세한 내용은 제품 및 SKU ID를 참고하세요.PURCHASE_ORDER_ID: 사용량을 추적하는 데 사용할 수 있는 구매 주문 ID(선택사항)입니다.
응답에 HTTP 200 상태와 연간 약정 요금제의 새 구독 설정이 반환됩니다. ANNUAL_MONTHLY_PAY
는 모든 API 응답에서 ANNUAL로 반환됩니다.
다음은 연간 요금제 응답의 예입니다.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
탄력 요금제 만들기
새 고객 계정의 탄력 요금제 구독을 만들려면 다음 POST HTTP 요청을 사용하고 승인 토큰을 포함합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "FLEXIBLE"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SKU_ID: 고유 재고 관리 단위 (SKU) 식별자입니다. 자세한 내용은 제품 및 SKU ID를 참고하세요.PURCHASE_ORDER_ID: 사용량을 추적하는 데 사용할 수 있는 구매 주문 ID(선택사항)입니다.
다음은 탄력 요금제 응답의 예입니다.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
무료 체험판 만들기
새 고객 계정의 30일 무료 체험판 구독을 만들려면 다음 POST HTTP 요청을 사용하고 승인 토큰을 포함합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "TRIAL"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SKU_ID: 고유 재고 관리 단위 (SKU) 식별자입니다. 자세한 내용은 제품 및 SKU ID를 참고하세요.PURCHASE_ORDER_ID: 사용량을 추적하는 데 사용할 수 있는 구매 주문 ID(선택사항)입니다.
다음은 30일 무료 체험판 요금제 응답의 예입니다.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
할인 구독 만들기
Google은 할인된 요금으로 구독을 만들 수 있는 딜 코드를 제공할 수 있습니다. 구독을 할인하려면 구독 insert 호출에서 딜 코드를 제공해야 합니다. 고객이 원래 SKU를 변경하면 할인이 삭제됩니다.
새 고객 계정의 할인된 연간 약정 구독을 만들려면 다음 POST HTTP 요청을 사용하고 승인 토큰을 포함합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
"renewalSettings": {
"renewalType": "RENEW_CURRENT_USERS_MONTHLY_PAY"
},
"purchaseOrderId": "PURCHASE_ORDER_ID",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SKU_ID: 고유 재고 관리 단위 (SKU) 식별자입니다. 자세한 내용은 제품 및 SKU ID를 참고하세요.PURCHASE_ORDER_ID: 사용량을 추적하는 데 사용할 수 있는 구매 주문 ID(선택사항)입니다.GOOGLE_CONTRACT_DEAL_CODE: Google에서 제공하는 할인 코드입니다.
다음은 할인된 연간 요금제 응답의 예입니다.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
구독 이전하기
새 고객 계정 주문 작업을 사용하여 고객의 계정을 주문하지 않은 경우 해당 고객의 구독을 만들 때 고객의 이전 토큰을 사용합니다.
주문하지 않은 고객 계정의 구독을 만들려면 다음 POST HTTP 요청을 사용합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.TOKEN_VALUE: 고객이 제공하는 이전 토큰입니다. 고객이 토큰을 생성한 후 30일 동안 유효합니다.
고객이 이전 토큰을 가져오는 방법에 대한 자세한 내용은 관리자 고객센터를 참고하세요.
연간 약정 요금제 고객의 구독을 이전하려면 다음 POST HTTP 요청을 사용하고 승인 토큰을 포함합니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SKU_ID: 고유 재고 관리 단위 (SKU) 식별자입니다. 자세한 내용은 제품 및 SKU ID를 참고하세요.PURCHASE_ORDER_ID: 사용량을 추적하는 데 사용할 수 있는 구매 주문 ID(선택사항)입니다.
응답에 HTTP 200 상태 코드와 이전된 연간 약정 요금제의 구독 설정이 반환됩니다.
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
이전 제한사항
연결된
Google Drive 또는 Google Vault 구독이 있는 Google Workspace 구독을 이전하는 경우
batch 작업을 사용하여
ACTIVE 상태의 모든 구독을 이전합니다. 각 구독을 하나씩 이전하면 오류가 발생합니다.
일시중지 사유가 PENDING_TOS_ACCEPTANCE, TRIAL_ENDED 또는 RENEWAL_WITH_TYPE_CANCEL인 경우에만 일시중지된 구독을 이전할 수 있습니다.
기존 SKU를 이전할 때 subscriptions.list는 이전해야 하는 SKU의 skuId를 반환합니다. 고객이 실제로 보유한 SKU의 skuId는 transferInfo.currentLegacySkuId로 반환됩니다. 이러한 요금제에서 사용하는 skuIds의 전체 목록과 제품은 제품 및 SKU를 참고하세요.
이전은 할인 딜 코드와 호환되지 않습니다.