고객 계정을 주문한 후 다음과 같은 다양한 정기 결제를 만들 수 있습니다.
- 연간 약정 구독
- 유연한 구독
- 30일 무료 체험
- 할인된 가격으로 제공되는 구독
이러한 구독에서 사용하는 제품에 대한 자세한 내용은 제품 및 SKU를 참고하세요.
이 고객의 계정을 주문하지 않은 경우 구독을 이전할 수 있습니다.
customerType = 'team'가 있는 고객은 Google Workspace의 Essentials 및 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일 동안 유효합니다.
고객이 이전 토큰을 받는 방법에 관한 자세한 내용은 Google Workspace 고객센터를 참고하세요.
연간 약정 요금제 고객의 구독을 이전하려면 다음 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를 참고하세요.
할인 특가 코드는 송금에 사용할 수 없습니다.