정기 결제 만들기 또는 이전하기

고객 계정을 주문한 후 다양한 구독을 만들 수 있습니다.

  • 연간 약정 구독
  • 유연한 구독
  • 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의 skuIdtransferInfo.currentLegacySkuId로 반환됩니다. skuIds의 전체 목록과 이러한 요금제에서 사용되는 제품은 제품 및 SKU를 참고하세요.

할인 특가 코드는 이전할 수 없습니다.