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

사용자가 고객 계정 주문 다양한 구독을 만들 수 있습니다.

  • 연간 약정 구독
  • 유연한 구독
  • 30일 무료 체험
  • 할인된 가격에 구독

이러한 정기 결제에서 사용하는 제품에 관한 자세한 내용은 다음을 참고하세요. 제품 및 SKU.

이 고객의 계정을 주문하지 않은 경우 다음을 할 수 있습니다. 구독 이전

customerType = 'team' 요금제를 사용하는 고객은 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"
}

무료 체험판 만들기

새로 생성된 고객의 다음 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: 할인 코드 사용 가능 확인하세요.

다음은 할인 연간 요금제 응답의 예시입니다.

{
  "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 Workspace 구독을 이전하는 경우 Google Vault를 구독하는 경우에는 batch 작업 ACTIVE 상태인 모든 정기 결제를 이전해야 합니다. 각각 전송 하나씩 구독하면 오류가 발생합니다.

정지된 구독의 이전은 정지 사유가 다음과 같은 경우에만 허용됩니다. PENDING_TOS_ACCEPTANCE, TRIAL_ENDED 또는 RENEWAL_WITH_TYPE_CANCEL입니다.

기존 SKU를 이전할 때 subscriptions.list가 skuId를 반환합니다. 이전해야 하는 SKU의 수입니다. 해당 SKU의 skuId 고객이 실제로 transferInfo.currentLegacySkuId로 반환됩니다. skuIds의 전체 목록과 이러한 요금제에서 사용되는 제품에 관한 자세한 내용은 다음을 참고하세요. 제품 및 SKU.

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