정기 결제를 검색한 후 성공 응답의 정보를 사용하여 정기 결제 상태를 변경하거나 정기 결제를 업데이트할 수 있습니다. 이 페이지에서는 정기 결제를 검색하고 업데이트할 수 있는 다양한 방법을 중점적으로 설명합니다.
구독 가져오기
성공적으로 주문되거나 전송된 구독을 검색하려면 다음 GET HTTP 요청을 사용합니다.
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는 리셀러 ID 전용으로 고객이 제공한 이전 토큰입니다. 고객이 생성한 후 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
다음을 바꿉니다.
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: 현재 약정 요금제의 기간이 끝나면 최신 갱신 제안서에 따라 numberOfSeats를 현재 활성 사용자 라이선스 수 또는 제안된 혜택 약정 중 더 큰 수로 갱신합니다.SWITCH_TO_PAY_AS_YOU_GO: 연간 약정 요금제 기간이 끝나면 연간 약정 요금제를 탄력 요금제로 변경합니다.CANCEL: 연간 약정 요금제 기간이 끝나면 구독이 정지됩니다. 정지를 해제하는 방법을 알아보려면 관리 고객센터를 참조하세요.
RENEW_CURRENT_USERS
성공적인 응답은 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: 각 고객마다 고유한 정기 결제 식별자입니다. 모든 리셀러 구독 검색 메서드를 사용하여 이 값을 검색할 수 있습니다.
다음 예에는 customerId가 C0123456이고 값이 123인 subscriptionId가 있습니다.
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 페이지에서 업그레이드 및 다운그레이드에 관해 자세히 알아보세요.