정기 결제를 검색한 후에는 성공적인 응답의 정보를 사용하여 정기 결제 상태를 변경하거나 정기 결제를 업데이트할 수 있습니다. 이 페이지에서는 정기 결제를 검색하고 업데이트할 수 있는 다양한 방법을 중점적으로 설명합니다.
정기 결제 검색
주문 또는 이전된 구독을 성공적으로 검색하려면 다음 GETHTTP 요청을 사용하세요.
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions/SUBSCRIPTION_ID
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.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는 리셀러가 제공하는 이전 토큰입니다. 고객이 생성한 후 14일 동안 유효합니다. 고객이 토큰을 생성하는 방법에 대한 자세한 내용은 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 전용입니다. 고객이 생성한 후에는 14일 동안 유효합니다. 고객이 토큰을 생성하는 방법에 대한 자세한 내용은 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
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SUBSCRIPTION_ID: 각 고객에 대해 고유한 정기 결제 식별자입니다. 모든 리셀러 구독 가져오기 방법을 사용하여 이 값을 검색할 수 있습니다.
다음 예는 값이 123인 subscriptionId로 정기 결제를 업데이트합니다. 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
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SUBSCRIPTION_ID: 각 고객에 대해 고유한 정기 결제 식별자입니다. 모든 리셀러 구독 가져오기 방법을 사용하여 이 값을 검색할 수 있습니다.
다음 예는 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
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SUBSCRIPTION_ID: 각 고객에 대해 고유한 정기 결제 식별자입니다. 모든 리셀러 구독 가져오기 방법을 사용하여 이 값을 검색할 수 있습니다.
다음은 요청 본문의 예입니다.
{
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
}
renewalType 속성의 값은 다음 중 하나일 수 있습니다.
AUTO_RENEW_YEARLY_PAY: 연간 약정 주기가 끝날 때numberOfSeats의 동일한 정기 결제 요금제를ANNUAL_YEARLY_PAY으로 자동 갱신합니다.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: 현재 약정 요금제 간격이 끝날 때 최근 갱신 제안에 대해 현재 활성 사용자 라이선스 수 또는 제안된 혜택 약정 수 중 높은 값으로 numberOfSides를 갱신합니다.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
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.SUBSCRIPTION_ID: 각 고객에 대해 고유한 정기 결제 식별자입니다. 모든 리셀러 구독 가져오기 방법을 사용하여 이 값을 검색할 수 있습니다.
다음 예에서는 C0123456을 customerId로, 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"
}
구독 업그레이드 또는 다운그레이드
계약 기간 중에는 연간 요금제를 다운그레이드할 수 없으며 갱신 설정을 사용하여 다운그레이드를 예약할 수 없습니다. 갱신 설정을 FLEXIBLE로 전환하고 갱신 시간 이후 다운그레이드하는 것이 좋습니다.
정기 결제를 업그레이드하거나 다운그레이드하려면 업그레이드 또는 다운그레이드하려는 skuId로 새 정기 결제를 만듭니다.
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
다음을 바꿉니다.
CUSTOMER_ID: 고객의 기본 도메인 이름 또는 고객의 고유 식별자입니다.
이 호출은 이전 구독을 종료하고 새 구독을 만듭니다.
제품 및 SKU 페이지에서 업그레이드 및 다운그레이드에 관해 자세히 알아보세요.