Google Workspace 및 Chrome 사용 권한 관리

이 페이지에서는 Google Workspace 및 Chrome 제품의 고객 사용 권한을 관리하는 방법을 설명합니다.

기본 요건

계속하기 전에 리셀러 계정의 Google Workspace 결제 계정이 하나인지 아니면 Google Workspace 결제 계정이 여러 개 있는지 확인합니다. 이 주제에 대한 자세한 내용은 복수의 Google Workspace 결제 계정 시작 가이드를 참조하세요.

사용 권한 만들기

시작하기 전에

계속하려면 Customer을(를) 설정해야 합니다.

사용 권한을 만들려면 다음 단계를 따르세요.

고객 이름으로 listPurchasableSkus을(를) 호출하여 PurchasableSkus 목록을 검색합니다.

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "product": "products/-"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

선택한 PurchasableSku에서 queryEligibleBillingAccounts 메서드를 사용하여 사용 권한을 지불하는 데 사용할 수 있는 Google Workspace BillingAccount 집합을 찾습니다.

특정 통화로 결제하려면 해당 통화가 지정된 BillingAccount를 선택합니다.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/sku_id1"]
}
QueryEligibleBillingAccountsResponse
{
  "skuPurchaseGroups": [
    {
      "skus": [
        "products/product_id/skus/sku_id1"
      ],
      "billingAccountPurchaseInfos": [
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id1",
            "displayName": "Google_Workspace_USD_US_1",
            "currencyCode": "USD",
            "regionCode": "US"
          }
        },
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id2",
            "displayName": "Google_Workspace_CAD_CA_1",
            "currencyCode": "CAD",
            "regionCode": "CA"
          }
        }
      ]
    }
  ]
}

선택한 PurchasableSku 및 BillingAccount에서 listPurchasableOffers 메서드를 사용하여 사용 가능한 PurchasableOffer을(를) 찾습니다.

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "sku": "products/product_id/skus/sku_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

이제 Entitlement 및 PurchasableOffer에 대한 비용을 지불할 BillingAccount가 있습니다. create 메서드를 사용하여 사용 권한 만들기를 시작합니다.

사용 권한을 만들고 재판매 견적서(오퍼), BillingAccount, 그 외 필수 매개변수를 채웁니다.

CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}

Google Workspace 사용 권한의 요금제 변경하기

시작하기 전에

무료 또는 체험판 plan이(가) 적용된 Google Workspace 사용 권한은 Google Workspace 결제 계정이 없습니다. 사용 권한의 요금제를 유료 요금제로 변경하려면 몇 가지 추가 단계를 거쳐 Google Workspace 청구 계정을 선택해야 합니다.

Google Workspace 사용 권한에 대한 요금제를 변경하려면 다음 단계를 따르세요.

처음 두 단계는 기존 사용 권한에 무료 또는 체험판 요금제가 적용된 경우에만 필요합니다.

재판매 견적서(오퍼)에서 lookupOffer 메서드를 사용하여 재판매 견적서(오퍼)의 Sku 정보를 찾습니다.

LookupOfferRequest
{
  "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1"
}
LookupOffer respones
{
  "name": "accounts/123/offers/offer_id1",
  "sku": {
    "name": "products/product_id/skus/sku_id1",
   }
}

고객 및 SKU에서 queryEligibleBillingAccounts 메서드를 사용하여 이 사용 권한의 비용을 지불하는 데 사용할 수 있는 BillingAccount 집합을 찾습니다. 특정 통화로 결제하려면 해당 통화가 지정된 BillingAccount를 선택합니다.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

사용 권한 및 BillingAccount에서 listPurchasableOffers 메서드를 사용하여 PurchasableOffer를 찾습니다. 기존 사용 권한에서 이미 유료 요금제를 사용하는 경우 BillingAccount가 필요하지 않으며, 기존 BillingAccount가 사용됩니다. 요금제를 변경하려면 purchase_option 필드가 changeOfferPurchase여야 합니다.

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

이제 사용 권한, 재판매 견적서(오퍼), BillingAccount가 있습니다. changeOffer 메서드를 사용하여 요금제를 변경합니다.

ChangeOfferRequest
{
  "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
  "offer": "accounts/abc/offers/offer_id1",
  "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
  "parameters": [{
    "name": "max_units",
    "value": {
      "int64Value": "100"
    }
  }]
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}

Google Workspace 사용 권한 업그레이드 또는 다운그레이드

Google Workspace 사용 권한을 업그레이드하거나 다운그레이드하려면 다음 단계를 따르세요.

사용 권한에서 listPurchasableSkus 메서드를 호출하여 업그레이드 또는 다운그레이드할 수 있는 PurchasableSkus 목록을 검색합니다.

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "changeType": "UPGRADE"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

PurchasableSku에서 queryEligibleBillingAccounts 메서드를 사용하여 사용 권한 비용을 지불하는 데 사용할 수 있는 BillingAccount 집합을 찾습니다.

특정 통화로 결제하려면 해당 통화가 지정된 BillingAccount를 선택합니다.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

사용 권한 및 BillingAccount에서 listPurchasableOffers 메서드를 사용하여 PurchasableOffer를 찾습니다.

  ListPurchasableOffersRequest
  {
    "customer": "accounts/123/customers/abc",
    "changeOfferPurchase": {
      "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
      "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
    }
  }
  ListPurchasableOffersResponse
  {
    "purchasableOffers": [
      {
        "offer": {
          "name": "accounts/123/offers/offer_id1",
        },
        "sku": {
          "name": "products/product_id/skus/sku_id1",
        },
        "plan": {
          "paymentPlan": "FLEXIBLE",
          "paymentCycle": {
            "duration": 1,
            "periodType": "MONTH"
          }
        },
      }
    ],
  }
  ```

이제 사용 권한, PurchasableOffer, BillingAccount가 있습니다. changeOffer 메서드를 사용하여 업그레이드 또는 다운그레이드를 시작합니다.

사용 권한 객체를 만들고 이름, 재판매 견적서(오퍼), billingAccount, 모든 필수 매개변수를 채웁니다.

   ChangeOfferRequest
   {
     "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
     "offer": "accounts/abc/offers/offer_id1",
     "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
     "parameters": [{
       "name": "max_units",
       "value": {
         "int64Value": "100"
       }
     }]
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```

사용 권한 이전

이 섹션에서는 이전 파트너를 통한 기존 Google Workspace 및 Chrome 고객의 사용 권한을 이전하는 방법을 알려줍니다.

Partner Sales Console에서 고객을 이전하는 방법에 관한 도움말은 파트너 계정 또는 Google 계정으로 고객을 이전하는 방법에 관한 가이드를 참고하세요.

Google Workspace 고객은 단일 파트너 또는 단일 파트너와 Google에서만 사용 권한을 구매할 수 있습니다.

이전하는 동안 기존 사용 권한이 자동으로 취소되고 새 파트너 아래에 다시 사용 권한이 만들어집니다. 고객이 약정 요금제 사용 권한이 있으면 이전 후에 새 약정 기간이 시작됩니다.

시작하기 전에

고객의 사용 권한을 관리하려면 고객 생성 이전 토큰이 필요합니다. 고객에게 연락하여 이전 토큰을 생성할 수 있도록 파트너 공개 식별자를 제공합니다. 고객은 이전 토큰을 만든 후에 토큰을 리셀러에게 다시 전송하여 프로세스를 완료해야 합니다. 이러한 토큰은 생성 후 14일이 지나면 만료됩니다. 고객의 도메인 또는 Cloud ID도 필요합니다.

고객은 이전 토큰을 만들 때 새로운 리셀러에게 이전하려는 사용 권한을 선택합니다. 리셀러는 프로세스 중에 선택된 모든 사용 권한을 이전해야 합니다.

사용 권한을 이전하려면 다음 단계를 따르세요.

고객의 도메인만 있는 경우 Cloud Channel API를 사용하면 Cloud ID가 반환됩니다. 고객의 도메인으로 checkCloudIdentityAccountsExist을(를) 호출하고 도메인이 있으면 API에서 고객의 Cloud ID가 반환됩니다.

customers.import 메서드를 사용하여 고객 데이터를 가져와 이전을 시작합니다.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

고객의 Cloud ID에서 listTransferableSkus을(를) 호출하여 고객의 transferableSku 목록을 가져옵니다. 각 객체의 transferEligibility을(를) 확인하여 연결된 SKU를 구매할 수 있는지 확인합니다.

ListTransferableSkusRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id"
}
ListTransferableSkusResponse
{
  "transferableSku": [
    {
      "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_sku_id2",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_chrome_sku_id3",
      },
    }
  ],
}

이제 TransferableSkus 목록이 있으므로 사용 권한 비용을 지불할 때 사용할 BillingAccount를 결정해야 합니다. queryEligibleBillingAccounts 메서드를 사용하여 각 TransferableSku에 사용할 수 있는 BillingAccount 집합을 찾습니다.

특정 TransferableSkus는 동일한 Google Workspace 결제 계정을 공유해야 하므로, queryEligibleBillingAccounts은(는) 동일한 BillingAccount를 사용해야 하는 TransferableSkus를 알려주는 SKU 그룹을 반환합니다. 특정 SKU 그룹에 복수의 Google Workspace 결제 계정이 설정되어 있는 경우 Google Workspace 결제 계정 중 하나를 선택하여 그룹의 모든 TransferableSku에 사용할 수 있습니다.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"]
}
QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/voice_sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/voice_billing_account_id1",
             "displayName": "Google_Workspace_Voice_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         }
       ]
     },
     {
       "skus": [
         "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

각 TransferableSku 및 BillingAccount 쌍에 대해 listTransferableOffers 메서드를 사용하여 사용 가능한 TransferableOffers을(를) 찾습니다. 이제 TransferableSku, BillingAccounts, TransferableOffer로 구성된 고객의 튜플 목록이 있습니다.

ListTransferableOffersRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id",
  "sku": "products/product_id/skus/voice_sku_id1",
  "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1"
}
ListTransferableOffersResponse
   {
     "transferableOffers": [
       {
         "offer": {
           "name": "accounts/123/offers/voice_offer_id1",
         },
         "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
         },
         "plan": {
           "paymentPlan": "FLEXIBLE",
           "paymentCycle": {
             "duration": 1,
             "periodType": "MONTH"
           }
         },
       }
     ],
   }

각 튜플에 대해 새로 해당하는 사용 권한 객체가 생성되고, 각 사용 권한에는 재판매 견적서(오퍼), BillingAccount, 필수 매개변수가 필요합니다. transferEntitlements 메서드를 호출하여 이전합니다.

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    { 
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1"
    },
    {
      "offer": "accounts/123/offers/gw_offer_id2",
      "maxUnits": 150,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
    {
      "offer": "accounts/123/offers/gw_chrome_offer_id3",
      "maxUnits": 200,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }   
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}