구독 검색 및 업데이트

구독을 검색한 후 성공적인 응답을 정기 결제 상태 변경 구독을 업데이트하세요 이 페이지에서는 API를 사용하여 구독을 검색하고 업데이트할 수 있습니다

구독 가져오기

주문 또는 이전된 정기 결제를 검색하려면 다음을 사용하세요. 다음 GETHTTP 요청입니다.

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID

다음을 바꿉니다.

이 작업은 요청 본문에 매개변수가 없습니다.

성공 응답이 수신되면 HTTP 200 상태가 반환됩니다. 정기 결제 설정을 변경할 수 있습니다. 다음 응답 예에서 isInTrial 속성이 false 상태이지만 없음 trialEndTime 속성입니다. 이 고객은 이전에 이 요금제로 30일 무료 체험.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "billingMethod": "ONLINE",
  "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": "RENEW_CURRENT_USERS_MONTHLY_PAY"
  },
  "purchaseOrderId": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
  "skuName": "Google Workspace Business Standard"
}

고객의 모든 구독 가져오기

특정 리셀러 고객의 구독을 모두 검색하려면 주문 또는 전송된 경우 다음 GET HTTP 요청을 사용하고 다음과 같이 승인 토큰을 포함합니다.

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID value&pageToken=START_DATE&maxResults=MAX_NUMBER

다음을 바꿉니다.

  • CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.
  • START_DATE: YYYY-MM-DD입니다.
  • MAX_NUMBER: 반환된 결과의 최대 개수 응답 페이지에 표시됩니다.

이 작업은 요청 본문에 매개변수가 없습니다.

성공 응답이 수신되면 HTTP 200 상태 코드와 고객의 구독 및 설정 정기 결제 목록에는 리셀러 API의 이 버전에서 관리되지 않는 제품

이 고객을 관리하지 않는 경우 403 "Forbidden" 오류가 발생합니다. 반환합니다.

고객의 이전 가능한 모든 구독 가져오기

'구독'이 될 수 있는 고객의 구독을 모두 검색하기 위해 리셀러의 관리로 이전된 경우 다음 GET HTTP 요청을 사용합니다. 승인 토큰을 포함합니다. 이 customerId는 필수 항목이며 다음 경우에 반환되는 고객의 고유 식별자입니다. 리셀러 고객의 계정 가져오기에 대해 자세히 알아보세요. customerAuthToken는 고객이 제공하는 이전 토큰이며, 사용할 수 있습니다. 고객이 생성한 후에는 30일 고객이 토큰을 생성하는 방법에 대한 자세한 내용은 다음을 참조하세요. Google Workspace 계정을 리셀러로 이전하기

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerId=CUSTOMER_ID&customerAuthToken=AUTH_TOKEN&pageToken=START_DATE&maxResults=MAX_NUMBER

다음을 바꿉니다.

  • CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.
  • AUTH_TOKEN: 특정 리셀러 ID와 관련이 있습니다. 모델이 생성한 후에는 30일 동안 유효합니다. 고객이 생성하는 방법을 알아보려면 Google Workspace 계정을 리셀러로 이전하기 이 값이 유효하지 않거나 만료된 경우 API 응답은 오류 403 "Forbidden"개
  • START_DATE: YYYY-MM-DD입니다.
  • MAX_NUMBER: 반환된 결과의 최대 개수 응답 페이지에 표시됩니다.

이 작업은 요청 본문에 매개변수가 없습니다.

성공 응답이 수신되면 HTTP 200 상태 코드와 고객의 이전 가능한 구독(이전 만료일 포함) 토큰 및 이전 주문에 필요한 최소 사용자 수 고객 이전할 수 없는 추가 정기 결제를 보유할 수 있습니다.

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "432",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1331647980142",
      "plan": {
        "planName": "ANNUAL",
        "isCommitmentPlan": true,
        "commitmentInterval": {
          "startTime": "1331647980142",
          "endTime": "1363183980142"
        }
      },
      "seats": {
        "kind": "subscriptions#seats",
        "numberOfSeats": 10,
        "maximumNumberOfSeats": 500,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183980142",
        "minimumTransferableSeats": "20"
      },
      "purchaseOrderId": "PO_890",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-6543",
      "subscriptionId": "140",
      "skuId": "1010020028",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
      },
      "transferInfo": {
        "transferabilityExpirationTime": "1333183780159",
        "minimumTransferableSeats": "10"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

일괄 처리를 사용하여 이러한 구독을 이전할 계획이라면 모든 구독을 전송합니다. 각 구독 이전 하나씩 실행하면 오류가 발생합니다. 또한 일괄 작업은 ACTIVE 상태인 정기 결제를 표시합니다. 자세한 내용은 구독 이전하기

모든 리셀러 구독 가져오기

성공적으로 주문 또는 이전된 리셀러의 모든 다음 GET HTTP 요청을 사용하고 승인 토큰을 포함합니다. 

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=PREFIX &pageToken=TOKEN&maxResults=MAX_NUMBER

다음을 바꿉니다.

  • PREFIX: 찾을 수 있습니다.
  • TOKEN: 다음의 특정 페이지를 식별하는 토큰 반환합니다.
  • MAX_NUMBER: 반환된 결과의 최대 개수 응답 페이지에 표시됩니다.

이 작업은 OAuth 읽기 전용 액세스 범위를 사용할 수 있습니다. 이 customerNamePrefix, pageToken, maxResults는 선택적 쿼리 문자열입니다.

다음 예시는 이름이 'exam'으로 시작하는 고객:

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions?customerNamePrefix=exam

{
  "kind": "reseller#subscriptions",
  "subscriptions": [
    {
      "kind": "subscriptions#subscription",
      "customerId": "C0123456",
      "subscriptionId": "123",
      "skuId": "1010020028",
      "creationTime": "1331647980142",
      "billingMethod": "ONLINE",
      "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": "PO_135",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
    {
      "kind": "subscriptions#subscription",
      "customerId": "custId-5678",
      "subscriptionId": "1404686",
      "skuId": "1010020028",
      "billingMethod": "ONLINE",
      "creationTime": "1329389322728",
      "plan": {
        "planName": "FLEXIBLE",
        "isCommitmentPlan": false
      },
      "seats": {
        "kind": "subscriptions#seats",
        "maximumNumberOfSeats": 50,
        "licensedNumberOfSeats": 10
      },
      "trialSettings": {
        "isInTrial": false,
        "trialEndTime": "1331877480016"
      },
      "renewalSettings": {
        "kind": "subscriptions#renewalSettings",
        "renewalType": "AUTO_RENEW"
      },
      "purchaseOrderId": "",
      "status": "ACTIVE",
      "resourceUiUrl": "URL to customer's Subscriptions page in the Admin console",
      "skuName": "Google Workspace Business Standard"
    },
  ],
  "nextPageToken": "token"
}

구독 요금제 업데이트

Google Workspace 요금제 업데이트는 요금제에 따라 다릅니다. 업데이트하기 전에 다음 사항을 고려하세요.

  • 구독을 만들었고 고객이 자격을 갖춘 경우 30일 무료 체험일 수 있습니다. 탄력 요금제와 연간 요금제 모두 약정 요금제는 30일 무료 체험판일 수 있습니다. 평가판을 사용하는 동안 구독 요금제를 탄력 요금제 또는 연간 요금제로 변경할 수 있습니다. 약정 계획을 수립할 수 있습니다 하지만 무료 체험이 끝나고 요금제가 종료된 후 활성화되면 계획 업데이트 시 다른 구독' 실행 중인 계획 무료 체험 구독을 활성 요금제 30일 무료 체험 구독을 통해 유료 서비스 시작하기 30일 무료 체험 정보와 고객 검증 규칙에 대한 자세한 내용은 관리 고객센터를 방문하세요.

  • 탄력 요금제를 연간 약정 요금제로 업데이트할 수 있습니다.

  • 연간 약정 요금제는 업데이트할 수 없습니다.

  • 요금제에 따라 지원되지 않는 제품도 있습니다. 어떤 유형의 광고가 게재되는지 사용하는 방법에 대한 자세한 내용은 제품 및 SKU를 참조하시기 바랍니다.

30일 무료 체험 또는 탄력 요금제 구독을 연간 구독으로 업데이트하려면 다음 단계를 따르세요. 약정 요금제를 사용하려면 다음 POST HTTP 요청을 사용합니다.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changePlan

다음을 바꿉니다.

다음 예는 다음과 같이 subscriptionId로 구독을 업데이트합니다. 123으로 설정합니다 customerId는 C0123456입니다.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changePlan

요청 본문에는 다음이 포함됩니다.

{
  "kind": "reseller#changePlanRequest",
  "planName": "ANNUAL_MONTHLY_PAY",
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 10
  },
  "purchaseOrderId": "123_March2012"
}

성공 응답은 HTTP 201 상태 코드를 반환하고 업데이트된 구독 요금제 설정:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "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": "123_March2012",
  "status": "ACTIVE",
  "skuName": "Google Workspace Business Standard"
}

구독의 사용 가능 라이선스 수 업데이트하기

연간 약정 요금제 구독을 업데이트할 때는 다른 구독이 사용됩니다. Google Workspace 탄력 요금제의 구독을 업데이트하는 것보다 더 효과적입니다.

연간 요금제 구독의 사용 가능 라이선스 수 업데이트하기

연간 요금제 구독의 사용자 라이선스 설정을 업데이트하려면 다음을 사용하세요. POST HTTP 요청:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeSeats

다음을 바꿉니다.

다음 예는 123 subscriptionId로 구독을 업데이트합니다. 이 customerId는 C0123456입니다. 요청 본문은 요금제 유형:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/changeSeats

Google Workspace 연간 약정 요금제의 구독은 이 요청 본문을 사용하여 다음을 수행합니다. 사용자 라이선스 수를 업데이트합니다. numberOfSeats 값은 합계입니다. 예를 들어 이전에 10개의 사용자 라이선스가 있었고 5개의 새 라이선스에 대한 다음 예와 같이 numberOfSeats는 15입니다.

{
    "kind": "subscriptions#seats",
    "numberOfSeats": 15
}

탄력 요금제 구독의 사용 가능 라이선스 수 업데이트

Google Workspace 탄력 요금제의 구독은 요청 본문을 사용하여 업데이트합니다. 라이선스가 필요합니다. maximumNumberOfSeats 값은 새 라이선스를 만듭니다. 최대 사용자 수입니다. 라이선스가 있어야 합니다

{
  "kind": "subscriptions#seats",
  "maximumNumberOfSeats": 15
}

성공하면 HTTP 201 상태 코드가 반환되고 업데이트된 구독 라이선스 설정:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "FLEXIBLE",
    "isCommitmentPlan": false
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 15,
    "licensedNumberOfSeats": 10
  },
  "trialSettings": {
    "isInTrial": false
  },
  "skuName": "Google Workspace Business Standard"
}

정기 결제 갱신 설정 업데이트하기

연간 약정 구독의 갱신 설정을 업데이트하려면 다음을 사용하세요. 다음 POST HTTP 요청:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/changeRenewalSettings

다음을 바꿉니다.

다음은 요청 본문의 예입니다.

{
  "kind": "subscriptions#renewalSettings",
  "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}

renewalType 속성의 값은 다음 중 하나일 수 있습니다.

  • AUTO_RENEW_YEARLY_PAY: 연간 약정 요금제의 간격이 끝나면 다음 결제 수단으로 정기 결제 요금제를 ANNUAL_YEARLY_PAY(으)로 자동 갱신 같은 numberOfSeats입니다.
  • AUTO_RENEW_MONTHLY_PAY: 연간 약정 요금제 종료 시 구독 요금제를 자동으로 갱신할 때 동일한 numberOfSeats를 갖는 ANNUAL_MONTHLY_PAY
  • RENEW_CURRENT_USERS_YEARLY_PAY: 연간 약정 요금제 종료 시 구독 요금제를 ANNUAL_YEARLY_PAY(으)로 갱신하되 현재 활성 사용자 라이선스의 총 개수 이는 기본값입니다. 활성 연간 약정 요금제 (연간 결제) 설정
  • RENEW_CURRENT_USERS_MONTHLY_PAY: 연간 약정 요금제 종료 시 구독 요금제를 ANNUAL_MONTHLY_PAY(으)로 갱신하되 현재 활성 사용자 라이선스의 총 개수 이는 기본값입니다. 활성 연간 요금제 (월별 지불)의 설정입니다.
  • RENEW_ON_PROPOSED_OFFER: 현재 약정 요금제 종료 시 간격, numberOfSeats를 숫자로 하여 최근 갱신 제안에서 갱신 현재 활성 사용자 라이선스 또는 제안된 혜택 약정 중 더 높습니다.
  • SWITCH_TO_PAY_AS_YOU_GO: 연간 약정 요금제 종료 시 연간 약정 요금제를 탄력 요금제로 변경하세요.
  • CANCEL: 연간 약정 요금제 기간이 끝나면 구독이 이(가) 정지되었습니다. 정지를 해제하는 방법을 알아보려면 다음을 참조하세요. 관리 고객센터를 방문하세요.
를 통해 개인정보처리방침을 정의할 수 있습니다. )

성공하면 HTTP 201 상태 코드가 반환되고 업데이트된 구독 갱신 설정:

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

무료 체험 구독에서 유료 서비스 시작하기

30일 무료 체험 구독을 유료 서비스로 즉시 이전하는 방법 무료 체험에 요금제가 이미 설정되어 있는 경우 다음 POST HTTP 요청을 사용하세요. 

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID/startPaidService

다음을 바꿉니다.

다음 예에는 customerId로 C0123456이 있고 subscriptionId 값 123:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions/123/startPaidService

이 작업은 요청 본문에 매개변수가 없습니다.

성공하면 HTTP 201 상태 코드와 업데이트된 구독 설정이 반환됩니다.

{
  "kind": "reseller#subscription",
  "customerId": "C0123456",
  "subscriptionId": "123",
  "skuId": "1010020028",
  "creationTime": "1331647980142",
  "plan": {
    "planName": "ANNUAL",
    "isCommitmentPlan": true,
    "commitmentInterval": {
      "startTime": "1331647980142",
      "endTime": "1363183980142"
    }
  },
  "seats": {
    "kind": "subscriptions#seats",
    "numberOfSeats": 15,
    "licensedNumberOfSeats": 15
  },
  "trialSettings": {
    "isInTrial": false
  },
  "renewalSettings": {
    "kind": "subscriptions#renewalSettings",
    "renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
  },
  "skuName": "Google Workspace Business Standard"
}

구독 업그레이드 또는 다운그레이드

계약 기간 중에는 연간 요금제를 다운그레이드할 수 없으며 다운그레이드를 예약할 수 없습니다. Google Cloud Storage에서 갱신 설정을 선택하여 FLEXIBLE(으)로 전환한 다음 갱신 시간이 지나면 다운그레이드됩니다.

구독을 업그레이드하거나 다운그레이드하려면 새 구독을 만드세요. 업그레이드 또는 다운그레이드하려는 skuId로 바꿉니다.

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

다음을 바꿉니다.

  • CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.

이 호출은 이전 구독을 종료하고 새 구독을 만듭니다.

다음에 대해 자세히 알아보기 업그레이드와 다운그레이드를 제품 및 SKU 페이지를 참조하세요.